# Codex 收尾习惯：每次关会话前写 handoff.md

> 一句话让新会话直接接上旧进度

我在 Codex 里养成了一个收尾习惯，最近越用越觉得值得推广。

每次关掉长会话之前，我会让它写一份交接文档：

> "这个会话要结束了，请写一份交接文档，存到 handoff.md。"

文档按固定结构写：

- 我们在做什么任务
- 已经完成了什么
- 当前卡在哪
- 下一步计划是什么
- 有哪些踩过的坑，绝对不要再踩
- 写给一个完全没有上下文的新会话

下次开新会话，第一句话只要说：

> "先读 handoff.md。"

就这么简单，但能解决 AI 编程里最大的隐性成本：上下文丢失。

Codex 一次长会话能持续处理很复杂的任务，好几天、几十轮、改十几个文件都很常见。但一旦会话关掉，之前所有的推理链、失败路径、临时决定、接口约定，基本就等于清零。新会话如果只看代码，很难还原"当时我们为什么这样写"， inevitably 会重走老路。

交接文档不是项目 README 那种面向所有人的东西，它是**会话与会话之间的私人便签**。因为是由 AI 自己总结，所以它知道哪些细节重要、哪些是死胡同。人写反而容易遗漏，AI 写反而更完整。

我现在的流程已经变成：

1. 长会话结束前，让 Codex 生成 handoff.md
2. 提交到仓库里，和代码放一起
3. 下次开新会话，先读 handoff.md，再开始新改动

几本好处：

- 新会话不需要重新解释需求
- 之前踩过的坑不用重踩
- 任务断点很清楚，不会反复问"我们上次做到哪了"
- 多会话协作有连续性，像接棒跑一样

特别适合那些需要好几天才能做完、中间会多次中断的任务。也适合多人轮流用同一个项目的情况。

如果你也在用 Codex、Cursor、Windsurf 这类支持长上下文编程会话的工具，强烈建议试试这个习惯。成本很低：一句话加一份 Markdown。收益很高：每次开新会话都能直接接上进度，而不是从头热身。

一句话总结：**会话会过期，但 handoff.md 不会。**

---

**分类**：随笔
**标签**：Codex · md · handoff
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1926