使用 claude-handoff 交接 Claude Code 会话的方法
機械翻訳 / Machine-translated
原文链接:使用 claude-handoff 交接 Claude Code 会话的方法(cccskills)
技能页面:claude-handoff
本文结论
安装 claude-handoff 后,可以将 Claude Code 当前的会话汇总为摘要,并将后续任务交给新的后台 Agent 继续处理。
这是一个适合长时间持续作业的技能,交接目标与当前工作目录相同。
以下将介绍调用时的运行机制、如何聚焦目标进行交接、安装方法及注意事项。
调用 claude-handoff 后,当前会话将被整理为用于交接的摘要。
新 Agent 会将该摘要作为初始指令接收,并在后台开始运行。
交接目标的启动位置为当前工作目录,因此可以直接从相同的仓库或文件夹继续作业。
/claude-handoff 下一个会话专注于修复登录故障
发送此请求后,Agent 会先汇总至此为止的会话内容,并以文件形式保存到系统临时目录。
接下来通过 claude --bg 启动后台 Agent,并将摘要文件的内容作为初始指令传入。
由于启动命令会立即返回,原会话不会因此等待。
新 Agent 会被赋予一个含义清晰的名称,例如"Fix login bug"。
名称会显示在任务列表、会话选择界面以及终端标题中。
已启动的 Agent 统一通过 claude agents 进行管理。
使用 claude-handoff,从汇总会话到启动下一个 Agent,只需一次调用即可完成。
无需自行撰写摘要并粘贴到新会话。
主要功能有以下四项。
将冗长会话的经过整理为新 Agent 可以接续作业的形式。
摘要通过文件传递给启动命令。
因此即使摘要中包含反引号或 $ 符号,Shell 也不会执行或展开它们。
调用时附加参数,该参数将作为下一个会话的目标。
若附注"修复登录故障",摘要也会按照该作业内容撰写。
在已明确下一步要做什么的场景中,可以避免带入多余的历史背景,这是其优势所在。
规格文档、计划、ADR(设计决策记录)、Issue、提交记录、差异内容不会直接写入摘要。
而是通过路径或 URL 引用,避免相同信息重复出现。
摘要中还包含"suggested skills"章节,列出下一个 Agent 应调用的技能。
摘要将直接作为下一个 Agent 的指令。
因此,API 密钥、密码及可识别个人身份的信息,均规定不得写入摘要。
安装方式有两种:执行一行命令,或委托 Agent 安装。
通过命令安装时,执行以下一行即可。
可在执行时选择安装目标,如 Claude Code 或 Codex 等。
npx skills add https://github.com/mattpocock/skills --skill claude-handoff
委托 Agent 安装时,请直接发送以下内容。
流程为先确认内容,再进行配置。
请安装以下 Agent Skill。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/claude-handoff
请先确认 SKILL.md 及附属文件的内容,确认不存在可疑操作(如向外部发送数据、读取认证信息等),然后将其配置到 Claude Code 的 ~/.claude/skills/claude-handoff/,或 Codex 的 ~/.agents/skills/claude-handoff/。
手动配置时的存放位置如下表所示。
| 安装目标 | 全项目通用 | 单项目专用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 项目的 .claude/skills/ |
| Codex | ~/.agents/skills/ | 项目的 .agents/skills/ |
发布来源为 GitHub 的 mattpocock/skills,Star 数为 320478。
claude-handoff 位于该仓库的 in-progress 文件夹中。
由于该设置不会被 Agent 自动调用,使用时请通过名称指定 /claude-handoff。
基本用法是在作业的节点处调用 /claude-handoff。
若已明确下一步目标,请作为参数附上。
/claude-handoff
不带参数调用时,会生成当前会话的摘要。
新 Agent 将以该摘要为指令,在相同工作目录的后台启动。
/claude-handoff 请交接,让新会话专注于修复登录界面的故障
附上目标后,摘要将围绕该作业内容生成。
交接目标会被赋予与作业内容相关的名称,便于在任务列表中与其他 Agent 区分。
/claude-handoff 按照 docs/plan.md 中的计划推进实现
若计划已保存为文件,摘要不会复制其内容,而是通过路径引用。
新 Agent 以摘要和计划文件为线索,在相同工作目录中继续作业。
前提条件是需要能够通过 claude --bg 启动后台 Agent 的 Claude Code 环境。
交接目标的启动需要使用 claude 命令。
即使配置到 Codex,也必须有该命令可运行的环境。
建议在交接前,将已确定的规格或计划以文件或 Issue 的形式整理好。
这样摘要便会通过路径或 URL 引用这些内容。
此外,摘要本身的保存位置为系统临时目录。
技能中已包含排除敏感信息的指令。
即便如此,若会话中涉及了 API 密钥或密码,调用时附注"敏感信息不要写入摘要"会更为稳妥。
许可证为 MIT。
安装前请阅读 SKILL.md,确认不存在向外部发送数据或读取认证信息的操作。
同一 mattpocock/skills 仓库中,还有一些适合在分阶段推进长期作业时组合使用的技能。
chief-of-staff 是一个面向长期目标、协调多个子 Agent 作业的技能。
它在与用户持续交互的同时,也推动作业环境和规范的改进。
适合希望以比逐一交接更大的单位统筹整体作业的场景。
ask-matt 可以推荐适合当前情况的相关技能及其使用顺序。
当不确定应让下一个 Agent 使用哪个技能时,可以向其咨询。
由于启动命令会立即返回,原会话可以继续使用。
新 Agent 在后台运行,通过 claude agents 进行管理。
可在 claude agents 中查看。
启动时赋予的名称会显示在任务列表、会话选择界面以及终端标题中。
即使同时运行多个 Agent 也能加以区分。
将其配置到 Codex 的存放位置本身是可以的。
但由于交接目标的启动需要使用 claude --bg,因此必须有 Claude Code 命令可运行的环境。
技能中包含排除 API 密钥、密码及可识别个人身份信息的指令。
不过,摘要会成为下一个 Agent 的指令。
对于涉及敏感信息的会话,调用时附注"请排除"会更为稳妥。
claude-handoff 是一个将冗长的 Claude Code 会话汇总为摘要,并将后续任务交给新后台 Agent 的技能。
交接目标在相同工作目录下以清晰易懂的名称启动。
附上下一步目标后,摘要的重点更加集中,规格文档和计划通过路径或 URL 引用。
希望分阶段推进长期作业的用户,请从 cccskills 页面开始体验。
本文转载自 cccskills 的文章「使用 claude-handoff 交接 Claude Code 会话的方法」。
技能详情及安装方法请参阅 cccskills 的 claude-handoff 页面。