用途
Handoff 用于在暂停、恢复或转交工作时保存状态。它面向的是一个以全新上下文开始工作的下一个接收方，因此交接包必须携带足够的事实依据，使接手方无需猜测即可继续。典型触发场景包括：需要暂停稍后继续、把工作交给 QA 或另一个智能体。
主要能力
-
确定交接对象：推断接收方是同一智能体稍后继续、另一编码智能体、审核者、QA 还是人类。若用户提供了参数，则将其视为下一会话的重点。只有当接收方或目的会改变需要记录的内容时，才提一个问题。
-
盘点当前状态：只收集持久事实，包括原始目标与最新用户请求、当前仓库/分支/环境与相关路径、创建/编辑/有意未改动的文件、已运行命令与测试及观察到的输出、仍在运行的命令、已做决策与被否决方案及原因、已知阻塞、风险、假设、密钥、凭证与外部依赖。优先使用产物引用（路径、URL、issue ID、提交哈希、命令名、简短证据引用）而非粘贴大量内容；若某命令挂起或失败，如实记录该事实而非编造状态。
-
保护敏感信息：对凭证、令牌、密码、私人个人数据和会话 Cookie 进行脱敏，替换为如
[REDACTED_API_TOKEN]的标签，并说明下一个智能体应到哪里安全获取。 -
编写后续计划：把剩余工作转为有序步骤，每步包含存在原因、需检查或编辑的具体文件或系统、已知需运行的命令、完成标准、副作用或回滚顾虑。任务应小到可逐一完成或验证。
-
保存交接包：选择最持久的合适位置——若工作区有文档约定则遵循；否则若在仓库中，保存到
docs/handoffs/<YYYY-MM-DD-HHMM>-<topic>.md；再否则保存到操作系统临时目录并以相同时间戳和主题命名。链接到已有的 PRD、计划、ADR、工单、diff 和提交，仅总结重启所需的关键内容。 -
执行恢复检查：以“下一个智能体”的视角阅读交接包，并对照恢复检查清单核对。
使用方式
交接包采用固定结构（除非仓库已有更严格的格式），包含：任务或工单标题、生成时间与时区、接收方、重点、状态；目标；当前状态（工作区、分支或版本、活动服务或会话、重要产物）；已完成工作；决策（含被否决的替代方案）；文件与改动（含相关但未触碰的文件）；命令与证据；剩余计划（每步含原因、位置、命令、完成条件、风险）；验证计划；风险与假设；建议使用的技能；可直接粘贴的恢复提示；脱敏说明。
完成前需通过“恢复检查”：目标与最新请求清晰；已完成工作和当前状态有证据支撑而非猜测；每个修改过的文件都有理由；明确列出下一个智能体不得触碰的文件和区域；所有运行中的命令、服务器或外部依赖均有交代；剩余计划有序、以确切的下一步行动开头且每步有完成标准；验证计划给出确切命令或具体人工检查；风险、假设与脱敏情况明确；恢复提示可直接粘贴。任何一项不通过则修订交接包。
最终响应应简短，仅包含：保存的交接包路径、建议的第一个下一步行动、对交接包所做的验证。交接包本身才是持久产物。
适用场景
需要中途暂停并在稍后恢复同一任务；把工作移交给另一个编码智能体、审核者、QA 或人类同事；需要在会话结束时留下可验证、可执行的继续计划。
限制
该工具仅记录和整理事实状态，不自动执行后续任务；交接质量取决于记录的事实是否准确。工具明确要求不得编造状态，命令挂起或失败须如实记录。敏感信息必须脱敏处理。具体的技能调用命令、安装方式与平台支持信息暂未提供。