任务交接
在 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 形成任务链，支持追溯
- 状态变更要及时更新