该技能是 bro CLI 的命令行工具,本身不包含具体机制,所有逻辑都在 bro CLI 中实现;本技能只是一层策略。它是 bro review watch 的写侧对应物:watch 报告 PR #N 被 open_threads 阻塞,drive 则据此采取行动。它针对的是“孤儿 PR”缺口——convoy/loop 会话在 PR 打开后结束,之后到达的审查线程没有负责人。
用途
对 fleet 分支(worktree 分支,以及本地 work/、loop/、stack/* 分支)上的每个开放 PR 执行一次巡检,根据门禁状态和占用情况决定跳过、启动修复者、合并或关闭悬空修复者 bead。
主要能力
- open_threads > 0 且被占用:跳过,由活跃负责人处理自己的线程。
- open_threads > 0 且未被占用:在 PR 的 worktree 中,针对其修复者 bead(-l fixer,external_ref drive:pr:<N>)启动或重启修复者代理。
- mergeable = CONFLICTING 且被占用:跳过。
- mergeable = CONFLICTING 且未被占用:以 rebase 工单启动同一修复者代理——fetch + rebase 到 PR 的 base、解决冲突、--force-with-lease push——受 fixRounds > maxRounds 上限约束。
- gate.ok 且被占用、状态新鲜:报告,由负责人的合并步骤落地。
- gate.ok 且被占用、超过 TTL 无活动:视为孤儿收养,执行 bro review act merge。
- gate.ok 且未被占用:执行 bro review act merge,干净后退役 worktree,关闭修复者 bead。
- PR 已合并/关闭:关闭悬空的修复者 bead。
占用判定综合 agents facade、PR 上活跃的外部 watch 标记(bro flow loop 心跳、act wait、convoy)、worktree 自身的 claim 标记(<gitdir>/bro/work)、.work 标记、/proc cwd 扫描(沿进程祖先追溯到 agent 形根,或匹配 BRO_AGENT_ID/AI_AGENT 环境徽章)。被占用始终是安全判定。
合并路径是唯一会让占用状态“老化”的地方:每项占用证明都带有最近活动时间戳(agent 日志 mtime 或 spawn 记录、标记 mtime、worktree 自身变动)。若绿灯 PR 的负责人静默超过 drive.occupancyTtlSec(默认 2 小时,下限 60 秒),则视为孤儿,drive 会收养并合并,而不是永远报告“绿灯但被占用”。新鲜度以最新证明为准——陈旧修复者旁有活跃会话仍会否决。非绿灯判定不会老化:被占用的线程/冲突 PR 保持占用。
使用方式
- bro review drive [--once]:执行一次监督巡检(默认)。
- bro review drive --every [N]:每 N 秒执行一次巡检,进程内运行,需以 detached 方式启动(nohup/tmux/daemon);单独 --every 使用 drive.intervalSec。
- bro review drive --no-merge:仅监督,从不合并(配置 drive.merge: "never")。
- bro review drive --connector <name>:在指定后端启动修复者。
- bro review drive --json:每个 PR 判定输出一行 JSON。
- bro review drive install [--every N] [--print]:启用合并路径——写入 bro/drive.json(会话检查点据此重启已停止的监督者),并启动 bro fleet daemon;节奏为 --every N 或 drive.intervalSec。
- bro review drive uninstall:解除标记并停止监督者。
配置项:drive.intervalSec(300)、drive.merge(auto|never)、drive.occupancyTtlSec(7200,合并路径活动上限)。修复者代理命令的解析方式与 bro fleet agents up 相同:agents.<backend>.command → loop.agent。
适用场景
PR 打开后无人看守的审查线程与冲突处理;需要常态化、常驻的合并路径;在不打扰活跃会话的前提下自动推进绿灯 PR。
限制与注意事项
- 占用不是错误:被跳过的 PR 表示有活跃会话拥有它,应报告后继续,绝不强行进入他人 worktree。
- 修复者 bead 是操作句柄:bro fleet agents status <bead> 查看,bro fleet agents down <bead> 停止;修复者是独立任务,bro fleet 不会列出它。修复者死亡时以相同 agentId 重启,这是约定。
- 合并是退出门禁的职责,不是驱动器的:drive 从不绕过 bro review act merge,非绿灯 PR 只监督、不强制。
- 编排器脉冲执行单次巡检:bounded bro review watch --every --for 窗口结束后 → bro review drive once → 摘要 → 重新武装。长期常驻监督使用 bro review drive --every;两种 --every 形式在 BRO_AGENT_ID 下都会拒绝(spawn 出的 worker 从不设置节奏)。不存在 systemd/crontab 安装;会话启动会从 bro/pulse.json 重新武装已停止的脉冲。
- bro review drive install 是常开的合并路径:启用 bro/drive.json 后监督成为基础设施而非可选;每个生命周期事件(sessionStart + postTool,仅编排器)都会重启已停止的监督者。install 期间 bro fleet daemon 停止只是暂时停止,下一个检查点会恢复;uninstall 才是解除。