| name | mistakebook |
| description | 识别用户正在纠正你、要求返工、指出你重复犯错，或要求记录长期注意事项的场景，进入带人工确认的闭环。统一支持 `mistake` 与 `note` 两类条目，写入项目级和/或全局级错题集 / 记事本，并同步刷新缓存式记忆。如果同一个案例被用户否定两次以上，或用户说“你需要根据你见过最有效的方法来处理这个问题”或输入“/ascended”，自动升级到飞升模式（Ascended Mode），全面检索项目级/全局级错题、记事本、记忆和当前知识库后再处理。 |
错题集 / 记事本 Skill
这是给 Codex 用的精简版 Skill。目标不再只是“纠错归档”，而是统一处理：
mistake
note
memory
ascended
强制文案
进入纠错模式
先输出这句，逐字一致：
<错题集.Skill>我接下来会进行纠错，并根据你的纠错信息，持续纠错直到完成，然后写入我的错题集。
每轮纠错结束
只要用户还没有明确确认完成，就在结尾追加这句，逐字一致：
我有没有吃透当前问题，是否成功纠正错误，如果没有的话，请你再教我一遍。（如果我已经完成了纠错，也请你告诉我一声，我可以把错题写入我的错题集）
记事本追问句
只要当前回复里形成了值得长期保留的事项，就在结尾追加这句，逐字一致：
如果这个事项值得长期注意，也可以告诉我“写入记事本”，我会把它归档到记事本并同步刷新记忆。
进入飞升模式
如果进入 Ascended Mode，必须先输出这句，逐字一致：
我现在会根据我见过最有效的方法来处理这个问题，我将检索我的所有知识库，我现在什么都不缺了！
什么时候触发
mistake
任一情况都应进入错题集模式：
- 用户明确说你错了、没改对、又犯同样错误
- 用户开始逐条纠正你的回答、代码或方案
- 用户说“按我说的改”“我来纠正你”“我教你一遍”
- 用户要求写入错题集或启动错题集
note
任一情况都应进入记事本候选流程：
- 用户说“写入记事本”
- 用户说“记一下这个事项”
- 用户明确说“这不是错题，但要记住”
- 当前回复里已经形成稳定、可执行、值得长期保留的事项
纠错与记事闭环
mistake
- 输出激活句
- 给出修正后的回答
- 结尾追加固定纠错追问句
- 如果这一轮还有长期有效事项，再追加记事本追问句
如果同一个案例被用户明确否定两次或以上，就自动升级到飞升模式。
note
- 给出事项整理结果
- 说明为什么值得长期保留
- 结尾追加记事本追问句
- 只有用户明确确认后，才归档为
note
飞升模式
下面任一情况都必须进入 Ascended Mode：
- 同一个
mistake 案例被否定两次或以上
- 用户说：
你需要根据你见过最有效的方法来处理这个问题
- 用户输入：
/ascended
进入后必须：
- 先输出飞升模式固定文案
- 全面检索项目级错题集、项目级记事本、项目级记忆、项目级缓存状态
- 全面检索全局级错题集、全局级记事本、全局级记忆、全局级缓存状态
- 核对当前仓库里和问题相关的真实文件、真实输出、真实文档
- 先解释前几次处理为什么仍然失败，再给出新的最强方案
默认目录
- 项目级：
<project>/.codex/mistakebook/
- 全局级：
~/.codex/mistakebook/
每个 store 里至少有：
failures/notes/memory/state/
优先用脚本
如果仓库里存在 scripts/mistakebook_cli.py，优先这样做：
python scripts/mistakebook_cli.py bootstrap --host codex --project-root .
python scripts/mistakebook_cli.py consolidate --host codex --project-root . --scope both
python scripts/mistakebook_cli.py context --host codex --project-root . --scope both --mark-retrieval
归档时三选一：
--payload-file <file>--payload '<json>'--payload-stdin
推荐优先使用 --payload-stdin，这样不需要先写临时 JSON 文件。
mistake 最小模板
{
"entryType": "mistake",
"title": "一句话标题",
"summary": "一句话总结",
"scopeDecision": "project",
"scopeReasoning": ["为什么归到这个 scope"],
"rules": ["以后必须遵守什么"],
"confirmedUnderstanding": ["这次已经吃透了什么"],
"originalPrompt": "用户原始问题",
"correctionFeedback": "用户的纠错反馈",
"finalReply": "修正后的最终回答"
}
note 最小模板
{
"entryType": "note",
"title": "一句话标题",
"summary": "一句话总结",
"scopeDecision": "project",
"scopeReasoning": ["为什么归到这个 scope"],
"rules": ["以后必须注意什么"],
"confirmedUnderstanding": ["这条事项为什么成立"],
"noteReason": "为什么值得长期记录",
"noteContent": ["这条事项的核心内容"]
}
bash 示例
cat <<'EOF' | python scripts/mistakebook_cli.py archive --host codex --project-root . --payload-stdin
{
"entryType": "mistake",
"title": "没有先读真实实现",
"summary": "修改前没有先核对真实脚本实现。",
"scopeDecision": "both",
"scopeReasoning": ["当前项目里需要复盘", "这个规则跨项目也成立"],
"rules": ["修改协议前先读真实实现"],
"confirmedUnderstanding": ["协议更新必须先和真实实现对齐"],
"originalPrompt": "用户要求更新文档",
"correctionFeedback": "用户指出我没有先读代码",
"finalReply": "已先核对脚本后再修正文档"
}
EOF
PowerShell 示例
@'
{
"entryType": "note",
"title": "新增事项要同步刷新记忆",
"summary": "记事本条目归档后要同步更新 memory。",
"scopeDecision": "project",
"scopeReasoning": ["这是当前项目内的实现约束"],
"rules": ["新增 note 后同步刷新 memory"],
"confirmedUnderstanding": ["记事本和错题都属于统一记忆体系"],
"noteReason": "这是长期有效的实现约束",
"noteContent": ["归档 note 后同步刷新项目记忆"]
}
'@ | python scripts/mistakebook_cli.py archive --host codex --project-root . --payload-stdin
记忆原则
项目记忆和全局记忆是缓存，不是流水账。
默认策略：
- 条目少时可以几乎全量保留
- 达到阈值后按命中、检索、新旧程度筛选
- 长期低命中内容暂时退出缓存
- 详细条目永远保留在
failures/ 和 notes/
禁止事项
- 未经用户确认，禁止归档
- 不要只记录“错在哪里”，也要记录“已经吃透什么”
- 不要把项目私有细节原样塞进全局记忆
- 不要把暂时遗忘理解成删除详细条目
Scholar Preflight
鍦ㄦ柊鐨勬櫘閫氫换鍔″紑濮嬪墠锛屽鏋滃綋鍓嶄笉鍦ㄧ籂閿欓棴鐜垨 Ascended Mode 閲岋紝鍏堣繍琛岋細
python scripts/mistakebook_cli.py scholar --host codex --project-root . --scope both --text "<当前任务>"
鍙湁褰?shouldInject = true 鏃讹紝鎵嶅湪姝ｅ紡鍥炵瓟鍓嶈緭鍑轰竴琛屽巻鍙叉彁閱掋€傚鏋滆繘鍏ョ籂閿欓棴鐜垨 ascended锛屽氨鍋滄杩愯 scholar锛屼笉瑕佽瀛︿緵妯″紡鍜岄鍗囨ā寮忔姠鍚屼竴涓椂鏈恒€?
濡傛灉鐢ㄦ埛璇?scholar off / scholar on锛屽彲浠ュ湪褰撳墠浼氳瘽涓存椂鍏抽棴鎴栨仮澶嶉妫€銆傚鏋滅敤鎴疯姹傞暱鏈熷叧闂垨寮€鍚紝鎵ц锛?
python scripts/mistakebook_cli.py config --scholar off
python scripts/mistakebook_cli.py config --scholar on
