taxueseek agent-relay
产品无关的任务接力与委派：用 session-digger 证据组装 packet，通过 CLI invoke 交给子代理或任意 peer 读 HANDOFF 续跑。
CLI
RELAY=~/.agents/skills/agent-relay/scripts/relay_cli.py
python3 "$RELAY" peers
python3 "$RELAY" envs # 本机有哪些 Agent 环境
python3 "$RELAY" workspace --project /path # 任意工作区 → 各环境落盘目录
python3 "$RELAY" doctor # 含 workspace map
python3 "$RELAY" init
# 信任闭环前半：硬化目标 + 干跑（不花 peer token）
python3 "$RELAY" goal-lint --goal "…" [--verify-cmd '…']
python3 "$RELAY" plan --task "…" [--to PEER] [--action delegate|pack|handoff|bridge]
python3 "$RELAY" pack [--from auto|claude|grok|zcode] [--to PEER] [--session PATH] [--goal TEXT] [--deep] [--lint-goal]
python3 "$RELAY" resume [latest|packet-id]
python3 "$RELAY" bridge <keyword> [--deep]
python3 "$RELAY" suggest [--task TEXT] # peer 推荐 + harness pattern
# 真调（默认 async + lean；--wait 同步等结束）
python3 "$RELAY" invoke --to claude|grok|kimi_code|mimo [--wait] [--visible] [--full-context]
python3 "$RELAY" job-status [--packet latest] [--json] [--verbose]
python3 "$RELAY" handoff --to claude --goal "… VERIFY: test -f path && rg -q TOK path" [--wait] [--visible]
python3 "$RELAY" delegate --to claude --task "写文件 X 内容 Y VERIFY: test -f X && rg -q Y X" [--mode implement|review|fix] [--strict-goal] [--visible]
# goal 建议带 VERIFY: 可脚本验收；结束后读 result.json 一屏回执
# 可见终端默认 Ghostty；zcode 无 CLI invoke
# 评估（按项目 cwd 探测会话；无硬编码用户路径；mac/linux/win）：
# python3 scripts/eval_wave2.py --project . --dry-run
# python3 scripts/eval_wave2.py --session "$GROK_SESSION" --to claude
产品目的：跨产品任务接力/委派——换设备、换工作区、额度切换，任务仍能接上。
链路：workspace 发现本机各 Agent 落盘 → pack 按当前项目自动绑会话 → invoke/handoff 静默或 --visible 调用 → VERIFY。
环境适配内置（core/env_map.py，不装 digger 也能用）；路径按本机 ~ 与项目路径动态编码。
E2E：python3 scripts/e2e_collab.py --project .
信任闭环（借鉴 codex-workflows，落地为 relay 形态）
goal-lint → plan → pack/delegate → job-status / VERIFY
- goal-lint：把模糊 goal 收成可判定合同（VERIFY、sandbox、involvement、scale）
- plan：零 token 干跑，报路由 / 风险 / 建议命令
- VERIFY + result.json：委派后半验收（已有）
- 不抄：Codex 舰队 DAG、
human()GUI、sessionful race — 那些是 codex-workflows 的战场
路由
| 用户意图 | 动作 |
|---|---|
| 目标太糊，先硬化 | goal-lint --goal "…" |
| 先估路由/风险再花额度 | plan --task "…" |
| 打包离开 / 额度快没了 / 交接 | pack（可选 --lint-goal） |
| 委派子代理执行任务 | delegate --to <peer> --task "..." |
| 接着做 / resume | resume latest，注入后先 Read primary 文件 |
| 跨环境对齐 / 另一个产品做到哪 | bridge <关键词> |
| 该交给谁 + 用什么模式 | suggest --task "..." |
| 直接调用另一产品继续/审查 | `invoke --to claude |
| 环境是否就绪 | doctor / peers |
| 为什么这样定（考古） | session-digger /recall，本 skill 不答 |
| Codex 多代理 fan-out / 执行图 | codex-workflows /codex-workflows，本 skill 不答 |
子代理委派模式
delegate 命令将当前 agent 作为「主管」，分配任务给子代理（claude/grok/kimi_code 等），等待完成并获取结构化结果。
# 委派 Claude 实现一个功能
python3 "$RELAY" delegate --to claude --task "写文件 tests/test_relay.py，测试 delegate 流程。VERIFY: test -f tests/test_relay.py && rg -q delegate tests/test_relay.py"
# 委派 Kimi 审查代码
python3 "$RELAY" delegate --to kimi_code --task "审查 src/core/peers.py，列出 3 个改进建议。mode=review"
# 委派 Grok 修复 bug
python3 "$RELAY" delegate --to grok --task "修复 relay_cli.py 中 session 路径 glob 问题。VERIFY: python3 -c 'print(\\\"ok\\\")'" --mode fix
输出格式（调用方可解析）：
DELEGATE_OK peer=claude duration=12.3s verify=pass
done: 写文件 tests/test_relay.py
files: tests/test_relay.py
open: (none)
result: /path/to/result.json
执行纪律
- pack/resume/bridge/delegate 优先跑 CLI，不要只凭记忆写交接文
- resume 后：文件与 git 是真源，packet 是导航
- 昂贵 delegate/handoff 前：
goal-lint或plan；goal 建议带VERIFY: - 可委派 peer：
claude·grok·kimi_code·mimo（mimo run）；模型：AGENT_RELAY_MIMO_MODEL - ZCode：仅 pack/resume（无 CLI invoke），不在一等 peer 中
- 勿把密钥写入 packet
- 反过度建设：两行 proof / typo 用 quick + 小 peer，勿
--deep、勿多 peer 舰队
模式卡片（suggest 会附带）
| id | 防什么 | 典型动作 |
|---|---|---|
trust_loop |
糊目标 + 无验收 | goal-lint → delegate → job-status |
fresh_context_review |
作者审自己 | A implement → B --mode review |
hedged_race |
单路径死磕 | 两 peer 各试假说，先 VERIFY 胜 |
quota_handoff |
上下文丢失 | pack → resume |
cross_peer_align |
多端各说各话 | bridge |
supervisor_checkpoint |
盲写高风险区 | plan → 人确认 → delegate |
anti_overbuild |
小任务开舰队 | short budget + trivial peer |
产物
- 全局：
~/.agents/relay/<project-slug>/<id>/{packet.json,HANDOFF.md,sources.json,result.json} - 项目：
.relay/CURRENT.md（init+ 每次 pack 更新） - job 摘要：
job-status归一化running|completed|stopped|idle（借鉴 fleet 状态，单包粒度）
插件预留
本目录即为未来插件根：.claude-plugin/plugin.json、hooks/、commands/ 已占位。本期只作 skill 使用。
DO NOT
- 不替代 session-digger 分析
- 不替代 codex-workflows 的 Codex 舰队 / sessionful race / GUI map
- L3 消息总线仍延期；L2
invoke/handoff/delegate：claude/grok/kimi_code；zcode 仅 resume - zcode：保留 digger 证据 + pack/resume；不可 invoke 委派