bridge-workerlisted
Install: claude install-skill ychenfen/claude-agent-skills-collection
# bridge-worker:桥接任务的执行流程
你是执行者。指挥方(Claude 或 Codex)不会相信你写的任何总结,只会拿 `delivery.json` 用同一个 `bw_verify.py` 重新跑一遍。所以按下面的流程做,比写一份漂亮的报告有用。
脚本都在本 skill 的 `scripts/` 下,只依赖标准库,用 `python3` 运行。下文用 `$BW` 代表这个目录。
长命令运行器使用 POSIX 进程组与 `fcntl`,支持 macOS/Linux。通道 1、2、3 分别使用 `/tmp/claude_agy_bridge`、`/tmp/claude_agy_bridge2`、`/tmp/claude_agy_bridge3`;可通过对应 `BW_BRIDGE_ROOT_<通道>` 环境变量指定隔离目录。派单端与执行���必须保持一致。
## 流程
1. 认领。`python3 $BW/bw_claim.py --channel <你的通道号>`。它只看你自己通道的 inbox,输出本次的运行目录。认领失败(已被认领、通道不符)就停下,不要手动改名去抢。如果你的监听流程已经按旧习惯把请求改名成了 `.claimed`,用 `python3 $BW/bw_claim.py --channel <通道号> --req-id <id> --adopt` 补登记。
2. 读任务书全文。任务书优先于其他指示。把"允许做的事"和"产出清单"抄进运行目录的 `plan.md`。
3. 跑命令。超过 2 分钟的��令一律经 `bw_run.py` 启动,并且必须给 `--hard-timeout` 和 `--stall-timeout`:
```bash
python3 $BW/bw_run.py --run-dir <运行目录> --name score \
--hard-timeout 7200 --stall-timeout 1200 \
--progress-file /abs/out.jsonl -- python3 score.py ...
```
它每 60 秒写一次 `heartbeat.json`,进度文件超过 `--stall-timeout` 没有增长就终止整个进程组。被终止不是你的失败,是它在替你止损;看日志找原因,不要原样重跑。
4. 等待时看心跳,不要干等。等任何后台进程前先读它的 `heartbeat.json`:`state` 不是 `running` 就说明它已经结束或被终止,去读 `commands.jsonl` 里的退出码和 `killed_reason`。
5. 写 `delivery.json`(格式见 `templates/delivery.example.json`)。报告里出现的每个数字先登记成一条 claim,写明源文件和取值位置。
6. 生成报告。报告模板里的数字写成 `{{c:claim编号}}`,然后 `python3 $BW/bw_render.py delivery.json template.md -o report.md`。不要手写数字。渲染完再把 `report.md` 的 SHA256 填进 `artifacts`;之后改过报告就要重填。`report_exempt_numbers` 里的数字会被原样列给验收方看,只放章节号这类不是结果的数。
7. 自检并交付。`python3 $BW/bw_finish.p