Claude Handoff - 把当前会话交接给后台智能体

技能概述

Claude Handoff 是一个 Claude Code 斜杠命令：它把当前对话整理成一份交接摘要，并立刻用这份摘要启动一个后台智能体，让新会话接着把活干完，而不是等你重新解释一遍上下文。

适用场景

1. 上下文快满了，任务还没做完：当前会话的上下文窗口即将耗尽，与其硬撑着继续，不如把目标、进度和待办交给一个全新的后台智能体，它带着干净的上下文接着做。
2. 想并行推进多件事：前台会话继续讨论方案或排查问题，同时把已经明确的重构、迁移、批量修改交给后台跑，两边互不阻塞。
3. 跨时间、跨终端接着干：下班前把没做完的任务交接出去，第二天换一台机器再打开会话列表看结果，不用重新复述需求。

核心功能

1. 生成结构化交接摘要：梳理当前对话里真正需要传递的信息——任务目标、已完成的部分、还没做的部分、关键文件路径、已排除的方案。摘要不是简单复述聊天记录，而是给下一个智能体的行动说明。
2. 一条命令启动后台智能体：直接执行 claude --bg --name "<任务名>" "<交接摘要>"，后台智能体在当前工作目录启动并立即返回，不占用当前终端。命令强制要求配合 -n/--name 传入描述性名称，这个名字会出现在任务列表、会话选择器和终端标题里，方便你之后用 claude agents 管理。
3. 交接内容的安全与聚焦：摘要里会附上"建议技能"一节，指明下一个智能体该调用哪些 Skill；同时要求不重复已有制品的内容（规格、计划、ADR、issue、commit、diff 只引用路径或链接），并对 API key、密码、个人信息等敏感数据做脱敏——因为摘要本身就会成为那个智能体的 prompt。

常见问题

Claude Handoff 会把交接摘要保存成文件吗？

不会。摘要不会落盘，而是直接作为 prompt 传给后台智能体。所以如果你之后想回溯"当时交代了什么"，需要在任务列表里看那个会话本身。

后台智能体在哪里运行，我怎么看进度？

它在你当前的工作目录启动，然后立刻返回，不会卡住当前终端。之后用 claude agents 查看和管理所有后台任务，包括重命名、切换和终止。

交接摘要里可以写 API key 或密码吗？

不可以。摘要会成为新智能体的 prompt，任何写进去的密钥、密码、个人信息都会随之进入这个会话。交接前务必脱敏，改用占位符或指向本机密钥管理方式。

使用边界

• 这是手动触发的命令（disable-model-invocation: true），Claude 不会自行调用它，需要你主动输入 /claude-handoff。
• 依赖本机已安装并登录的 claude CLI；--bg、claude agents 都是 CLI 提供的能力。
• 命令支持传入参数，用来描述下一个会话的重点，摘要会据此调整侧重；不传参数时按当前对话的整体目标来写。