mistakebook

Mistakebook Skill

我已经刷了几万道练习题，我已经总结了海量的错题，我现在什么都不缺了!

---

📦 安装方式

在 Claude Code、Codex 等支持 Skill 的 Agent 里，直接说：

帮我安装 Mistakebook Skill：https://github.com/Septemc/MistakebookSkill.git

---

这次版本的核心升级

当前版本已经从“单一错题集”升级成统一模型：

1. 支持两类条目
   • mistake：已经完成纠错、值得复盘的错误案例
   • note：不一定是错误，但值得长期保留的主动事项
2. 每次归档都会刷新
   • 项目记忆
   • 全局记忆
3. 记忆不是流水账，而是缓存
   • 初期可以接近全量保留
   • 达到阈值后开始整理和暂时遗忘
   • 详细条目仍保留在 failures/ 和 notes/
4. 飞升模式不再只看错题
   • 还会检索记事本
   • 检索记忆缓存状态
   • 检索当前真实文件、真实输出、真实文档

这个项目解决什么问题

普通 Agent 在被用户纠正时，常见问题不是“道歉不够诚恳”，而是：

1. 这轮改完，下轮又犯同类错误
2. 用户纠错只停留在聊天记录，不能沉淀成结构化经验
3. 已经被纠正多次了，Agent 还是在浅层修补
4. 没有区分“项目特有经验”和“跨项目通用规则”
5. 没有把“值得长期注意但不一定是错题”的事项沉淀下来
6. 记忆越积越长，最后没人敢再读，也没人知道该忘什么

Mistakebook Skill 的目标，就是把这些问题转化成真正的记忆资产。

核心能力

1. 统一闭环：错题 + 记事本

这个项目不再只处理错题，而是统一处理两种场景：

1. 用户在纠正你
   • 进入 mistake 闭环
2. 用户在要求你保留长期事项
   • 进入 note 闭环

2. 固定纠错闭环

一旦进入纠错模式，Agent 必须先输出固定激活文案：

<错题集.Skill>我接下来会进行纠错，并根据你的纠错信息，持续纠错直到完成，然后写入我的错题集。

之后每轮纠错结束，如果用户还没有明确确认完成，都必须在结尾继续追问：

我有没有吃透当前问题，是否成功纠正错误，如果没有的话，请你再教我一遍。（如果我已经完成了纠错，也请你告诉我一声，我可以把错题写入我的错题集）

3. 固定记事本追问句

只要当前回复里已经形成一个值得长期保留的事项，Agent 应该在结尾追加：

如果这个事项值得长期注意，也可以告诉我“写入记事本”，我会把它归档到记事本并同步刷新记忆。

4. 只在明确确认后归档

只有用户明确确认时，才允许归档：

1. 对 mistake
   • 可以了
   • 这次对了
   • 归档吧
   • 写入错题集
   • 完成纠错
2. 对 note
   • 写入记事本
   • 记下来
   • 长期保留这条

5. 记忆是缓存，不是全文仓库

每次写入 mistake 或 note 后，都会刷新：

1. 项目记忆
2. 全局记忆

这些记忆文件的定位是缓存层：

1. 只保留高密度、可执行、未来值得再次注入的内容
2. 达到阈值后，不再机械累加
3. 低命中、长期不再活跃的内容会暂时退出缓存
4. 详细条目仍保留在详细归档目录里

6. 飞升模式（Ascended Mode）

当普通纠错已经不够时，或者用户明确要求：

1. 你需要根据你见过最有效的方法来处理这个问题
2. /ascended

Agent 会升级到飞升模式。

进入飞升模式时，Agent 必须先输出：

我现在会根据我见过最有效的方法来处理这个问题，我将检索我的所有知识库，我现在什么都不缺了！

飞升模式会尽量完整地检索：

1. 项目级错题集
2. 项目级记事本
3. 项目级记忆
4. 项目级缓存状态
5. 全局级错题集
6. 全局级记事本
7. 全局级记忆
8. 全局级缓存状态
9. 当前仓库中和问题相关的真实文件、真实输出、真实文档
10. 当前 case 的完整纠错链 / 事项链

7. 学霸模式

当这是一个新的正常任务，而不是纠错、记事本归档或飞升场景时：

1. 先运行 scholar
2. 只在高置信命中历史案例时，给出一行历史提醒

Agent 会进入学霸模式预检。

进入学霸模式时，Agent 应优先执行：

python scripts/mistakebook_cli.py scholar --host codex --project-root . --scope both --text "<当前任务>"

学霸模式会尽量轻量地完成这些事情：

1. 检索项目级错题集
2. 检索项目级记事本
3. 检索项目级记忆
4. 检索全局级错题集
5. 检索全局级记事本
6. 检索全局级记忆
7. 按字段命中和 memory score 对候选案例排序
8. 只返回最相关的高置信结果
9. 只在 shouldInject = true 时输出一行 message
10. 不写归档、不刷新 memory、也不增加 retrieval 记账

学霸模式和飞升模式的职责边界：

1. 学霸模式负责答前避错
2. 飞升模式负责失败后的升级处置
3. 一旦进入纠错闭环、记事本归档或 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

关键文件