Claude-skill-registry handoff-skill
Agent 间任务交接的 Skill。当需要把任务交给另一个 Agent 时触发。触发词:交接、handoff、交给、让 xxx 来处理。
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/handoff-skill" ~/.claude/skills/majiayu000-claude-skill-registry-handoff-skill && rm -rf "$T"
manifest:
skills/data/handoff-skill/SKILL.mdsource content
任务交接
在 Agent 之间传递任务,参考邮件协议设计。
概念
| 邮件概念 | handoff 对应 |
|---|---|
| From / To | 发送方 / 接收方 Agent |
| Subject | 任务主题 |
| Date | 时间戳 |
| Message-ID | task-id(唯一标识) |
| References | 上游任务(链式追溯) |
| Body | 任务描述 |
| Attachments | inputs/ 目录 |
流程
发送方
- 创建 task-id - 格式:
{timestamp}-{random} - 准备输入文件 - 复制到 inputs/
- 写 context.md - 填写 Header 和 Body
- 设置状态 - Status: pending
- 通知接收方 - 告知 task-id
接收方
- 读取 context.md - 理解任务
- 更新状态 - Status: in_progress
- 执行任务 - 根据 Body 描述执行
- 写入产出 - 放到 outputs/
- 更新状态 - Status: completed / failed
目录结构
agents/<agent-name>/handoff/<task-id>/ ├── context.md # 任务上下文(严格格式) ├── inputs/ # 输入文件 └── outputs/ # 输出文件
context.md 格式
# Handoff ## Header - Message-ID: 20240101-abc123 - From: researcher-agent - To: writer-agent - Date: 2024-01-01T12:00:00Z - Subject: 撰写调研报告 - References: 20231231-xyz789 ## Body 请根据调研结果撰写一份报告,要求: 1. 结构清晰 2. 重点突出 3. 包含结论和建议 ## Attachments - inputs/research.md - inputs/data.json ## Status pending
Status 状态
- 等待接收方处理pending
- 接收方正在处理in_progress
- 已完成completed
- 失败failed
原则
- context.md 格式严格,Hook 要读取
- inputs/ 和 outputs/ 内容自由
- References 形成任务链,支持追溯
- 状态变更要及时更新