用途 /work 是 bro 技能集中用于管理并行 Git worktree 的策略层,适合在共享仓库中开始工作、多个并行 agent 会话争用同一检出,或需要清理 git worktree 时使用。所有具体机制都在 bro CLI 中,该技能本身只规定使用策略。
主要能力 bro work 让并行工作对并行友好:每个任务一个链接的 git worktree,绝不使用共享的主检出。Git 不允许同一分支在两个 worktree 中同时检出,这一拒绝本身就是碰撞防护。
命令
- bro work enter <slug>:在同级目录创建检出 <repo>--<slug>,位于分支 work/<slug>,可用 --branch、--base 覆盖。基准默认显式指定为主检出的分支;--stack(或 bro.config.json 中的 stack.mode: "auto")改为以当前 worktree 的分支为基准,并把这个边记录到 .git/bro/stack/ 下,以便自底向上合并。已存在的分支会被检出而不是重建。会尝试初始化子模块,并在 <slug> 对应某个 bead 时尝试认领它,两者都是尽力而为。
- bro work leave [slug]:移除 worktree,默认移除当前 worktree;--force 丢弃脏状态,--delete-branch 删除已合并的分支。子模块树会被强制移除,但不触碰共享的子模块配置。
- bro work list:列出每个 worktree 的分支、干净/脏计数、树内实时认领(claim:<slug>,即 bro work enter 打上的标记);--sizes 追加 du。bro fleet status 在面板的 worktrees[] 中提供同一视图。
- bro work prune:清掉磁盘上已删除的 worktree 的管理条目。--loop 还会回收 loop/(及 stack/)遗留:其 bead 已关闭或 PR 已合并的 worktree 会连同分支一起移除,但仅当可验证为干净、未认领、未锁定且无人占用时。脏树、未关闭的 PR、活跃 agent 和无法验证的 bead 会保留,并注明原因。--dry-run 只报告判定结果,不做任何改动。
策略
- 任何编辑文件的任务默认使用 worktree。主检出是共享基础设施,应视为只读为主。
- 保持干净。创建了 worktree 的会话在停止前应移除它;当前 worktree 为脏时,stop hook 会拦截一次。
- worktree 是同级目录,绝不嵌套——<repo>--<slug> 位于检出旁边。无需 gitignore;删除一个不会影响另一个。
- 被 gitignore 的目录(node_modules、dist/)不会跟随,需在新 worktree 内运行仓库的安装步骤。
- 共享仓库会拦截非快进的分支移动。bro 的 reference-transaction 钩子会否决对 refs/heads/* 的 reset/fetch/update-ref 式重写;内容移动(commit、merge、rebase、pull)总是放行。需要刻意重写时设置 BRO_REF_GUARD=off。
- Beads 无需配置:bd 在任何 worktree 中都能通过 git 公共目录发现共享数据库。
- slug 跟随 bead。bro work enter bro-123 在进入时尝试认领 bead bro-123;非 bead 的 slug 直接跳过认领。
- 堆叠 PR:当 stack.mode: "auto" 时,在 worktree 内再次运行 bro work enter,会把新分支以该 worktree 的分支(会话的栈顶)为基准;manual(默认)需要 --stack 或 --base。堆叠应按自底向上顺序合并,gh-stack 负责 submit/sync。
适用场景与限制 适用于共享仓库、并行 agent 会话和需要隔离多任务改动的场景。限制在于:它只是策略封装,实际功能依赖 bro CLI 和 git;gitignore 目录不随 worktree 带过去;非快进分支移动默认被拦截,需要显式关闭保护;prune 对脏树、开放 PR、活跃 agent 或不可验证的 bead 一律保留。