Claude Code 用久了会话会”腐化”？这个 Skill 让 AI 记住每次交接的死路和结论

Claude Code 用久了，最怕的不是代码写不出来——而是写着写着，模型开始「失忆」。

长对话撑到后期，上下文中塞满了修改记录、工具输出、中间状态……模型开始重复自己：推翻半小时前的决策、重试早就证伪的方案、把已经改好的文件又改回去。你知道这叫什么吗？上下文腐化。

今天挖到一个真正解决这个问题的 Skill，叫 handoff。

痛点真实存在，你可能也遇到过

Claude Code 跑长任务，上下文窗口会越来越臃肿。有人选择忍——「算了，多轮对话就是这样」。有人选择开新会话——但开新会话意味着从头解释：项目在做什么、做到了哪一步、哪里踩过坑、下一步干什么。

每次解释都要花时间，有时候解释的时间比继续干活还长。

handoff 的作者把这个叫「会话腐化」（session rot）。他观察到：模型在上下文最不可靠的时候，偏偏要它输出最关键的总结——「这段对话干了什么」——这不是为难它吗？

两个命令，彻底解决会话接力问题

handoff 的设计极其简洁：两个斜杠命令，覆盖整个交接流程。

写交接：/handoff

收尾当前会话时，输入：

/handoff

Claude 会先对项目做一次完整「体验」，再写交接文档：

• 运行 git status、git log、git diff，确认项目真实状态
• 重读交接文档里提到的所有文件（文件位置变了？抓住幻觉）
• 重跑测试（”测试通过”只能来自这次运行的输出，不是记忆）

所有结论分成两类打标签：

• [V] Verified：经过实际验证，可以信任
• [?] Recalled：来自记忆，未经复核，当线索看待

写完的交接文档是 HANDOFF.md，存项目根目录，提交到 Git，方便换机器也能拉取。

接交接：/handoff resume

新会话开始时，输入：

/handoff resume

Claude 读取交接文档，和当前项目状态做一次对比核查——文件有没有改？测试还能过吗？然后汇报：「上次停在这里，有这些结论和坑要避开，你想从哪里继续？」

死路不过第二遍

handoff 最值钱的章节不是「干了什么」，而是「死路是哪条」。

文档里有一个「不要做」清单，专门记录本次会话里踩过的坑：哪个方案试过不行、为什么不行、什么前提条件下会踩。下一个 Claude 会话读到这里，就知道绕路。

这是纯靠「让模型总结」做不到的——因为那些失败是上下文腐化之前的事，模型早就记混了。handoff 的做法是：从第一天起就用验证过的记录，而不是模型记忆。

使用方式

安装：

git clone https://github.com/ostikwhy-blip/claude-code-handoff-skill.git
cp -r claude-code-handoff-skill ~/.claude/skills/handoff

收尾时：

/handoff

新会话开始时：

/handoff resume

无依赖、无外部 API、无需配置。纯本地工作流。

谁适合用

如果你符合以下任一条，handoff 值得装：

• 单个项目 Claude Code 会话超过 1 小时
• 需要经常在不同机器或不同时间段继续同一个任务
• 调试一个大 bug 要分多次会话才能搞定
• 团队成员要接力对方的 Claude Code 会话

这个 Skill 解决的问题很具体——会话腐化导致的上下文丢失——解决方案也很克制：不求记多，只求记准。所有结论都要经过实际验证，模棱两可的宁可不写。

GitHub 仓库里有一份详细的交接文档模板，说明了每段写什么、不写什么、为什么——有兴趣可以读读源码，看看一个好的交接文档应该长什么样。

GitHub：
https://github.com/ostikwhy-blip/claude-code-handoff-skill

GitHub: https://github.com/ostikwhy-blip/claude-code-handoff-skill