# 880 Wrongbook

> 880 Wrongbook

- Skill: `treasoni/880-wrongbook` (Agent Skill)
- Install (CLI): `npx skillmds@latest add treasoni/880-wrongbook`
- Raw SKILL.md: https://api.skillmd.com/api/skills/treasoni/880-wrongbook/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: treasoni (https://skillmd.com/u/treasoni)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/treasoni/880-wrongbook

---


# 错题本

错题本按章节组织，`不会/半会` 为重点，`错/粗心` 为轻标记；每条带复习状态。重练正确并标为「已掌握」的题会保留在文末「已掌握归档」，不从错题记录中删除。

## 步骤

1. **查看状态清单**：
   ```
   python3 scripts/wrong_book.py --list-states
   # 线代：python3 scripts/wrong_book.py --subject linear-algebra --list-states
   ```
   或直接读高数 `workspace/wrong-book/错题本.md` / 线代 `workspace/wrong-book/线代错题本.md`。
2. **重生成错题本**：
   ```
   python3 scripts/wrong_book.py
   # 线代：python3 scripts/wrong_book.py --subject linear-algebra
   ```
3. **更新复习状态**：
   ```
   python3 scripts/wrong_book.py --mark gs-c01-basic-choice-003=已掌握
   # 线代：python3 scripts/wrong_book.py --subject linear-algebra --mark la-c07-basic-choice-001=已掌握
   ```
   状态可选：未复习 / 已重做 / 已掌握。
   - Windows 把 `python3` 换成 `py -3`（或 `make wrongbook PYTHON='py -3'`）。

4. **补充题目解析/学习笔记时**：
   - 不要直接编辑 `workspace/wrong-book/错题本.md`；它是生成产物，重建会覆盖手工修改。
   - 将补充内容写入对应索引（高数 `workspace/question-index.json`；线代 `workspace/linear-algebra-question-index.json`）的 `solution`，再以同一 `--subject` 重建。
   - 公式独立块统一使用 `$$...$$`，禁止 `\\[...\\]`；写入 LaTeX 时使用 raw string/显式转义，避免 `\\f` 变成控制字符。
   - `wrong_book.py` 会在写文件前拒绝旧式公式定界符和控制字符；若校验失败，先修索引再重建。
   - 重建后运行 `python3 scripts/lint_content.py`，并用题号或新增内容 grep 错题本，确认补充确实出现在目标条目下。

## 重练流程（对话式）

用户报"重练了某题，会了"时：
- 若该题在**某张卷子**里：走 `880-grade` 技能 `--redo`，直接记判分并联动状态；判分为「对」后移入错题本末尾的「已掌握归档」；
- 若不在卷子里：先确认题号（qid），用 `wrong_book.py --mark <qid>=已掌握`。

## 禁止

- 不要随意把题从错题本删除（除非用户明确要求）；
- 复习状态由用户报告更新，不要自行推断。

## 内容规范

- 错题本 frontmatter（`total`/`focus_count`/`mastered_count`）与结构遵循 `.codex/rules/common/obsidian-content.md` 的「错题本」一节；
- `total` 包含待复习题与「已掌握归档」；`focus_count` 只统计待复习的「不会/半会」。
- 每题条目带来源卷子链接（高数 `[[卷子-XX]]`；线代 `[[线代卷子-XX]]`），取最近一次判分的卷子；
- 若 `workspace/records/external-links.json` 为该题配置了外部错题本关联（值为数组，每题可多条，每条含 `path`+`anchor`），自动输出 `*相关笔记：[[…]] · [[…]]*`（由 `wrong_book.py` 渲染，无需手改错题本）；
- 若 `workspace/records/analysis.json` 为该题配置了过程分析，条目末尾自动渲染「错因分析」callout（错因/出错环节/建议，由 `wrong_book.py` 输出）；分析由 `880-analysis` skill 写入，非错题本流程生成；
- 若需调整格式，先改规则文件，再改 `scripts/wrong_book.py`。