长会话结束前，让 AI 先写一份交接文档

用 Claude Code、Codex 做长任务时，我们经常会遇到一个问题：

今天它已经读了很多文件，改了几轮，也踩过坑。
但明天重新开一个会话，它又不知道昨天发生了什么。

这不是 AI 不聪明，而是上下文会断。

所以，长会话结束前，可以养成一个小习惯：

让 AI 写一份 HANDOFF.md。

它就像项目里的工作日志，写给下一个完全没有上下文的新会话看。

直接复制这段提示词

这个会话要结束了。

请写一份交接文档存到 HANDOFF.md，写给一个完全没有上下文的新会话看。

请包含：
1. 我们在做什么任务；
2. 已经完成了什么；
3. 当前卡在哪里；
4. 下一步计划是什么；
5. 有哪些踩过的坑不要再踩；
6. 新会话开始后应该先读哪些文件。

要求：
- 写清楚具体文件名和路径；
- 不要写空泛总结；
- 不要假设新会话知道前面的聊天记录；
- 写完后告诉我 HANDOFF.md 保存在哪里。

这段话的重点不是让 AI 写一篇漂亮总结，而是让它把任务状态交代清楚。

比如：哪个文件是最终稿，哪个文件不能再用；哪里还没核查；下一步应该先做什么。

下次怎么接上

下次开新会话，第一句话可以这样写：

先读 HANDOFF.md。

读完后请先复述：
1. 当前任务是什么；
2. 已完成什么；
3. 当前卡点是什么；
4. 你准备先做哪一步。

复述确认后，再继续执行。

建议加上“复述确认”这一步。

因为 AI 读了文件，不代表它一定抓住了重点。让它先复述，我们可以很快发现它有没有理解错。

什么时候适合用

HANDOFF.md 适合跨天推进的任务，比如：

• • 写一篇长文章；
• • 整理一批文件；
• • 做代码或数据分析；
• • 多轮修改一个项目；
• • 需要记录报错、卡点和已踩过的坑。

如果只是改一句话、问一个概念，就没必要专门写。

小结

AI 的记忆以会话为界，但我们的项目常常以天、周为单位推进。

中间的落差，如果每次都靠自己补充，很容易漏。

一个 HANDOFF.md，就能把任务、进度、卡点和下一步留下来。

聪明但每天失忆的助手，更需要一本能接上的工作日志。

往期推荐

• • 给 Codex 写一份 AGENTS.md：让它先读懂你的工作规矩
• • Codex 和 ChatGPT 到底有什么区别？