/tutor

name: tutor
description: 在当前知识库上教学：先诊断水平与目标，KB-grounded 讲解（页面带教材章节/页码/例题编号时锚定这些坐标讲解，例题引用也带坐标），穿插示例与 rule-sandbox 演示，出题练习复用现有判分，按作答反馈调整下一步讲解——错了换角度再讲并出变式题，对了进下一个概念，收尾经确认可整理成教程存进 教程/。领域无关，不绑定学科。与 wiki-query / quiz-generate / quiz-repractice 的分工：要一个答案或解释（单次弄懂）→ wiki-query；现场出题自测 → quiz-generate；重练存过的题 → quiz-repractice；要系统学会（讲+练+按错处调整的闭环）→ 本 skill。Triggers on: 教我, 教教我, 辅导, 我不懂, 没掌握, 从头学, 带我学, 系统学一遍, 学会, teach me, tutor.
version: 1.0.0

tutor: 知识库教学

在**当前知识库**上教学一个主题：诊断 → KB-grounded 讲解 → 示例 → 练习 → 按作答反馈调整的闭环。教学内容必须来自库——**禁止只凭训练记忆教学**。

触发

用户说「教我 / 教教我 / 辅导 / 我不懂 / 没掌握 / 从头学 / 带我学 / 系统学一遍 / 学会 / teach me / tutor」，或点名 `/tutor` 时使用。

与其他 skill 的四方分工（按用户意图路由，不按字面）：

• 要一个**答案或解释**（单次弄懂一个问题）→ `wiki-query`
• 要**现场出题**自测 → `quiz-generate`
• 要**原样重发**存过的题（不生成新题）→ `quiz-repractice`
• 要**学会**一个主题（讲解 + 练习 + 按错处调整的闭环）→ 本 skill

「给我讲讲 X」这类只想要解释的请求**不归本 skill**——那是单次问答，走 `wiki-query`；只有用户想系统学会、要练、要辅导时才用本 skill。

流程（必须按顺序）

1. 诊断

• 用户开场已说清水平与目标（「我是零基础」「准备期末考」）→ 直接开讲，不再追问
• 没说 → 用**一句**自然语言问完目标与水平（不拆成两轮）
• 说了但含糊、且主题有明显前置结构 → 可出 **1–2 道探底题**（quiz 围栏，同样只从库出；**以解答题为主**——解答题批改结果你自己看得见，才能作为诊断输入）
• 是否探底按主题形态自行判断；探底也是教学的一部分，不浪费

2. 讲解

按 `wiki-query` 的检索路径定位材料：

1. 读 `wiki/hot.md`（存在时） 2. 读根 `wiki/INDEX.md` 3. 按需读相关目录的 `INDEX.md` 4. 读 2–5 个最相关的 wiki 页面 5. wiki 不足时回溯源文件（`raw/`、`notes/`、`docs/` 等）

• **禁止只凭训练记忆讲解**。库里覆盖不足就明说「这个主题库里覆盖不足」，只讲能落在库内材料上的部分，少讲或不出示例
• **教材锚定**：页面或源文件载有教材坐标（章节名、页码区间、例题编号）时，讲解与例题引用**显式带坐标**（如「这段对应教材 §2.3、第 78–82 页，先看例题 3」）；**没有坐标就照常讲，不编造页码**
• 讲解深度按诊断结果与用户显式指令调整；先看材料的知识形态再决定讲解组织（概念→定义辨析、流程→步骤拆解、规则→适用边界），不套固定学科模板
• 用户点名跨库材料时，同 `quiz-generate` §2 的跨库语义（只取被点名的挂载库，出处带 `external/<标签>/` 前缀）

3. 示例

• 示例穿插在讲解中，紧随对应概念，不集中堆在结尾
• 边界/参数类内容可顺手生成 rule-sandbox 演示（围栏协议见 `rule-sandbox` skill，不在此重写）
• 示例必须能落到库内材料；落不到就不硬造

4. 练习

按讲解跨度出 **2–4 道**题（quiz 围栏），直接复用 quiz 协议与判分：

• **构成以解答题为主**——解答题的批改结果直接进对话，是反馈调整的燃料；客观题（单选/判断/填空）作轻量自测，**对错结果你看不到，不作为调整依据**
• 题目质量纪律同 `quiz-generate` §4/§5：题干自包含不依赖上一题；数学与符号用纯文本记法（√ x² π），不输出 LaTeX 源码；`sources` 路径真实存在；围栏外不出现答案、解析或题目清单；JSON 合法（双引号、无注释、无尾逗号、字符串内换行写 `\n`）
• 只考刚讲过且库内有据的内容；范围默认当前库，点名才跨（同 `quiz-generate` §2）
• **发出练习后必须邀请用户报告结果**（如「答完告诉我哪几道错了，我按错处调整」）——客观题判分在答题界面、不进对话，你不邀请，用户答完你就瞎等，闭环直接卡死

5. 反馈调整（本 skill 的核心）

反馈源只有两个：**解答题批改**（你自己批的，结果直接可用）+ **用户自述**（「第 2 题错了」「都对」）。除此之外你没有其他渠道知道客观题对错。

• **错了** → 换角度再讲该点：换类比、换拆解顺序、补前置概念——**不复读原讲解** → 然后出 **1 道变式题**（quiz 围栏，考同一个点、换一个表面）。**反馈回合必须以变式题围栏收尾——沙盘建议（sandbox-suggest）不能替代变式题**；沙盘想给就在变式题之后另给
• **对了** → 进下一个概念
• 讲完错因后顺手提一句「这道可以存为题库，之后可重练」（出口是界面上已有的「存为题库」，不展开新流程）
• 用户没报结果、也没答解答题时，不要凭空宣称「你答对了」，也不要臆测对错继续推进

收尾：教程沉淀

• 用户说「懂了」「会了」「今天到这」这类完成信号 → 问一次「要不要把这次讲解整理成教程存进库里？」
• **每次教学会话最多问一次**；用户拒绝后不再追问；中途问不相干的问题不算收尾信号
• **确认后才**动笔：把整场教学合并成一篇教程（主题脉络 + 关键讲解 + 易错点 + 变式题），写入 `教程/<日期>-<主题>.md`（日期在前，与 `题库/` 约定一致），frontmatter 从简（`title` / `created` / `sources`，sources 链到参考的 wiki 页面）
• 未确认 → 一个字都不写。教程合并要基于本场讲解与库内材料，不引入训练记忆里的内容

解答题批改

（本节与 `quiz-generate` / `quiz-repractice` 的「批改协议」逐字同步维护——改任一处必须同步三处，题卡回填依赖格式完全一致。守卫测试：`grading-protocol-sync.test.ts`。）

收到含 `【大题作答·第N题】` 标记行的消息时按以下协议批改——这是确定性触发，不靠模型自觉判断：

1. 逐评分点判定：命中 / 部分命中 / 未中，并指出作答里对应的依据 2. 出错的步骤要说明错在哪、正确的思路是什么 3. 给分：X/Y（Y = 评分点总数；X = 命中数 × 1 + 部分命中数 × 0.5，未中记 0 分，因此 X 可以带 .5） 4. 讲错因时能引出处就引出处（消息里列出的文档路径） 5. 作答含糊、多种理解都说得通时明说拿不准，不要硬判

消息末尾的「题目指纹：……」行是系统关联信息，批改时忽略。批改标准就是消息里列出的评分点，不要自己另立标准或加码。

**批改回复格式**（答题界面按它把结果回填进题卡，必须遵守）：

【批改·第N题】得分 X/Y
1. 命中｜<一句话依据>
2. 部分｜<一句话依据，指出缺了什么>
3. 未中｜<一句话依据>

• 题号 N 镜像作答标记里的题号
• 判定枚举冻结三词：命中 / 部分 / 未中（判断时的「部分命中」在逐点行里写「部分」）
• **X 必须等于逐点行的加权总和**——答题界面把 X/Y 画成得分徽标、把逐点行画成明细，两者对不上会被读成批改出错
• 依据一句话、自足成句，任何学科一视同仁
• 标记行与逐点行之后，照常按上面第 2–5 条写错因与讲解

自检

输出前检查：

• [ ] 讲解前检索过（hot.md → INDEX → 页面 → 源文件），没有凭训练记忆开讲
• [ ] 覆盖不足时明说了，没有硬讲
• [ ] 教材坐标只引用页面里真实存在的，没有编造页码
• [ ] 探底题与练习题也来自库，围栏外无答案、解析或题目清单
• [ ] 练习发出时邀请了用户报告结果
• [ ] 反馈调整给了变式题（错）或进了下一概念（对），没有复读原讲解
• [ ] 反馈回合以变式题围栏收尾，没有被沙盘建议替代
• [ ] 教程未确认不落盘；落盘时文件名日期在前
• [ ] JSON 能被 `JSON.parse` 解析