全部技能 / 基础工具与工作流 / claude-handoff
基础工具与工作流 · mattpocock/skills

claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

风险提醒：蓝色 · 知晓即可AI 侦查报告
作者 mattpocockGitHub mattpocock/skills ↗Stars 257659许可 MIT（GitHub API spdx MIT；仓库根 LICENSE: Copyright (c) 2026 Matt Pocock）commit 3cca18b368
agent 宿主通常会约束 skill 执行权限；风险提醒为 AI 侦查观点，不构成质量或安全保证。第三方 skill 仅作拆解与展示，安装使用风险自负，版权归原作者。

1实现原理 · 为什么它能做到

核心动作是不落盘直启后台 agent：把当前会话压缩成交接摘要后，直接以摘要为 prompt 调 `claude --bg` 启动新 agent，而非像稳定版 handoff 那样写交接文档。

skills/in-progress/claude-handoff/SKILL.md
Write a handoff summary of the current conversation so a fresh agent can continue the work. Instead of saving it, launch a background agent seeded with the summary as its prompt: `claude --bg --name "<descriptive name>" "<handoff summary>"`. It starts in the current working directory and returns immediately; the user manages it with `claude agents`.
注：这里在做什么：'Instead of saving it' 一句话把本 skill 与 productivity/handoff（写文档交接）区分开——交接物从文件变成进程。

摘要内容纪律：必须带 suggested skills 段、用 path/URL 引用已有工件而非复制、并对敏感信息脱敏——因为摘要会成为新 agent 的 prompt。

skills/in-progress/claude-handoff/SKILL.md
Include a "suggested skills" section in the summary, naming which skills the next agent should call the Skill tool for.
注：脱敏指令原文：'Redact any sensitive information, such as API keys, passwords, or personally identifiable information, since the summary becomes the agent's prompt.'——模型写的摘要直接变成另一个 agent 的指令，故 redaction 是安全关键步骤。

仅用户显式触发：frontmatter 带 disable-model-invocation: true，Codex 清单以 policy.allow_implicit_invocation: false 配对；argument-hint 在触发时向用户要『下一会话用途』。

skills/in-progress/claude-handoff/SKILL.md
argument-hint: "What will the next session be used for?"
注：argument-hint 是 Claude Code 的用户输入提示；用户给的方向会进摘要（'If the user passed arguments, treat them as a description of what the next session will focus on and tailor the summary accordingly.'）。

命名纪律：必须传 -n/--name 描述性名称，用于作业列表/会话选择器/终端标题的展示。

skills/in-progress/claude-handoff/SKILL.md
Always pass `-n`/`--name` with a descriptive name (e.g. `--name "Fix login bug"`); it sets the display name shown in the job list, session picker, and terminal title.
注：面向 Claude Code 宿主的 CLI 参数约定；也说明本 skill 强依赖 Claude Code（`claude` 命令 + `claude agents` 管理界面）。

2核心能力

01一条命令把当前会话续给全新后台 agent（claude --bg，立即返回）
02按用户参数定向下一会话重点并裁剪摘要
03在摘要里推荐下一 agent 该调的 skills
04以 path/URL 引用既有工件（specs/plans/ADRs/issues/commits/diffs）避免重复内容
05摘要脱敏：redact API keys/密码/PII 后才交给新 agent

3外部依赖

类型依赖
cliclaude (Claude Code CLI)

4风险提醒 风险提醒：蓝色 · 知晓即可

风险提醒：蓝色 · 知晓即可
  • 摘要 = 新 agent 的 prompt，跨会话注入/泄漏通道 — 会话中粘贴的不可信内容可能被改写进摘要传给全新 agent；密钥/PII 若脱敏不彻底会进入新 agent 上下文与日志。属 prompt 级风险，需宿主与用户留意。
  • 命令拼装注入面 — 摘要作为参数拼进 claude --bg 命令行；若宿主经 shell 执行且模型未转义引号/元字符，理论上可注出命令。skill 未给出转义/参数化指令，实际取决于宿主执行方式。
  • 强依赖 Claude Code — claude --bg、claude agents、argument-hint 均为 Claude Code 专有；Codex 侧安装此 skill 无法执行其核心动作。
  • beta 状态：可随时变化或消失 — 位于 in-progress bucket：不入 plugin、无 docs 页、README 明示 'they can change or disappear without warning'。依赖它的工作流应知道升级可能破坏接口。
风险提醒：蓝色，知晓即可。调用的是本地官方 CLI（claude --bg）把会话交接给后台 agent：skill 自身无网络外发、无凭证读取指令、不落盘。注意点：① 摘要会成为新 agent 的完整 prompt，脱敏与注入面需留意（会话中不可信内容可能跨会话传播）；② 后台 agent 以宿主工具权限在 cwd 继续执行，能做的操作 = 宿主给它的权限；③ 强依赖 Claude Code，跨宿主意义有限。均属可预期的本地工具使用，无代码级危险面。

5第二遍独立确认

  • [ok] claude --bg 调用点真实存在 — SKILL.md 正文逐字含 ``claude --bg --name "<descriptive name>" "<handoff summary>"``，且是唯一 CLI 调用指令。
  • [ok] user-invoked 双清单（disable-model-invocation + allow_implicit_invocation: false） — 两 manifest 均存在且取值正确；in-progress README 亦标 User-invoked。
  • [ok] 不落盘 vs productivity/handoff 写文档 — 原文 'Instead of saving it, launch a background agent' 明确；productivity/handoff/SKILL.md 存在且为写文档实现，两 skill 并存无冲突。
  • [ok] suggested skills / 引用不复制 / 脱敏三段纪律 — 三段原文均在 SKILL.md（'suggested skills'、'Reference them by path or URL instead'、'Redact any sensitive information…'）。
  • [ok] argument-hint 存在 — frontmatter 含 argument-hint: "What will the next session be used for?"，且正文有对应的定向裁剪指令。
  • [ok] 无外部网络端点/凭证读取 — token 扫描零网络命中；无 env/keychain/文件凭证读取指令。claude --bg 为本地 CLI。
  • [ok] 命令注入面（安全反例检查） — 确认注入面真实存在（摘要进命令行 + 进新 agent prompt），已在 security.injection_surface 与 verdict.risks 显式记录；skill 自身无转义指令属宿主/模型责任，如实标注而非回避。
  • [ok] 元数据 — GitHub API：MIT、257659 stars、pushed_at 2026-09-04T08:45:43Z；本地 HEAD == 3cca18b。license 归属仓库根 LICENSE。

6结论

  • 零中间态交接：不写文件、一条命令把续作直接变成运行中的后台 agent，适合『换会话继续干』。
  • 摘要即质量的把关点：内置 suggested skills、引用而非复制、脱敏三条纪律，控制新 agent 冷启动质量与信息泄漏。
  • 保留用户编辑痕迹与工件单一来源：不复制 specs/ADRs/diffs 内容，避免双份真相。
    • 适合：适合 Claude Code 用户遇到『当前会话上下文太满/需要换主题继续同一任务』时，把会话续给一个后台 agent（由 claude agents 管理），尤其是工作已部分落盘到 specs/commits、摘要可以引用而非搬运的场景。
    不适合：不适合 Codex 等非 Claude Code 宿主（命令不可执行）；不适合需要留下可审阅交接文档的团队流程（应选会写文档的 productivity/handoff）；不适合会话里充满密钥/高度敏感信息且宿主无隔离的场合（脱敏依赖模型自觉）。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-09
    方式 A · 人下载镜像包下载 claude-handoff.tar.gz
    sha256: 09e04d39f394ef5b…
    方式 B · JSON 格式安装指南，复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗
    本页镜像锁定 commit 3cca18b368；上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库mattpocock / mattpocock/skills
    原始 GitHubmattpocock/skills ↗
    Stars257659
    最近推送2026-09-04
    本 skill commit3cca18b368
    许可MIT（GitHub API spdx MIT；仓库根 LICENSE: Copyright (c) 2026 Matt Pocock）
    本站信息
    收录日期2026-09-06
    分类基础工具与工作流
    侦查报告2026-09-06 · 2 遍
    本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。