claude-code-handoff-skill
为Claude Code会话创建交接文件，确保工作在不同会话间无缝延续。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-code-handoff-skill。 它的用途是：为Claude Code会话创建交接文件，确保工作在不同会话间无缝延续。 完整的 Skill 内容见：https://321skill.com/skills/claude-code-handoff-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我感觉这个会话的上下文有点乱了，我们创建一个交接文件吧。” 它会立即检查项目根目录，如果已有`HANDOFF.md`则将其归档，然后重新读取所有相关文件、运行测试，生成一份包含已验证状态、失败尝试和下一步计划的详细交接文档。
介绍
当你在Claude Code中编写代码时，可能会遇到会话上下文过长导致AI记忆混乱、重复探索已解决的问题或出现幻觉（hallucination）的情况。这个Skill的核心功能就是创建一个HANDOFF.md文件，像一份精准的“手术交接单”，详细记录当前项目的已验证状态、关键决策、已知陷阱和下一步计划，确保新的会话能立刻接棒，避免重复劳动和走回头路。
使用方式非常简单。当你感觉当前会话开始“不对劲”（例如AI前后矛盾、重新讨论已确定的事、记错文件内容）或需要暂停/结束工作时，只需对AI说“创建交接”、“准备新会话”或“/handoff”等指令。AI会立即启动“创建模式”，严格遵循“反幻觉协议”：重新读取所有相关文件、运行测试命令，只将亲眼所见、亲手验证的信息写入交接文件，所有未经核实的记忆都会被打上[?]标记。
这个Skill主要面向在Claude Code中进行中大型、多步骤复杂项目开发的开发者。无论是构建新功能、重构代码库还是修复复杂Bug，只要工作无法在一次会话内完成，且对上下文连续性要求极高，就非常适合使用它。它尤其能帮助那些因上下文限制而频繁遇到AI“失忆”或“跑偏”问题的用户。
与同类“会话管理”或“笔记”工具相比，它的核心区别在于其严格的“实时验证”机制和“为AI而写”的设计哲学。它不是简单地记录用户或AI的对话历史，而是强制AI在撰写交接文件前，必须重新审视代码库的当前真实状态，从而生成一份高度可信、可操作性强、专为下一个AI会话设计的行动指南，从根本上解决了AI在长对话中基于错误记忆进行决策的问题。
核心特点
强制“实时验证”机制：在写入任何信息前，必须重新读取文件、运行命令，确保信息基于当前项目状态而非AI的模糊记忆，并明确标记未经验证的部分，这是对抗AI幻觉的核心设计。
注意事项
不适合用于一次性、简单的代码片段问答或无需跨会话延续的微小任务。
常见问题
什么时候应该使用/handoff？
当AI开始前后矛盾、重复讨论已解决的问题、记错文件内容，或你感觉会话“不对劲”时；或者当你需要暂停工作，希望下次能无缝继续时。
HANDOFF.md文件是给人看的还是给AI看的？
主要是为下一个Claude Code会话中的AI设计的，确保它能快速理解项目现状并接续工作，但开发者也可以阅读以了解项目进度。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-code-handoff-skill/raw/index.md 读取 claude-code-handoff-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-code-handoff-skill/raw/index.md（查看排版版本）