Agent上下文交接文档

对长时间的 Claude Code 编程会话来说，“生成交接文档 → 开新上下文”通常比反复 /compact 更稳。

/compact 的优点是省事，但它的摘要是自动生成的，可能丢掉一些细节；交接文档则可以主动把真正重要的信息留下来。尤其是项目已经做了很多轮修改、排查和决策时，我更推荐这种方式。

交接文档最好包含这些内容：

• 当前目标：现在到底在解决什么问题
• 已完成内容：哪些功能已经实现
• 关键决策：为什么采用现在的方案，哪些方案被否掉了
• 修改文件：具体改过哪些文件、关键函数/模块
• 当前代码状态：git status、必要的 git diff
• 测试情况：执行过哪些命令，哪些通过/失败
• 当前问题：现在卡在哪里、已知 bug 是什么
• 下一步：新会话第一步应该做什么
• 注意事项：哪些代码不要动、有哪些约束

我建议你让 Claude Code 在旧上下文里生成一个例如：

HANDOFF.md

提示词可以直接这么说：

请为当前开发任务生成一份详细的 HANDOFF.md 交接文档，供全新的 Claude Code 会话继续工作。

要求包含：
1. 当前任务目标和背景
2. 已经完成的工作
3. 所有重要技术决策及原因
4. 已修改的文件和关键代码位置
5. 当前 git status / git diff 中需要关注的内容
6. 已执行的测试、命令及结果
7. 当前未解决的问题和已知风险
8. 下一步建议，按优先级排序
9. 新会话继续工作时必须知道的约束和注意事项

不要只写概括性摘要，要写到新的 Claude Code 在完全不知道之前对话的情况下，也能继续开发。
生成 HANDOFF.md 后先不要继续修改业务代码。

生成完以后，最好自己快速扫一眼，确认关键问题没有漏掉。

然后你就可以：

/clear

或者直接退出重新：

claude

新会话第一句：

请先阅读 HANDOFF.md、CLAUDE.md、git status 和 git diff，
理解当前项目状态。

先向我总结：
1. 当前目标
2. 已完成工作
3. 当前未解决的问题
4. 你准备采取的下一步

暂时不要修改代码。

这样做有一个很大的好处：新 Claude 会重新直接读取实际代码，而不是完全依赖旧聊天摘要。 对编程任务来说，代码、Git diff、测试结果才是最可靠的事实来源。

你甚至可以把流程固定成：

开发一段时间
↓
上下文快满了
↓
更新 HANDOFF.md
↓
新 session
↓
读取 HANDOFF.md + git diff
↓
继续开发

所以你现在这个情况，我会更倾向于：如果这次 /compact 能成功，就利用压缩后的会话生成一次高质量 HANDOFF.md，然后主动开新上下文。 不需要一直把一个超长 session 硬撑下去。