SuperAPI AI 工具集

stack

编程与开发

查看项目

更新于 10-26 18:53

技能介绍

该技能本身只定义策略,全部机制由 bro CLI 实现。一个堆栈是 bead 的有序链:第 N 个成员的工作树分支基于第 N-1 个成员的分支,其 PR 也以该分支为目标,因此依赖工作可在父项仍进行中时被评审。堆栈表现为 stack/<name>/<n>-<slug> 分支之上的视图,加上 bro work enter 记录的 .git/bro/stack/ 边;失效分支会自动退出。

主要命令:

  • bro flow stack push <bead> [--name <stack>]:基于堆栈末端创建兄弟工作树 <repo>--<bead> 与分支 stack/<name>/<n>-<bead>(首个成员基于默认分支)。在主检出中必须提供 --name;在 stack/<name>/… 成员工作树内会自动推断。重复推送已为成员的 bead 会重新进入其工作树,不会产生重复位置。该命令会像 work enter 一样认领 bead。
  • bro flow stack list [<name>]:列出链的位置、bead、分支、记录的基、工作树状态、PR 状态及声明的基。
  • bro flow stack sync [<name>]:合并后级联:将开放的子 PR 重定向到新基并重定基子分支;平台已完成的步骤会跳过;脏或锁定的工作树会被跳过并报告,由属主在重新进入时重定基。干净的级联还会发布链(见下)。
  • bro flow stack publish [<name>]:将链中开放的成员 PR 注册为宿主服务端堆栈(GitHub 上即 gh stack link)。幂等:已在内成员保留,重跑为无操作。需要至少 2 个开放成员 PR;在宿主自行检测链的环境(GitLab、纯 git)会拒绝。
  • bro flow stack merge [<name>] [--squash|--merge|--rebase] [--admin]:在通过每个可合并成员的 act gate 后,通过连接器自身机制自底向上落链;合并后同步自动运行。
  • bro flow loop --stack <name>:自主运行器将每个认领的 bead 链接入指定堆栈,并在每次合并落地后同步。

连接器分派:堆栈操作遵循「平台已做什么」的原则,不手写平台负责的步骤。GitHub:带 .stack 标记的 PR 意味着平台在合并时重定向依赖项并重定基其远程分支,因此 sync 跳过 API 重定向并快进跟随远程(仅本地提交在顶部重放,不会对平台改写强推)。安装 gh stack 扩展后,stack merge 即一次原子 gh stack merge <top-pr> --yes;否则逐层异步合并。stack publish 就是该扩展的 gh stack link,即创建或增长 .stack 读取所反映的服务端堆栈对象的写入路径。GitLab(19.1+):平台从目标分支检测链并在每次合并时重定向下一个 MR,bro 不调用重定向 API;合并为逐层自底向上 PUT …/merge。纯 git:无 forge,stack merge 将每个成员落入主工作树中的 trunk,sync 为本地重定基级联。

策略要点:推送 bean 而非分支;开放成员 PR 以低于它的成员为目标(底部成员以默认分支为目标,无 forge 仓库不打印提示);发布是事后行为而非推送的一部分,需在第二个成员 PR 开放后调用 publish 或由干净的 stack sync 完成;合并通过 stack merge 执行后自动同步,合并集为具有 OPEN PR 的活动成员的连续前缀,无 PR 成员会断链并使合并停在其下,所有成员的 act gate 必须为绿;sync 可安全重跑;绝不在他人的脏工作树上同步;堆栈与 bro work enter --stack 组合,共享同一套边注册表(stack.mode: "auto" 为临时链,命名 bro flow stack 为命名链)。