用途 该技能是 bro CLI 中 /status 的合约参考,面向 pi 扩展、TUI、仪表盘等瘦客户端,让它们通过一次读取获得项目当前“活着”的状态,而不是每轮刷新分别调用 bd list、bro fleet agents status 和 bro review act status。所有实际机制都在 bro CLI 中,技能本身只描述渲染看板所需的合约。
主要能力 提供三种读取方式:bro fleet status 输出紧凑的人类可读看板;bro fleet status --json 输出机器可读的瘦客户端合约;bro fleet status --deep 额外加入 act 退出门(调用 gh,节奏较慢)。JSON 结构包含:dir、branch、dirty;worktrees(每个检出目录的名称、路径、分支、状态、认领标记,以及 main/here 标志);beads(inProgress、ready、readyTotal,其中 ready 最多 10 条);fleet(maxConcurrent 与 agents,含 id、backend、step、state、cause、pid、worktree、provider、model);drill(当前 frame 的 id、title、depth);watch(ts、ageMs、attention);以及 --deep 时出现的 act(PR 编号、URL、gate、openThreads、ciPending、blockers)。
使用方式 按需选择命令:日常刷新用本地快路径 bro fleet status 或 --json;需要 PR 闸门信息时用 --deep,并采用比本地看板更慢的轮询节奏。合约要点:读取只读、以当前工作目录为范围,永不修改状态,可在任意 tick 安全轮询;快路径纯本地,数据来源为 bd、代理注册表(<git-common>/bro/agents.json,跨链接工作树共享)、drill 栈和 git status --porcelain,不涉及网络;缺失状态视为空而非错误(无 bead 的检出返回空数组,无注册表返回 agents: [],无打开的 PR 返回 act: null,无心跳文件返回 watch: null)。
适用场景 适合需要以低成本、单次调用渲染项目实时看板的瘦客户端,例如编辑器扩展、终端 UI 或仪表盘,用于展示活动 bead、fleet 工作进程、当前 drill 帧、工作树认领情况与 PR 闸门状态。
限制 --deep 会发起网络请求且更慢,应降低轮询频率。bead 行是精简的,只有 id、title、priority、issue_type、assignee 会跨线传输,描述和依赖图需用 bd show 查看。fleet.agents[].state 通过 pidAlive 与记录的 exitStatus 廉价推导,并非完整连接器探测。worktrees 中非活动工作树(停放的兄弟目录)只列出而不探测 state。watch 的心跳只证明最近一次 tick 运行过,不指明是哪次调用写入。