/student-tutor

name: student-tutor
description: 给学生用其所在年级听得懂的语言通俗讲解题目，并生成举一反三练习。当用户给出年级 + 题目（文字或图片）希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件：讲解文件与配套练习文件。

学生通俗讲解辅导

目的

把一道题，用**指定年级的学生真正听得懂**的语言讲清楚；多解法时按"启发思维"优先级排序讲解；再出几道同类题，把答案和详细过程写进单独的练习文件。

工作流程

1. **确认输入** → 必须拿到：①年级 ②题目。题目可能是文字，也可能是图片。 2. **读题** → 若题目是图片，用 `mcp__MiniMax__understand_image` 提取题目文字与图中信息（数字、图形、表格、坐标等），并在心里复述确认题意。 3. **定年级语言基线** → 阅读 `references/grade_levels.md`，按年级锁定可用词汇、可用知识点、禁用超纲方法。 4. **解题与讲解** → 先自己算出正确答案（必要时多种解法都算一遍），再按下方"讲解结构"组织内容。 5. **出举一反三题** → 3~5 道同类/变式题，难度由易到难，覆盖同一知识点的不同侧面。 6. **写两个文件** → 讲解文件 + 练习文件（含答案与详细过程），写入 `markdown/`。 7. **关键处配图** → 仅在"讲清楚某一步的关键"时用一张 mermaid 或 svg 图，不滥用。 8. **自检** → 对照"质量自检清单"逐项核对后再交付。

第一步：确认输入

如果用户**没给年级**，必须先问，不要猜——同一道题给三年级和初二讲法完全不同。 如果**只有图片没有文字说明**，先用 `mcp__MiniMax__understand_image` 读图，再向用户复述一句"我看到的题目是……，对吗？"式确认（除非题意非常清晰可直接开讲）。

读图调用示例：

mcp__MiniMax__understand_image(
  prompt="提取这张图里的完整题目：包括所有文字、数字、图形结构、表格数据、已知条件和要求。如果是几何图请描述各点、边、角的关系。",
  image_source="/abs/path/to/题目.png"   # 去掉用户路径里可能的 @ 前缀
)

讲解结构（讲解文件内容）

按以下顺序组织，用词必须落在该年级基线内（见 `references/grade_levels.md`）：

1. **题目** — 原样抄录题目（图片题则写出读取到的题目）。 2. **先读懂题在问什么** — 用大白话翻译题目，点出"已知什么、求什么"。低年级可用生活化比喻。 3. **解法（按启发思维优先级排序）** — 关键要求：

• 若有多种解法，**最能启发思维、最贴近学生已有直觉的解法放第一个**（如画图法、列举法、找规律），技巧性强/套公式的解法放后面。
• 每种解法标注 `### 解法一：xxx（推荐先理解这种）`，并一句话说明"这种方法好在哪、为什么先讲它"。
• 每一步都要讲**为什么这么做**，而不只是"怎么算"。关键步骤给出算式。

4. **答案** — 用醒目方式给出最终答案。 5. **最容易犯的错误（必须详细讲解，不能只列点）** — 这是讲解文件的重点部分之一，见下方"易错点详解"。 6. **这道题考的知识点** — 一句话点明，连接到练习文件。

排序原则：直观/可视化/可动手的方法 > 通用方法 > 技巧/公式型方法。让学生先"懂道理"，再"会套路"。

易错点详解（重点要求）

"容易错在哪"不能只写一句"别忘了通分"就完事。学生看不懂自己**为什么会错**，下次还会犯同样的错。

先**预判该年级学生在这道题上最可能犯的 1~3 个错**（结合年级基线想：他们会混淆什么、会想当然地套用什么、会漏掉哪一步）。挑出其中**最容易犯、最典型的那一个，写成完整一段详细讲解**，其余的可较简略。

每个易错点（尤其是最典型那个）按这四步写清楚，缺一不可：

1. **错法长什么样** — 直接写出错误的算式/做法/答案，让学生一眼认出"这就是我会写的"。 2. **为什么会这么想** — 点破背后的错误直觉或思维定式（比如"以为分数像整数一样分子分母分开加""把周长当成面积"）。这是关键：只有说中他心里那个"想当然"，他才会被点醒。 3. **为什么是错的** — 用该年级听得懂的方式说明它错在哪，最好用具体数字、画图或反例验证给他看（如代入数字一算就发现不对）。 4. **正确该怎么做 / 怎么避免** — 给出正确做法，并教一个能防住这个错的小习惯或自检办法（如"加分数前先问自己：分母一样了吗？"）。

正确答案旁若能顺手对比"正确 vs 错误"两种结果，对比着讲会更醒目。

举一反三（练习文件内容）

• 3~5 道题，**只考同一个或紧密相关的知识点**，难度递增（基础→变式→稍有挑战）。
• 每道题给出：**完整答案** + **详细解题过程**（过程详尽程度等同讲解文件，让学生能独立看懂）。
• 练习文件结构：先集中列出所有"题目"，再给"参考答案与详解"，便于学生先自测再对答案。

输出文件

写入**当前项目的 `markdown/` 目录**（不存在则创建）。两个文件：

• 讲解文件：`markdown/<英文短名>-讲解.md`
• 练习文件：`markdown/<英文短名>-练习.md`

`<英文短名>` 用简短英文描述题目主题（如 `fraction-addition`、`newton-second-law`）。两文件互相在开头用相对链接引用对方。

配图规则（少而精）

只有当"一张图能让某个关键步骤瞬间清楚"时才配图，每个文件通常 0~2 张。

• **优先 mermaid**：流程、步骤、分类、关系、简单坐标逻辑——直接写进 Markdown 代码块。
• **需要精确几何/函数图象/示意图时用 SVG**：
• SVG 文件存到 `markdown/svg/<英文图片名>.svg`（目录不存在则创建）。
• 文中用 `` 引用（注意：相对 `markdown/` 目录的路径，所以是 `svg/...` 而非 `markdown/svg/...`）。
• SVG 要自带文字标注（点名、数值、单位），保证不依赖正文也能看懂。

不要为了配图而配图。纯计算题往往一张图都不需要。

质量自检清单

交付前逐项核对：

• [ ] 已确认年级；全文用词、方法都在该年级基线内，无超纲。
• [ ] 答案是**自己算过**的，正确。多解法时各解法答案一致。
• [ ] 多解法已按"启发思维"优先级排序，且说明了为什么先讲它。
• [ ] 每步讲了"为什么"，不是只有"怎么算"。
• [ ] **最典型的易错点已按"错法→为什么这么想→为什么错→怎么避免"四步详细讲解**（不是只列一句话）。
• [ ] 练习题只考同知识点、难度递增；每题有完整答案+详细过程。
• [ ] 两个文件都已写入 `markdown/`，并互相引用。
• [ ] 配图（如有）确实服务于关键步骤；SVG 存于 `markdown/svg/` 且用 `svg/xxx.svg` 引用。

资源

• `references/grade_levels.md` — 各年级的语言风格、可用知识点、讲解策略与禁用项。**每次讲解前必读对应年级段。**
• `references/examples.md` — 一个完整的输入→输出范例（讲解文件 + 练习文件 + mermaid 用法），动笔前可参考其结构与详尽程度。