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（目录不存在则创建）。
  • 文中用 ![图片描述](svg/<英文图片名>.svg) 引用（注意：相对 markdown/ 目录的路径，所以是 svg/... 而非 markdown/svg/...）。
  • SVG 要自带文字标注（点名、数值、单位），保证不依赖正文也能看懂。

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

质量自检清单

交付前逐项核对：

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

资源

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