Codex + Planning-with-Files 怎么用？完整使用指南
如果你用 Codex 处理稍复杂的项目，经常遇到做到一半忘目标、会话中断后从零开始、同一错误反复尝试等问题，Planning-with-Files 正是解决这些痛点的开源方案。它通过把计划持久化到本地文件，让 Codex 每次操作前都能重新读取完整上下文。
为什么需要 Planning-with-Files
Codex 默认没有持久化工作记忆。每次工具调用后，原始任务目标容易被新输出挤掉，导致任务跑偏。Planning-with-Files 的核心思路很简单：把计划写在磁盘上，强制代理在每一步前重新阅读，从而保持任务连贯性。
核心概念：三文件规划模式
Planning-with-Files 在项目根目录维护三个 Markdown 文件：
- task_plan.md：任务大脑，记录阶段划分、进度标记、决策与错误。
- findings.md：任务笔记本，保存研究发现、技术决策及理由。
- progress.md：任务日记，追踪会话日志、测试结果和错误时间线。
三者关系清晰：task_plan.md 定义“做什么”，findings.md 记录“发现了什么”，progress.md 追踪“做到了哪”。
安装方法
项目级安装（推荐）
在项目根目录执行以下命令：
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
cp -r /tmp/planning-with-files/.codex .
git add .codex/
git commit -m "Add planning-with-files skill for Codex"
git push
rm -rf /tmp/planning-with-files
全局安装
适合个人多项目复用，直接克隆到本地固定路径即可。
基本使用流程
- 创建任务时，先让 Codex 写入 task_plan.md，明确阶段和验收标准。
- 每次探索后更新 findings.md。
- 执行代码或测试后更新 progress.md。
- 新会话开始前，提示 Codex 先读取三个文件。
遇到计划太粗时，可直接说：“请把计划写得更具体，包含要改哪些文件、每步验收方式。”
使用指南在哪里看
官方仓库（https://github.com/OthmanAdi/planning-with-files）提供了完整 README 和示例文件。实际使用中，建议先在小项目里跑通三文件更新流程，再应用到正式项目。
掌握以上步骤后，Codex 处理复杂任务的稳定性会明显提升。