该技能为 bro CLI 的策略层,本身不重新实现底层机制,而是规定在开放 PR 上执行审查-修复循环时应遵循的流程。
使用前需确保 bro 在 PATH 中或可通过 npx -y @broject/bro@0 运行,并完成 gh 认证;若使用 defer 裁决,还需 bd(beads)在 PATH 中,标准安装通常已包含。
主要命令包括:
- bro review act status [PR] [--json]:查看 PR 状态与退出条件(开放线程、CI 失败、SAST 发现),受阻时以非零状态退出。
- bro review act threads [PR]:列出未解决的审查线程(TSV 格式)。
- bro review act wait [PR] [--interval S] [--timeout M] [--merge] [--cleanup] [--bead ID] [--detach]:轮询门禁直到稳定(通过、阻塞或超时);可合并、清理工作树与本地分支、关闭 bead 或后台分离运行。
- bro review act rearm [--dry-run] [--json]:恢复已死亡的监视器。
- bro review act merge [PR] [--squash|--merge|--rebase] [--admin] [--cleanup] [--bead ID]:仅在门禁通过时合并,支持序列化与清理。
- bro review act resolve --thread ID [--comment T]:解决线程(可先回复)。
- bro review act reply --thread ID --comment T:回复但不解决(支持 --file 批量)。
策略要点:循环直到退出条件通过,不自行宣告完成;待定的 AI 审查者会阻塞门禁,失败的审查者检查不阻塞;必须对每个机器人审查线程给出裁决(修复后静默解决、拒绝时回复理由、或延迟到债务队列);循环有次数限制(act.maxRounds 默认 3,文档类 PR 默认 2);重新打开的线程需用户确认;矛盾发现需判断处理;应通过 bro review act merge 合并而非直接 gh pr merge;使用 bro review act wait 在后台等待而非自建轮询;修复后静默解决,不逐线程评论;合并后清理分支需确认分支可证明属于该 PR。
适用于自动化 PR 审查反馈处理、合并管理及分支清理等开发工作流。限制包括依赖特定 CLI 工具、需 gh 认证、部分功能需 bd 等。