Skill Learning

claude-handoff

1. Bilingual SKILL.md

左右滑动可直接切换英文版与中文版；两种语言按段落自动对齐。英文中的蓝色虚线词语可点击查看解释。共标记 10 处。

Write a handoff summary of the current conversation so a fresh agent can continue the work. Instead of saving it, launch a background agent : `claude --bg --name "<descriptive name>" "<handoff summary>"`. It starts in the current working directory and ; the user manages it with `claude agents`.

Always pass `-n`/`--name` with (e.g. `--name "Fix login bug"`); it sets the display name shown in the job list, session picker, and terminal title.

Include a "" section in the summary, naming which skills the next agent should call the Skill tool for.

in other artifacts (specs, plans, ADRs, issues, commits, diffs). .

, such as API keys, passwords, or personally identifiable information, since the summary becomes the agent's prompt.

If the user passed arguments, treat them as a description of what the next session will focus on and .

Source metadata

--- name: claude-handoff description: Hand the current conversation off to that . argument-hint: "What will the next session be used for?" disable-model-invocation: true ---

为当前对话编写一份交接摘要，让一个全新的智能体能够继续这项工作。不要保存摘要，而是启动一个后台智能体，并把摘要作为它的提示词：`claude --bg --name "<描述性名称>" "<交接摘要>"`。它会在当前工作目录中启动并立即返回；用户通过 `claude agents` 管理它。

始终使用 `-n`/`--name` 传入一个描述性名称（例如 `--name "Fix login bug"`）；它会设置任务列表、会话选择器和终端标题中显示的名称。

在摘要中加入一个“建议使用的技能”章节，列出下一个智能体应通过 Skill 工具调用哪些技能。

不要重复已经记录在其他制品中的内容（规格、计划、ADR、issue、commit、diff）。改为通过路径或 URL 引用它们。

删去任何敏感信息，例如 API 密钥、密码或个人身份信息，因为这份摘要将成为智能体的提示词。

如果用户传入了参数，把它们视为对下一个会话重点的描述，并据此定制摘要。

Source metadata

--- name: claude-handoff description: 将当前对话交接给一个全新的后台智能体，让它立即接手工作。 argument-hint: "下一个会话将用于什么？" disable-model-invocation: true ---

Entry SHA-256: 6738e8b7c7899ea0038fb7a5c859ca1b90c7b1eb40123dcdbe94c51b5b119f12

2. Why This Skill Is Clever

一句话核心机制

它把当前会话压缩成一份去重、脱敏、目标明确的交接提示词，并立即用这份提示词启动一个具名后台智能体，让“写交接文档”直接变成“启动下一位执行者”。

触发与边界

直接来源： disable-model-invocation: true 明确要求由用户主动调用；argument-hint 把可选参数限定为“下一个会话将用于什么”。这不是一般性的对话总结技能，而是面向 Claude 后台智能体的即时移交操作。

支持背景： agents/openai.yaml 同样设置 allow_implicit_invocation: false；skills/in-progress/README.md 将它标为 beta、user-invoked，并说明 in-progress 技能不随插件发布、可能随时变化。

解释： 命令、claude agents 管理方式和后台任务语义依赖 Claude CLI harness。没有 claude --bg、不允许创建后台进程，或需要人工批准外部执行的环境，不能原样移植。

信息架构 / 执行顺序

提炼连续性：总结当前目标、已完成进度、剩余任务和关键决策，让没有历史上下文的新智能体能继续工作。
复用既有事实：规格、计划、ADR、issue、commit 和 diff 只通过路径或 URL 引用，避免复制后产生漂移。
保留能力导航：加入 suggested skills，告诉接手者应显式加载哪些工作流，而不假定技能已经自动继承。
先过安全边界：在摘要进入新提示词前删去密钥、密码和个人身份信息。
把意图变成异步执行：使用描述性名称运行 claude --bg；当前命令立即返回，用户再通过 claude agents 管理后台会话。

最巧妙的设计点

1. 交接不是文件，而是可运行的下一会话

“Instead of saving it, launch a background agent”

直接来源： 技能省掉“保存摘要 → 用户另开会话 → 粘贴摘要”三段人工操作。摘要既是交接文档，也是新智能体的启动输入，减少交接停顿和复制错误。

2. 以引用维持单一事实源

“Do not duplicate content already captured in other artifacts”

直接来源： 对规格、计划、ADR、issue、commit 和 diff 使用引用而不是复制。这样交接摘要只负责导航与状态，不与长期制品竞争事实所有权。

3. 显式传递“该用什么能力”

“Include a \"suggested skills\" section”

直接来源： 新会话可能拿到任务事实，却不知道原会话依赖的工作流。单独列出建议技能，把“上下文连续性”扩展为“执行方法连续性”，同时仍要求接手者通过 Skill 工具显式调用。

4. 把提示词视为新的数据边界

“Redact any sensitive information ... since the summary becomes the agent's prompt.”

直接来源： 技能不是泛泛提醒保密，而是给出因果关系：摘要将跨入另一个智能体的提示词上下文，因此必须在边界之前脱敏。这让安全检查落在具体的数据流位置上。

5. 用户参数用于聚焦，而不是原样附加

“tailor the summary accordingly”

直接来源： 参数描述下一个会话的用途。技能要求据此重排和取舍摘要，使接手者优先看到下一阶段所需的信息，而不是把参数当作一段无结构备注。

防失败机制与 trade-off

明确不变量： 启动命令必须有描述性 --name；摘要必须包含 suggested skills；已有制品只引用不复制；敏感信息必须删去；若用户提供参数，摘要必须围绕该重点定制。disable-model-invocation 与 supporting policy 共同阻止隐式触发有副作用的后台会话。

权衡与风险： 摘要压缩必然可能遗漏隐含决策，过度依赖路径又要求新智能体拥有相同工作目录和读取权限。命令“立即返回”只证明任务已提交，不证明后台工作成功，后续仍需从 claude agents 查看状态。描述性名称改善可观察性，但不能替代唯一任务 ID。该技能还没有规定摘要的固定字段、启动失败处理、最大长度或完成验收，所以 beta 阶段的不同执行者可能产出质量差异较大的交接。

可迁移原则

把交接输出直接连接到下一步执行入口，减少人工搬运。
让长期制品继续做事实源，交接只记录增量状态与导航。
同时传递“做什么”和“用哪些工作流做”，避免方法断层。
在上下文跨边界之前脱敏，而不是等新会话启动后补救。
对有副作用的会话创建采用显式用户触发、可读名称和可观察的管理入口。

今日实践题

如果当前会话已经有一份完整规格 docs/payment-spec.md，而用户说下一会话专门负责实现支付重试，你会在交接摘要中引用什么、补充哪类增量状态，又会如何命名后台智能体？

Evidence note

启动命令、描述性名称、建议技能、制品去重、脱敏和参数聚焦都来自所选 SKILL.md。beta 与不随插件发布的身份来自 skills/in-progress/README.md，隐式调用策略来自 agents/openai.yaml，两者只作为支持背景。关于单一事实源、数据边界、可观察性和可移植性的判断属于设计解释。

Source & provenance

Repository path: skills/in-progress/claude-handoff/SKILL.md
Generated: 2026-08-28 14:26 Asia/Shanghai
Upstream commit: 6654f6b60cd9d5be8b54c6fafe44346dabeb3b76
Source: View on GitHub