handoff-skill
SKILL.md
任务交接
在 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 形成任务链,支持追溯
- 状态变更要及时更新
Weekly Installs
2
Repository
maxoreric/sop-engineInstalled on
opencode2
codex2
claude-code2
antigravity2
gemini-cli2
windsurf1