| name | agent-relay |
| description | 薪尽火传 / Agent Relay：让 Codex、TRAE CLI、Claude Code、Cursor 等不同 AI Agent 在同一项目上可靠接棒，携带经过验证的状态、决定、产物、阻塞、验收标准和下一步继续工作。用户提到切换 Agent、继续另一个 Agent 的工作、跨 Agent 接力、交棒/接棒、检查其他 Agent 新进展、限额或中断恢复、并行协作、共享项目上下文、handoff、relay、接力棒时使用。 |
薪尽火传 · Agent Relay
首步：检查安装与状态边界
新环境先运行 python3 scripts/doctor.py --json。它只检查代码，不触碰
~/.agent-relay。涉及真实项目时，再调用 relay_context 或运行 CLI 的
doctor --hub <approved-hub>；不要在没有项目路径时全量扫描 Home 目录。
安装、MCP 和 Hook 的差异见 runtime.md。
换 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。
