Braidkeep icon

Braidkeep

Braidkeep 是面向并行 AI 编码代理的合并安全与作用域保护工具,可预测潜在合并冲突、约束文件编辑范围,并帮助团队选择更安全的合并顺序。

Braidkeep

概述

Braidkeep 是适用于并行 AI 编码代理群的 Apache-2.0 合并安全与作用域保护层。其设计目标是帮助团队预测合并冲突、约束代理可以编辑的位置,并决定将分支合并回 main 的更安全顺序。

该项目明确标记为研究预览版(v0.1.0)。README 说明它预测的是可合并性而非正确性,因此应先在一次性或非关键仓库上使用,并在采取任何操作前审查其输出。

核心能力

合并可行性预测

使用 Git merge-tree --write-tree 持续模拟进行中的代理分支之间的两两合并,因此预测基于 Git 自身的合并底层机制。

实时冲突矩阵

在实时冲突矩阵 TUI 中展示当前冲突状态;当提交落地时,冲突会立即亮起,无需真正合并即可看到变化。

作用域保护允许列表

通过在 braidkeep.yaml 中声明的按代理文件所有权允许列表,在编辑落地前捕捉越权范围扩大。

评审时强制执行

提供 braidkeep check 作为评审时强制执行步骤,在 CI 中针对 diff 运行,无论代理是如何被调用的。

安全合并规划

计算安全的合并顺序,将无冲突分支分组为批次,并以最少冲突优先的方式排列其余纠缠分支。

只读 CLI 二进制

以单个静态二进制文件形式提供,并保持只读,仅与 Git 底层机制交互,不会修改工作区、索引或 refs。

适用场景

  • 监控繁忙的分支队列

    当有多个代理分支处于活动状态,并且你希望在任何人合并之前实时查看哪些分支对可能冲突时,使用 braidkeep watch。

  • 在编辑时约束代理作用域

    当代理只应触及代码库中很小的一部分,例如一个应限制在 internal/auth/ 内的身份验证修复时,使用允许列表工作流。

  • 安全安排合并顺序

    当你需要决定哪些分支可以立即一起合并、哪些分支应延后并稍后排队时,使用 braidkeep plan。

  • 用 CI 强制执行评审门禁

    当你希望在 CI 或评审自动化中对 diff 强制执行文件所有权规则,而不受代理启动方式影响时,使用 braidkeep check。

  • 先在非关键仓库中评估

    在将工具引入重要代码库之前,先使用演示工作流或一次性仓库进行评估。

Pros and Cons

Pros

  • 在合并前预测成对合并冲突。
  • 使用 Git 的 merge-tree 底层机制,而不是单独的合并模型。
  • 加入按代理划分的文件所有权保护线,减少作用域蔓延。
  • 为无冲突批次和更难处理的分支计算实用的合并顺序。
  • 可在多个编排器下运行,也可用于 CI。

Cons

  • 它是早期研究预览版,不是成熟的生产级产品。
  • 一次成功的可合并性预测并不能保证合并一定正确或安全。
  • README 指出,权限绕过模式可以跳过默认的写入时 hook,因此 CI 检查才是真正的强制执行门。

FAQ

Braidkeep 可以用于生产环境吗?

Braidkeep 被定位为早期研究预览版。README 说明它预测的是可合并性,而不是正确性,因此一次干净的预测并不保证合并结果一定正确或安全。

主要命令或工作流有哪些?

README 将 braidkeep watch 描述为实时的成对冲突矩阵,braidkeep plan 作为安全合并顺序规划器,而 braidkeep check 作为针对文件所有权规则的评审时强制检查门。

Braidkeep 如何强制执行作用域边界?

该项目在 braidkeep.yaml 中记录了按代理划分的文件所有权允许列表,并使用 Claude Code PreToolUse hook 作为默认开启的写入时保护措施。README 还说明 braidkeep check 会在 CI 中针对 diff 运行,且不能被代理的启动方式绕过。

Braidkeep 是否依赖特定的代理编排器?

README 说明 Braidkeep 可在任何编排器下工作,包括 Claude Squad、Conductor、Vibe Kanban、纯 tmux 或 CI。

在使用之前我需要注意什么?

README 说明 Braidkeep 按“原样”提供,建议先在一次性或非关键仓库中测试,并在采取行动前先审查其输出。

Quick Facts

类别
开发者工具
来源域名
github.com
许可证
Apache-2.0
发布状态
研究预览版(v0.1.0)
平台 / 形式
单个静态二进制 CLI
主要用户
运行并行 AI 编码代理的团队