把 AI 编码计划纳入 Git,方便审查与交接
文章指出,编码工具把计划保存在会话目录中,会限制跨工具交接,也可能因自动清理丢失。作者建议将计划写入任务分支的 PLAN.md,让审查者和其他智能体都能读取并追踪修改。
原文暂未完整获取,基于公开信息的快读
AI 编码工具生成的实施计划,往往跟着会话走,没有进入代码仓库。dev.to 上的一篇文章提出:把批准后的计划写成任务分支里的 PLAN.md,并提交到 Git。这样,审查者能对照计划看代码,接手任务的其他智能体也能找到同一份文档。
目前能确认什么
根据原文节选,Claude Code 把计划保存在 ~/.claude/plans/,Copilot CLI 则放在各自的会话目录。作者引用的文档显示,Claude Code 的计划目录受自动清理机制管理,但会话压缩时会从磁盘重新载入计划,不能把「压缩上下文」直接理解成「计划丢失」。
Codex 的情况没那么确定:作者查到的命令说明没有交代计划是否落盘,因此「计划留在聊天中」只是作者的推断。
作者建议,在首次修改代码前提交 PLAN.md,记录目标、步骤、关键决策和完成条件。后续调整也随代码提交更新。Git 能保存文件的修改历史,审查者可以通过差异查看计划如何变化;其他工具只要能访问仓库,也有了可读取的交接材料。
我的判断
对需要跨会话、跨工具接力的任务,计划进入 Git,能让交接有一个明确入口。
尤其是接口行为、兼容性取舍和验收条件,这些信息未必能从最终代码里完整还原。把它们写进计划,审查时就能追问:实现偏离了约定,还是约定已经调整?
但文件可见,不代表智能体一定会读。作者提出在 AGENTS.md 中加入读取和更新规则,各工具如何加载这些规则,仍需官方文档确认。
计划还必须跟着实现更新,否则它会变成另一份过期文档。我更倾向于把这套做法用于有多步实施、明确取舍或交接需求的任务;几行即可完成的小修改,不必额外维护一份计划。