Codex 如何避免任务失忆？planning-with-files 使用教程

Codex 避免任务失忆，关键不是让模型“记性更好”，而是把任务状态写到文件里。planning-with-files 的 Codex 集成通过 hooks 在会话开始、用户提交提示、工具调用前后、压缩前和停止时插入提醒或计划上下文。这样 task_plan.md 不是摆设，而会反复回到 Agent 的注意力里。

它和普通待办有什么区别

普通待办只告诉你“还剩什么”，planning-with-files 还要求记录发现、错误、测试结果和阶段状态。官方 reference 里的核心比喻是 Context Window 像 RAM，Filesystem 像 Disk。对日常编程的影响是：长任务不再完全依赖聊天窗口，压缩上下文后仍能从磁盘恢复目标和路径。

Codex 使用顺序

• 安装 .codex/skills/planning-with-files 和 hooks 文件。
• 在 config.toml 开启 hooks = true，并重启 Codex。
• 开始复杂任务前先生成 task_plan.md。
• 每完成一个 phase 更新状态和 progress.md。
• 压缩上下文或恢复会话后，先读三份文件再继续。

避坑点也很具体：不要把外部网页原文写进 task_plan.md，因为计划文件会被 hooks 读取；研究资料放到 findings.md 更合适。CI 或只读审查想临时跳过计划注入，可以按官方文档使用 PLANNING_DISABLED=1，具体支持情况以 docs/codex.md 为准。

我的用法是把它当作“可审计记忆”，不是让 Agent 无限自动跑。每一轮结束前看 progress.md 是否写了测试结果、失败原因和下一步；每个阶段完成后把 task_plan.md 状态改成 complete；真正提交代码前再看一次 Git Diff。能被文件证明的进度才算进度。

如果 Codex 还是跑偏，优先查三件事：hooks 是否启用，当前目录是否存在旧计划，task_plan.md 里是否混入了过期目标。清掉不可信状态，比继续加提示词更有效。计划文件要短、准、可执行，太长会让恢复成本重新升高。真正稳定的长任务，靠的是文件、日志和检查点一起对齐。每次恢复前都读一遍，比事后补救更省心可靠。