前言¶
初中生数学错题复盘，常见做法是手抄题目、零散记笔记。题目里的公式和图形抄起来费时，抄完也未必能对上考纲里的考点，更难得的是系统做变式练习。若你已经在用支持 Vision 的 Agent，可以把「拍一张错题照片 → 得到可复习的 Markdown」交给 Skill 规范化的流程处理，减少重复整理工作。
下面介绍 SkillHub 上的社区技能「初中数学错题复盘助手」，说明它做什么、如何安装，以及官方给出的使用演示。
这是什么¶
「初中数学错题复盘助手」是基于 AI Vision 的 Skill，定位是把初中数学错题照片自动转化为包含考点分析、变式训练与 SVG 图解的结构化复习文档。坐标为 @user_ae7a4960/math-mistake-review-skill，当前版本 1.0.0，来源为 community，分类 education，由发布者 user_ae7a4960 维护。SkillHub 页面标注 requires_api_key=false，即无需单独配置 API Key 即可按技能说明使用。
官方页面：
- https://www.skillhub.cn/skills/user_ae7a4960/math-mistake-review-skill
- https://api.skillhub.cn/user_ae7a4960/math-mistake-review-skill
核心功能¶
以下能力均来自 SkillHub 官方简介与技术说明，未在资料中出现的细节不展开。
从照片到结构化输出¶
技能描述的全链路包括：图像识别（OCR）、LaTeX 公式还原、与考纲匹配。输出遵循 Skill 规范，生成以「核心考点」命名的 Markdown 文件。辅助脚本使用 Python 标准库处理文件流，说明中写明无第三方依赖。
考纲与破题提示¶
内置 2025-2026 中考数学考纲速查手册。AI 在复盘时会定位题目考点，并给出破题关键（思维断点），而不只是复述答案。
可视化与变式¶
对几何、函数类题目，技能支持自动生成 SVG 矢量示意图。除原题还原外，会基于原题意境生成 2 道同维度变式题，用于巩固。
部署门槛¶
官方强调「零门槛」：纯前端逻辑表述配合无需 API Key 的标签，适合在已支持 Vision 与 Skill 的 Agent 环境中即装即用。
安装与启用¶
SkillHub 提供两种方式，可按你当前用的客户端选一种。
方式一：让 Agent 按 SkillHub 安装文档执行¶
将下面提示发给当前 AI（安装说明引用官方文档）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_ae7a4960/math-mistake-review-skill`。
Agent 会按 SkillHub 安装与优先源配置 检查 skillhub CLI、选择正确的 skills 目录并完成安装。
方式二：使用 skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，官方推荐完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时须用 --dir 指向当前 Agent 的 skills 目录（装到默认 ./skills/ 可能不会被识别）。官方文档给出的常见路径示例：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在对应目录下执行（将 <skills 目录> 换成上表路径）：
skillhub install @user_ae7a4960/math-mistake-review-skill --dir <skills 目录>
安装后按你所用 Agent 的要求重启或刷新技能列表。本技能无额外 API Key 配置项；若 Agent 本身调用 Vision 模型，仍需满足该客户端对多模态能力的常规要求。
典型用法¶
官方「使用场景演示」给出可复现的输入输出形态，可作为验收标准。
输入： 上传一张与「圆与切线」相关的错题照片（示例中为模糊照片）。
预期输出包括：
- 原题还原： 以 LaTeX 排版的清晰题目文本。
- 破局关键： 例如提示「连接切点与圆心构造直角三角形」。
- SVG 图解： 几何辅助线的矢量示意图。
- 变式训练： 2 道同类型题目供练习。
实际操作时，在已启用该 Skill 的对话中上传错题图片，并按技能说明请求生成复盘文档即可；具体触发话术以安装后的 SKILL.md 为准。
适用场景与注意¶
适合谁： 需要帮初中生整理数学错题的家长、教师，或学生本人在 Agent 环境下做数字化错题本；尤其适合希望同时拿到考点归纳、图示和变式题的场景。
限制与注意：
- 识别与排版质量依赖 Vision 能力与照片清晰度，极模糊或裁切不全的图可能影响 LaTeX 与考点判断。
- 考纲手册版本为资料中写明的 2025-2026 中考数学范围，其他地区或学段需自行核对是否匹配。
- SVG 与变式题由模型生成，使用前建议人工核对数学正确性与难度是否合适。
- SkillHub 统计为社区数据（页面展示评分与下载量会变动），以安装时页面为准。
结尾¶
「初中数学错题复盘助手」把错题照片、考纲对照、图示和变式题收进一条 Skill 流程，减少手抄与零散笔记。若你要试用或查看更新说明，请打开官方 SkillHub 页面：https://www.skillhub.cn/skills/user_ae7a4960/math-mistake-review-skill
