把孩子做错的题，变成一个会追踪、会复习、会举一反三的私人学习系统。
wrong-question-review 是一个给 AI Agent 使用的错题管理 skill。它帮助 Agent 把试卷照片、截图、PDF、口述题目或手动录入的错题，整理成可追踪的学习资产：有结构化错题记录、有总索引、有知识点归因、有复习日期、有举一反三练习卷，也有后续反馈后的掌握状态更新。
它解决的不是“生成几道题”这个一次性问题，而是“错题怎么长期变成能力提升”这个持续性问题。
很多错题整理最后都会变成三个问题：
- 错题拍了照，但过几天就找不到了。
- 题目讲懂了，但没有同类变式练习，下一次还是容易错。
- 家长、老师或学生知道“这里薄弱”，却没有持续复习记录。
这个 skill 把这些碎片变成一个闭环：
收集错题 -> 抽取知识点 -> 分析错因 -> 更新索引 -> 生成变式练习 -> 记录反馈 -> 安排下一轮复习
对家长来说，它像一个不会忘记的错题管家。对老师和辅导者来说，它像一个轻量的个性化练习生成器。对 Agent 开发者来说，它是一个可以直接复用和改造的教育类 workflow 模板。
这个 skill 适合：
- 家长：把孩子每天的错题交给 AI，自动整理、归因、安排复习。
- 学生：按学科、学年、知识点、题型生成专门练习。
- 老师和辅导者：为单个学生维护长期错题档案，发现反复薄弱点。
- AI Agent 开发者：把它作为教育场景中的文件型 Agent 工作流参考。
- 自托管用户：希望错题数据留在自己的本地文件夹，而不是散落在聊天记录里。
默认学科包括语文、数学、英语。你也可以基于同样结构扩展到物理、化学、历史、地理等学科。
| 能力 | 说明 |
|---|---|
| 错题录入 | 处理扫描件、手机照片、截图、PDF 或手动录入内容 |
| 错因分析 | 提取学科、学年、章节、知识点、题型、难度和具体错因 |
| 总索引维护 | 更新 00_总索引.xlsx，让错题可以按日期、学科、知识点和掌握状态检索 |
| 结构化记录 | 为每道典型错题生成 Markdown 记录，方便长期阅读和迁移 |
| 举一反三 | 生成不照抄原题的基础题、变式题和关联拓展题 |
| 标准答案 | 在练习卷中保留完整答案和必要解析 |
| 双格式输出 | 默认保存 Markdown；环境支持时同时生成 PDF |
| 复习闭环 | 根据 全对、第3题错了、第2题不会 等反馈更新下次复习和掌握状态 |
| 历史关联 | 遇到相同或相近知识点时，参考历史错题，避免孤立练习 |
这个仓库首先面向 OpenAI Codex skill-compatible environments：
- 使用一个包含
SKILL.md的 skill 文件夹。 SKILL.md通过 YAML frontmatter 提供name和description。agents/openai.yaml提供 UI 展示信息和默认提示词。assets/保存可复制的错题记录模板和练习卷模板。references/保存索引规则和练习生成规则，供 Agent 按需读取。
这个 skill 也可以迁移到其他具备文件能力的 Agent 环境，例如 Claude Code、Cursor Agent、Cline 类 Agent、本地自定义 Agent 或带工具调用能力的教育 Agent。最低要求是：
- 能读取 Markdown 指令。
- 能读写本地文件。
- 能处理图片或 PDF，或者在无法识别时要求用户转写。
- 能维护结构化数据，优先是
.xlsx，也可以改成 CSV、JSON、SQLite、Notion、Google Sheets 等。 - 能生成 Markdown。
- 最好能把 Markdown 渲染成 PDF。
如果你的 Agent 不支持 Codex skill 机制，也可以把 SKILL.md 当作系统提示词或项目说明，把 assets/ 和 references/ 作为工具可访问文件。
克隆仓库：
git clone https://github.com/jayv29/wrong-question-review-skill.git复制 skill 到 Codex skills 目录：
mkdir -p ~/.codex/skills
cp -R wrong-question-review-skill/wrong-question-review ~/.codex/skills/打开新的 Codex 线程后，可以这样开始：
Use $wrong-question-review to create a wrong-question vault under ~/Documents/错题巩固.
然后上传图片、截图、PDF，或者直接输入题目，让 Agent 整理错题、更新索引、生成举一反三练习卷。
学生的真实数据不应该放进这个公开仓库。建议为每个学生建立一个私有目录，例如：
错题巩固/
00_待整理/
00_总索引.xlsx
_模板/
错题记录模板.md
衍生练习模板.md
语文/
01_原始错题/
02_衍生练习/
数学/
01_原始错题/
02_衍生练习/
英语/
01_原始错题/
02_衍生练习/
_归档/
你可以让 Agent 自动创建这个结构，也可以手动创建。模板在：
wrong-question-review/assets/
核心索引文件是：
00_总索引.xlsx
它会记录编号、日期、学年、学科、来源、章节、知识点、关联知识点、题型、错因、难度、文件路径、复习日期、掌握状态和备注。
- 录入错题：给 Agent 一张试卷照片、截图、PDF 或手动题目。
- 结构化分析：Agent 判断是否值得保留，提取知识点和具体错因。
- 保存记录：原始材料进入对应学科文件夹，分析结果保存为 Markdown。
- 更新索引：
00_总索引.xlsx变成长期可查的学习数据库。 - 生成练习：Agent 生成同模型基础题、变式提升题和关联拓展题。
- 学生反馈：用户告诉 Agent 哪些题对了、错了、不会。
- 复习推进：Agent 更新掌握状态、备注和下次复习日期。
这个流程的重点是复利：同一个知识点出现得越多，错题库越知道学生真正薄弱在哪里。
录入错题：
Use $wrong-question-review to 整理这张数学错题图片，提取知识点、错因和解题步骤，并更新总索引。
生成练习：
Use $wrong-question-review to 基于最近两周的数学错题，生成一份四年级举一反三练习卷，要包含标准答案和解析。
指定知识点：
Use $wrong-question-review to 针对“分数加减法”和历史相关错题，生成一份 12 题的专项练习。
反馈复习结果：
刚才那张练习卷第3题和第5题错了，请用 $wrong-question-review 更新掌握状态，并安排下一轮复习。
阶段性复盘：
Use $wrong-question-review to 总结这个月数学错题中反复出现的知识点，并给出下周复习计划。
如果你的 Agent 不支持 Codex skill 文件夹，可以按下面方式迁移：
- 把
wrong-question-review/SKILL.md放进 Agent 的系统提示词、项目规则或可复用 memory。 - 让 Agent 能按需读取
wrong-question-review/references/index-schema.md。 - 让 Agent 能按需读取
wrong-question-review/references/practice-generation.md。 - 把
wrong-question-review/assets/作为模板目录，供 Agent 复制到用户的私人错题库。 - 把触发条件改成你的 Agent 平台支持的形式。核心触发条件是：用户要整理错题、生成练习、更新复习反馈或维护错题库。
- 把
00_总索引.xlsx替换成你的平台最稳定的数据层。可以是.xlsx、CSV、JSON、SQLite、Google Sheets、Notion database 或任意结构化存储。 - 保留隐私边界：skill 是公开的，学生错题库是私有的。
建议其他 Agent 改造时保留三个原则：
- 记录要结构化：不要只保存聊天总结。
- 练习要变式化：不要复制原题当作复习。
- 反馈要回写：练习结果必须改变下一次复习计划。
wrong-question-review/
SKILL.md
agents/
openai.yaml
assets/
错题记录模板.md
衍生练习模板.md
references/
index-schema.md
practice-generation.md
examples/
sample-vault/
README.md
README.en.md
LICENSE
这个仓库不包含真实学生错题、不包含真实 00_总索引.xlsx、不包含生成过的练习卷，也不应该上传这些内容。
请把以下内容保存在自己的私有目录中：
- 学生姓名、学校、班级等个人信息。
- 试卷照片、截图、扫描件、PDF。
- 错题记录、复习反馈、掌握状态。
- 生成的练习卷和答案。
- 任何可能识别学生身份的材料。
MIT License. 你可以自由使用、修改和再发布这个 skill。请在再发布时保留许可证信息。