前言¶
初中生數學錯題復盤，常見做法是手抄題目、零散記筆記。題目裏的公式和圖形抄起來費時，抄完也未必能對上考綱裏的考點，更難得的是系統做變式練習。若你已經在用支持 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
