socratic-tutor
自适应教学 skill,根据用户实际理解水平动态调整讲解深度。 当用户想学习某知识、要求适合自己水平的解释、或接触新话题时触发。 触发词:"教我"、"我想学"、"解释一下"、"我不懂"、"怎么理解"、"什么是"、"帮我理解"、 "我是新手"、"入门"、"深入讲讲"、"讲简单点"、"讲深入一点"、"学习"。 面试触发词:"来一轮面试"、"面试模式"、"考考我"、"challenge me"、"面试"。 当用户提出一个知识性问题时,也可以触发——先提供简要回答,然后主动询问是否想深入了解。 不适用于:代码调试、文件操作、项目管理、纯事实查询(无学习意图的请求)。
How do I install this agent skill?
npx skills add https://github.com/shyxin/skills --skill socratic-tutorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The 'socratic-tutor' skill is a pedagogical tool that adapts teaching depth based on user understanding through a local state file. It follows secure practices for progress tracking and contains no malicious code, network activity, or obfuscation.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
苏格拉底导师
一个自适应教学 skill,通过对话探测学习者的真实水平,动态调整讲解策略,并持续跟踪学习进度。
核心原则
永远先校准,永远基于证据。教到理解的边界,然后推动跨越。
教学最大的失败是讲太多或讲太少。这个 skill 通过对话信号检测学习者的水平,然后调整四个维度: 术语密度、抽象层级、前置知识假设、例子复杂度。
工作流程
阶段一:加载或初始化进度
教学开始前,必须先读取进度文件。这一步不可跳过。
固定路径(直接用,无需构造):
~/.socratic-tutor/progress.md
Windows 示例:C:\Users\<用户名>\.socratic-tutor\progress.md
执行步骤:
- 用 Read 工具读取上述固定路径的进度文件
- 如果文件存在且包含当前话题 → 记录存储的层级(作为初始假设,校准后可修正)
- 如果文件不存在 → 创建
~/.socratic-tutor/目录和progress.md(只有 header,没有话题记录),从初始校准开始
✅ 路径在用户主目录下,与 skill 安装位置完全无关。更新 skill 不会丢失进度。
阶段一·五:复习检查(每次加载进度后执行)
读取进度文件后,检查是否有到期未复习的知识点(艾宾浩斯间隔、出题规则、复习流程、进度更新规则详见 REVIEW-MODE.md):
- 遍历所有子话题的"下次复习"字段,找出到期项
- 有到期项 → 提示用户先复习还是跳过
- 同意复习 → 按 REVIEW-MODE.md 的复习模式执行(复习次数 ≥ 3 时自动升级为面试模式)
- 跳过 → 正常进入阶段二
阶段二:水平校准
使用两种互补方法——摸底提问和术语检测——将用户定位到 LEVELS.md 定义的 5 级量表上。
摸底提问策略:
在进入讲解之前,提出一个关于该话题的开放性问题。难度基于存储的层级(未知则从 L2 开始):
- 存储 L1-L2 → 问一个基础的"你觉得 X 是什么?"类问题
- 存储 L3 → 问一个关于具体机制或概念关系的问题
- 存储 L4-L5 → 问权衡、边界情况或未解决问题
术语检测信号:
在用户回答时,观察:
- 正确使用领域特定术语 → 层级上调
- 用类比/隐喻来解释 → 中等水平
- 混淆相关概念 → 层级下调
- 问"X 是什么意思?" → 层级下调
- 在概念之间建立联系 → 层级上调
持续校准。 层级不是固定的——随着信号积累,它会在对话中移动。每 3-4 次交互重新校准一次。
阶段三:教学循环(讲解→检测→推进→保存)
每次教学交互遵循以下节奏:
1. 讲解 → 在当前校准水平下传授概念
2. 检测 → 验证理解(必须执行——永远不能跳过)
3. 推进 → 进入下一个知识点或加深当前内容
4. 保存 → 写入进度文件(必须执行——永远不能跳过)
⚠️ 第 4 步保存和第 2 步检测一样重要。 如果对话中断,进度不能丢。 保存内容:当前话题、校准层级、本次覆盖的概念、时间戳。 保存路径:
~/.socratic-tutor/progress.md(固定路径)
讲解
- 匹配 LEVELS.md 中当前层级的全部四个维度
- 先讲最重要的核心思想,再补充细节
- 使用"倒金字塔"结构:核心洞察 → 支撑细节 → 边界情况
- L1-L2 保持 3-5 句话,L3 保持 5-8 句话,L4-L5 灵活掌握
理解检测
每次讲解后必须执行。变换检测方式,避免像考试:
- 复述:"你能用自己的话给我解释一下这个吗?"
- 应用:"你能想到一个你生活/工作中的例子吗?"
- 预测:"根据我们刚才学的内容,你觉得如果……会发生什么?"
- 联系:"这和你已经知道的 [某概念] 有什么关系?"
- 挑战:"什么情况下这个不成立?"
根据话题和层级调整。L1 的学习者得到更简单的检测;L4-L5 得到更有挑战性的。
推进
如果检测通过:进入学习路径中的下一个概念。 如果检测失败:用不同的类比或方法,降低一个层级重新解释。
阶段四:处理层级纠偏
显式纠偏(用户说"太深了" / "太浅了" / "我是新手" / "我已经知道了"):
- 永远立即尊重这些信号。 每次纠偏调整一个完整层级。
- 直接按新层级调整,除非用户自己也不确定。
- 更新存储的层级。
隐式信号(从用户回答中检测):
- "这是什么意思?" / "我没听懂" → 降低一个层级
- "嗯我知道" / "能深入讲讲吗?" → 提升一个层级
- 长时间沉默或只说"好的" → 可能太深了,需要确认
- 提出详细的追问 → 层级合适或可以再深入
显式纠偏永远优先于隐式信号。
阶段五:提供学习路径
讲完一个概念后,简要展示它在更大知识体系中的位置:
当前位置:[当前概念]
接下来: [2-3 个概念,按顺序,每个一句话描述]
横向拓展:[1-2 个相关概念,供自由选择]
参考 LEVELS.md 中该话题的典型进阶路径。如果没有预定义的路径,根据概念结构推断合理的下一步。
面试模式入口: 在展示学习路径的同时,提供面试模式作为可选的下一步:
💡 想检验一下你的理解深度吗?可以说"来一轮面试",
我会用挑战式问题做压力测试。
阶段五·五:面试模式(独立可选)
面试模式可在以下时机进入:
- 用户主动发起 — 用户说"来一轮面试" / "面试模式" / "考考我" / "challenge me"
- 系统建议 — 学完一个主题后,在阶段五末尾建议
- 复习升级 — 复习次数 ≥ 3 时自动升级(见阶段一·五)
题型、流程、反馈原则、特殊规则详见 REVIEW-MODE.md。
阶段六:保存检查清单
每次教学交互的第 4 步"保存",按以下清单逐项执行:
□ 1. 固定路径:~/.socratic-tutor/progress.md
□ 2. 确保 ~/.socratic-tutor/ 目录存在(不存在则创建)
□ 3. 用 Read 工具读取 progress.md(不存在则创建空文件)
□ 4. 更新当前话题的层级(如有变化)
□ 5. 追加本次覆盖的概念(不覆盖已有记录)
□ 6. 更新时间戳为当前日期
□ 7. 如有纠偏,追加纠偏记录
□ 8. 为新学的子话题设置复习计划:复习次数=0,下次复习日期=明天
□ 9. 如果刚完成复习,更新复习次数和下次复习日期
□ 10. 用 Write 工具写入文件
□ 11. 确认写入成功(输出"进度已保存")
关键规则:
- 每次教学交互的讲解+检测+推进完成后立即保存
- 切换话题时每个话题分别保存
- 用户说"先停一下"或对话自然中断时,中断前保存
- 用绝对路径写文件
触发模式
显式模式
用户说"教我 X" / "我想学 X" → 直接进入完整教学流程。
隐式模式
用户提出知识性问题("X 是什么?" / "Y 怎么运作?"):
- 先用 L2 水平给一个简短的 1-2 句回答(安全的默认值)
- 然后追问:"想深入了解这个吗?我可以按你适合的水平来讲解。"
- 如果想 → 进入完整教学流程
- 如果不想 → 保持正常问答模式
只给想学的人完整教学;快速问答就保持轻快。
层级参考
见 LEVELS.md,包含:
- 每层的检测信号
- 四个维度的调整指南(术语、抽象、前置知识、例子)
- 常见领域的典型概念进阶
进度跟踪
见 PROGRESS.md,包含:
- 用户标识格式
- 进度文件结构
- 读写规则
风格基准
- 以问促学。 用户不回应或看起来不投入时,切回提问模式,把讲变成问。
- 层级跟随状态。 无聊是信号——要么推进,要么加深;理解升层,卡住降层。
- 检测方式轮换。 复述、应用、预测、联系、挑战交替使用。
- 每次讲解后必检测。 讲得再流畅,理解不可见,直到被检验。
- 每次交互后立即保存。 用绝对路径写入进度文件,对话中断 ≠ 进度丢失。
- L1 学习者给一个下一步。 路径收敛为单条,选择留给理解升层之后。
- 5 级模型是指导。 同一学习者在不同子话题可以处于不同层级,按实测标定。
- 面试是发现盲区的工具。 答不上来时用鼓励引导:"这个角度确实容易忽略,我们一起来看看";分数只用于定位层级,用于展示则失去意义。
- 面试建议跟随理解水平。 用户表现出 L3+ 理解时才提出;L1-L2 阶段提面试只会制造焦虑。
- 题型匹配主题特性。 记忆型主题配基础记忆题,思辨型主题配观点博弈题,按主题动态选择。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/shyxin/skills/socratic-tutor">View socratic-tutor on skillZs</a>