什么是A cross-session handoff protocol for Claude Code and other AI agents. handoff is not a summarization tool. It's a protocol for freezing your work context, packaging it, and resuming execution — in any session, any agent, any device.
Handoff Protocol V2 是一个专为 Claude Code 及其他 AI 代理设计的跨会话交接协议，其核心目标并非总结或压缩上下文，而是建立一套标准化的‘冻结现场→封装状态→恢复执行’流程。该协议通过一个结构化的交接包（handoff.md）作为唯一载体，确保在任意新会话、新设备或不同 AI 代理之间无缝衔接工作流。用户只需通过简单指令触发协议，即可将当前任务现场打包保存，并在后续会话中快速恢复，从而彻底解决因上下文过长、会话中断或需要切换工作环境而导致的重复沟通与效率损失问题。 协议的实现依赖于一个位于 `~/.agents/handoff_context/` 目录下的标准化文件结构，每个交接实例对应唯一的 handoff ID 并包含完整的上下文快照。整个流程强调最小可执行性：交接包仅保留‘继续执行所需的最小状态’，剔除所有过程性叙述和冗余讨论，聚焦于事实、结论与动作。这种设计使得交接文档不仅易于生成，更易于被下一轮会话准确理解与执行，避免了传统总结方式带来的信息稀释和语义偏差。 从使用体验上看，Handoff Protocol 提供了三种核心交互模式：`handoff out` 用于主动保存当前工作现场；`handoff in ` 用于读取并恢复指定或最新的交接包，并经过用户确认后才执行下一步；`handoff list` 则帮助用户浏览历史交接记录，便于回溯与管理。整个协议严格遵循‘不追问背景、不重新收集信息、不在未授权时自动执行’的原则，保障了用户对工作流的完全控制权，同时极大提升了多会话协作的连续性与可靠性。
核心功能特点
- 基于结构化交接包（handoff.md）实现跨会话、跨设备、跨代理的无缝工作流延续
- 采用八槽位标准模板（当前任务/状态/已完成/关键决策/约束/文件/下一步/阻塞项），确保信息完整且聚焦可执行性
- 支持三种核心操作：`out` 冻结现场、`in` 恢复预览并确认执行、`list` 管理历史交接记录
- 强制压缩机制与长度控制（建议120行内），避免交接文档臃肿失焦，保持高信息密度
- 恢复阶段提供3-5条关键摘要，明确下一步动作，需用户显式同意后方可继续执行
适用场景
Handoff Protocol V2 特别适合那些需要频繁中断、重启或转移工作流的复杂开发场景。例如，当开发者正在处理一个大型功能模块，中途因会议、优先级调整或其他任务插入而被迫暂停时，可通过 `handoff out` 将当前进度、已验证方案、待修复问题和关键依赖文件打包封存。数小时后或在另一台设备上重新接入时，仅需执行 `handoff in latest` 即可立即恢复至精确断点，无需重复解释背景或重新梳理逻辑，显著减少认知负担与返工成本。 该协议尤其适用于团队协作环境，如前后端联调、代码审查流转或跨职能评审等场景。当某位工程师完成前端接口对接后，可将当前状态通过 handoff 移交后端同事继续集成测试；反之亦然。由于交接包明确标注了‘关键文件’与‘下一步’，接收方能迅速定位到具体代码段并直接动手修改，极大缩短协作链条中的等待时间。此外，对于长期维护项目或知识密集型任务（如架构重构、技术债务清理），定期使用 handoff 能有效沉淀阶段性成果与决策依据，形成可追溯的工作脉络。 在日常编程实践中，任何涉及多轮迭代、反复调试或需要临时委托给其他工具/代理的任务都适合应用此协议。比如使用 Claude Code 编写脚本时遇到复杂正则表达式难以一次性成型，可先 handoff 保存当前尝试版本与失败案例；切换到 Copilot 或本地 LLM 后，再 handoff in 恢复上下文，继续优化匹配规则。这种机制打破了单一工具的局限性，让不同 AI 代理成为接力棒而非孤立节点，真正实现‘一人多机、多机协同’的高效智能开发生态。