claude-handoff 技能详解：用 `claude --bg` 将当前会话无缝移交给后台 Agent

claude-handoff 技能详解用claude --bg将当前会话无缝移交给后台 Agent【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills导读本文讲解 Skills 仓库中claude-handoff这一实战技能的完整设计与用法。它解决的是 Agent 协作中最常见的一类痛点会话上下文无法跨越新开的会话窗口。读完本文你将掌握如何通过一条claude --bg命令把当前对话压缩成交接摘要并立即播种给一个全新后台 Agent让新 Agent 无需你重新解释任何背景直接接手继续工作。技能定位一次会话间的“无缝交接”claude-handoff是 Skills 仓库中位于in-progress桶Beta 阶段的一项用户调用型技能其定义文件位于 skills/in-progress/claude-handoff/SKILL.md。该桶下的技能“公开供试用、欢迎反馈但未随插件发布、没有文档页可能随时变化或消失”见 in-progress 桶说明。技能的核心定义如下摘自 frontmattername: claude-handoff description: Hand the current conversation off to a fresh background agent that picks up the work immediately. argument-hint: What will the next session be used for? disable-model-invocation: true三个元字段决定了它的调用方式与边界name技能的唯一标识也是用户在 Agent 中调用的命令名。argument-hint提示用户在调用时需要附带一个参数——描述“下一个会话要用来做什么”这个参数会被用于定制交接摘要。disable-model-invocation: true关闭模型自动调用即该技能只能由用户手动调用输入/claude-handoffAgent 不会在任务中自行触发它。这与仓库的调用机制约定一致AGENTS.md中规定SKILL.md里disable-model-invocation: true与 agents/openai.yaml 中的policy.allow_implicit_invocation: false配套使用表示“仅人类可到达”。对应地openai.yaml中display_name为Claude Handoffshort_description为Hand off to a background agent并同样将隐式调用关闭。核心工作流摘要即 Prompt一条命令完成交接claude-handoff与“把交接内容写成文档保存”的思路不同它的做法是不落盘保存而是直接把交接摘要作为 prompt 播种给一个后台 Agent。SKILL.md 中给出的核心命令是claude --bg --name descriptive name handoff summary这条命令的行为可以拆解为四个关键点--bg后台模式以后台任务方式启动一个全新的 Agent 会话而不是阻塞当前终端。命令执行后立即返回你可以继续在当前会话中工作。--name descriptive name为后台任务设置一个描述性名称如--name Fix login bug。SKILL.md 明确要求总是传入-n/--name因为这个名称会显示在任务列表、会话选择器和终端标题中是你在众多后台任务中识别它的唯一入口。handoff summary交接摘要即 prompt摘要内容直接作为新 Agent 的初始提示词新 Agent 会以“完成这项摘要所述工作”为第一指令开始行动。启动环境后台 Agent 从当前工作目录启动因此它能直接看到你正在处理的仓库、文件与上下文而用户则通过claude agents命令统一管理这些后台任务查看列表、跟踪进度、取回结果。从技能文档还可以提炼出摘要“怎么写”的三条硬性规范它们共同决定了新 Agent 能否真正做到“立即接手”规范一必须包含 “suggested skills” 段摘要中需要包含一个suggested skills建议技能小节明确指出下一个 Agent 应当调用 Skill 工具加载哪些技能。这相当于把“接下来该用什么方法论”也一并移交避免新 Agent 从零摸索工作方式。例如若交接的是一个排错任务摘要中应建议加载diagnosing-bugs若交接的是测试驱动开发任务则应建议加载tdd。规范二引用而非复制既有产物摘要不得重复规格书、计划、ADR、Issue、commit、diff 中已经记录的内容而应改为引用其路径或 URL。这样做的收益是双重的摘要保持短小精悍新 Agent 不会被冗余信息淹没同时已沉淀的细节只保留一处来源不会出现“文档与摘要各有一份、逐渐漂移”的维护负担。规范三脱敏是强制要求由于摘要将成为新 Agent 的 prompt可能被持久化、被日志记录任何敏感信息都必须先行抹除包括但不限于API Key、访问令牌、密码等凭据个人身份信息PII。交接前应像审查代码一样审查摘要中的每一句断言尤其警惕“把假设写成事实”例如“X 没构建”“Y 已完成”这类并未被会话验证的说法。新 Agent 会把摘要当作契约文本通常不会重新核查因此一个写成了事实的信念会变成后续所有工作的错误前提。参数定制argument 决定摘要的聚焦点SKILL.md 规定如果用户传入了参数则将其视为对“下一个会话将专注什么”的描述并据此调整摘要内容。也就是说摘要不是对会话的机械转储而是围绕“下一个会话要做什么”这个目标做定向压缩——推理过程、未决问题、下一步动作等与目标相关的部分要保留无关部分可以省略。与同类方案的分工/compact、/clear、handoff与 fork要真正用好claude-handoff需要先看清它与其他会话边界方案的分工。仓库中已上架的 handoff 技能 与它同源但做法不同handoff把当前会话压缩成一份交接文档写入操作系统临时目录而不是工作区供新会话读取而claude-handoff的差异恰如其文所述——“Instead of saving it, launch a background agent seeded with the summary as its prompt”即跳过落盘直接把摘要作为 prompt 启动后台 Agent。配套的文档页 docs/productivity/handoff.md 给出了四个方案的完整对照可用于理解claude-handoff的适用边界方案保留什么适用场景/compact保留你的意图压缩当前上下文、换新窗口继续同一任务/clear什么都不保留身后的一切都可丢弃时handoff写临时文件保留工作可移动性换 harness、换目录、交给同事、分叉子任务claude-handoffclaude --bg保留工作并行性同一目录下边工作边把当前上下文交给后台 Agent 立即接手三种操作都会把“主源”会话本身转化为“次源”对会话的摘要只有“继续”不产生这种转化。因此决定顺序应是能继续就继续/compact是默认动作/clear只在确定可丢弃时使用而交接类技能handoff或claude-handoff服务于“工作必须移动或并行”的场景。其中分叉fork场景最值得刻意练习你留在当前会话中继续推进同时把已累积的上下文副本交给第二个 Agent 并行工作。典型如prototype技能的使用路径——设计讨论进行到深处遇到只有运行代码才能回答的问题就可以把问题交给一个后台原型会话去验证答案拿回来后引用回原线程实现“两次跨越、一条活会话、无需重新解释”。后台 Agent 模式下你的原始会话在你回来时依然原封不动。安装与版本状态Beta 技能如何获取由于claude-handoff处于in-progress桶它不会出现在 Claude Code 插件的已发布技能列表中也不会在顶层 README 中登记。需要直接通过 skills 安装器单独安装可参照 in-progress 桶说明 给出的方式npx skillslatest add mattpocock/skills --skillclaude-handoff需要明确的前提与限制该技能处于Beta阶段作者明确表示“欢迎试用并反馈问题”它可能随时被修改或移除且没有配套的文档页AGENTS.md规定非推广桶的技能不写文档页使用前请确认你的环境支持claude --bg后台任务模式与claude agents管理命令后台 Agent 从当前工作目录启动因此请确保在目标仓库目录下调用该技能新 Agent 才能正确看到工作上下文。使用清单交接前快速自检综合 SKILL.md 与配套文档一次合格的claude-handoff交接应满足以下条件摘要只是会话的一小部分规格、Issue、diff 以路径/URL 形式出现而非复制正文脱离原始会话、冷读摘要即可知道下一步该做什么新 Agent 直接开始工作而不是反过来向你追问设置细节摘要中的 “suggested skills” 段命中了你自己会为这个任务选择的技能摘要在通过claude --bg传参时未因反引号或$(...)等 shell 元字符而被破坏——若摘要包含此类字符优先通过文件路径引用而不是把摘要直接插进命令行摘要中不包含任何 key、token 或密码交接完成后用claude agents确认后台任务已按预期名称启动并开始运行。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考