Mistakebook Skill
错题集.Skill。我已经刷了几万道练习题，我已经总结了海量的错题，我现在什么都不缺了! / I have done tens of thousands of practice problems, and I have summarized a vast amount of wrong answers. Now, I am invincible.
这次版本的核心升级
当前版本已经从“单一错题集”升级成统一模型：
- 支持两类条目
mistake：已经完成纠错、值得复盘的错误案例note：不一定是错误，但值得长期保留的主动事项
- 每次归档都会刷新
- 记忆不是流水账，而是缓存
- 初期可以接近全量保留
- 达到阈值后开始整理和暂时遗忘
- 详细条目仍保留在
failures/ 和 notes/
- 飞升模式不再只看错题
- 还会检索记事本
- 检索记忆缓存状态
- 检索当前真实文件、真实输出、真实文档
这个项目解决什么问题
普通 Agent 在被用户纠正时，常见问题不是“道歉不够诚恳”，而是：
- 这轮改完，下轮又犯同类错误
- 用户纠错只停留在聊天记录，不能沉淀成结构化经验
- 已经被纠正多次了，Agent 还是在浅层修补
- 没有区分“项目特有经验”和“跨项目通用规则”
- 没有把“值得长期注意但不一定是错题”的事项沉淀下来
- 记忆越积越长，最后没人敢再读，也没人知道该忘什么
Mistakebook Skill 的目标，就是把这些问题转化成真正的记忆资产。
核心能力
1. 统一闭环：错题 + 记事本
这个项目不再只处理错题，而是统一处理两种场景：
- 用户在纠正你
- 用户在要求你保留长期事项
2. 固定纠错闭环
一旦进入纠错模式，Agent 必须先输出固定激活文案：
<错题集.Skill>我接下来会进行纠错，并根据你的纠错信息，持续纠错直到完成，然后写入我的错题集。
之后每轮纠错结束，如果用户还没有明确确认完成，都必须在结尾继续追问：
我有没有吃透当前问题，是否成功纠正错误，如果没有的话，请你再教我一遍。（如果我已经完成了纠错，也请你告诉我一声，我可以把错题写入我的错题集）
3. 固定记事本追问句
只要当前回复里已经形成一个值得长期保留的事项，Agent 应该在结尾追加：
如果这个事项值得长期注意，也可以告诉我“写入记事本”，我会把它归档到记事本并同步刷新记忆。
4. 只在明确确认后归档
只有用户明确确认时，才允许归档：
- 对
mistake
- 对
note
5. 记忆是缓存，不是全文仓库
每次写入 mistake 或 note 后，都会刷新：
- 项目记忆
- 全局记忆
这些记忆文件的定位是缓存层：
- 只保留高密度、可执行、未来值得再次注入的内容
- 达到阈值后，不再机械累加
- 低命中、长期不再活跃的内容会暂时退出缓存
- 详细条目仍保留在详细归档目录里
6. 飞升模式（Ascended Mode）
当普通纠错已经不够时，或者用户明确要求：
你需要根据你见过最有效的方法来处理这个问题/ascended
Agent 会升级到飞升模式。
进入飞升模式时，Agent 必须先输出：
我现在会根据我见过最有效的方法来处理这个问题，我将检索我的所有知识库，我现在什么都不缺了！
飞升模式会尽量完整地检索：
- 项目级错题集
- 项目级记事本
- 项目级记忆
- 项目级缓存状态
- 全局级错题集
- 全局级记事本
- 全局级记忆
- 全局级缓存状态
- 当前仓库中和问题相关的真实文件、真实输出、真实文档
- 当前 case 的完整纠错链 / 事项链
7. 学霸模式
当这是一个新的正常任务，而不是纠错、记事本归档或飞升场景时：
- 先运行
scholar
- 只在高置信命中历史案例时，给出一行历史提醒
Agent 会进入学霸模式预检。
进入学霸模式时，Agent 应优先执行：
python scripts/mistakebook_cli.py scholar --host codex --project-root . --scope both --text "<当前任务>"
学霸模式会尽量轻量地完成这些事情：
- 检索项目级错题集
- 检索项目级记事本
- 检索项目级记忆
- 检索全局级错题集
- 检索全局级记事本
- 检索全局级记忆
- 按字段命中和 memory score 对候选案例排序
- 只返回最相关的高置信结果
- 只在
shouldInject = true 时输出一行 message
- 不写归档、不刷新 memory、也不增加 retrieval 记账
学霸模式和飞升模式的职责边界：
- 学霸模式负责答前避错
- 飞升模式负责失败后的升级处置
- 一旦进入纠错闭环、记事本归档或
Ascended Mode，就必须停止运行学霸模式
仓库结构
.
├─ .claude-plugin/ # Claude 风格插件元数据
├─ .codex/ # Codex 安装说明
├─ codex/ascended/ # Codex 飞升模式 skill-chip 包装入口
├─ codex/mistakebook/ # Codex 主 skill-chip 入口
├─ codex/notebook/ # Codex 记事本 skill-chip 包装入口
├─ codex/scholar/ # Codex scholar skill-chip 包装入口
├─ commands/ # 手动命令入口
├─ evals/ # 触发词回归样例
├─ hooks/ # Claude 风格自动触发 / restore hooks
├─ scripts/ # 归档、缓存整理与上下文导出 CLI
├─ skills/mistakebook/ # 通用核心 Skill
├─ vscode/ # VSCode Copilot 适配
├─ plugin.json # 顶层插件包元数据
└─ README.md
关键文件
存储结构
默认每个 store 至少包含：
mistakebook/
├─ failures/
│ ├─ INDEX.md
│ └─ <timestamp>_<slug>.md
├─ notes/
│ ├─ INDEX.md
│ └─ <timestamp>_<slug>.md
├─ memory/
│ ├─ PROJECT_MEMORY.md
│ └─ GLOBAL_MEMORY.md
└─ state/
├─ catalog.json
└─ memory_state.json
其中：