薪尽火传 · Agent Relay
换 Agent,不断档。Memory Hub 是内部存储层;Relay 才是产品层。
强制首步
触发本 Skill 后,先读取 Relay Context,不要先扫描项目目录、Skill 文件或 Home 目录:
- 优先调用 MCP 工具
relay_context,参数为当前项目路径和当前 Agent 名。 - MCP 不可用时运行
agent-relay context --agent <name> --project "$PWD"。 - 只有 Context 指向具体产物后,才打开这些产物做现场验证。
不要用 find /、全量目录扫描或原始会话日志代替 Relay Context。
动作选择
| 用户意图 | 动作 |
|---|---|
| “继续”“接着做”“看看其他 Agent 做了什么” | context 或 resume --no-mark,检查 inbox |
| “交给 Codex/Claude/TRAE” | offer |
| 接棒开始做 | accept |
| 长任务仍在进行 | heartbeat |
| 做完并附证据 | complete |
| 交棒方确认完成 | verify |
| 无法继续 | fail 或 reject |
| 取消接力 | cancel |
| 一般阶段记录 | capture |
使用 agent-relay 命令;旧 memory-hub 仅为兼容入口。
接棒
- 读取当前项目与待接棒队列。
- 打开交棒方引用的真实产物。
- 产物缺失或已变化时,不要直接接棒;先说明差异。
- 确认可执行后
accept。 - 不要求用户复述 Hub 已记录的背景。
agent-relay context --agent codex --project "$PWD"
agent-relay inbox --agent codex --project "$PWD"
agent-relay accept \
--relay relay-xxxx \
--agent codex \
--summary "已核对输入产物,开始接棒"
在只读沙箱里先运行:
agent-relay resume --agent codex --project "$PWD" --no-mark
交棒
交棒必须包含明确验收标准。提供真实产物路径或可复核来源;不要只写“已经完成”。
agent-relay offer \
--project "$PWD" \
--from-agent trae \
--to-agent codex \
--summary "实现完成,交给 Codex 做边界验证" \
--acceptance "测试全部通过" \
--acceptance "不存在敏感信息" \
--artifact "/path/to/implementation" \
--source-ref "test: integration suite passed" \
--priority high
默认交棒 7 天未接收自动过期;接棒后默认租约 1 小时。长任务定期续租:
agent-relay heartbeat \
--relay relay-xxxx \
--agent codex \
--summary "边界测试进行中"
完成与验收
接棒方完成时必须附证据:
agent-relay complete \
--relay relay-xxxx \
--agent codex \
--summary "边界验证完成" \
--artifact "/path/to/test-results.json"
验收方逐条确认标准并核对产物:
agent-relay verify \
--relay relay-xxxx \
--agent trae \
--summary "产物和验收标准均已确认" \
--accept-all-criteria
completed 还不算闭环,只有 verified 才算一棒完成。
记录边界
- 不保存整段聊天、密码、token、API Key 或未筛选隐私数据。
- 不把猜测写成事实;不修改旧事件,追加纠正记录。
- 单 Agent、单轮、无后续价值的任务不写 Relay。
- Relay 不替代 Git、业务版本控制或多人同时编辑的文件锁。
- 真实环境验证优先于记忆内容。
完整状态机、依赖链、产物指纹、冲突与隐私规则见 references/protocol.md。