← 返回博客
Ai预计阅读 8 分钟

并行跑十个 agent 之后,先撑不住的会是你的 git 仓库

发布于 2026年11月7日
并行跑十个 agent 之后,先撑不住的会是你的 git 仓库

这一年 coding agent 的宣传口径一直很一致:它能无人值守地跑,所以你应该同时跑几个。五个、十个、更多。一个改认证,一个修那个不稳定的测试,一个做谁都不想碰的迁移。

工具基本撑得住。然后你真的去试了,坏掉的东西原来是你的工作目录。

两个 agent 在同一个 checkout 里一分钟内就会互相覆盖文件。修法 git 在 2015 年就有了:worktree,让每个分支有自己的目录,同时共用一个对象库。git 能做这件事。git 做这件事的接口难用到大部分人从来没碰过。

Worktrunk 是一个用 Rust 写的 CLI,专门修那个接口。它 1.19 万星,其中约 2200 来自过去一周,许可 MIT 或 Apache-2.0,看你选哪个。

打三遍字的问题

在 git 里创建一个 worktree 要把分支名打三遍:

git worktree add -b feat ../repo.feat cd ../repo.feat

三遍里有两遍是多余的。它们存在是因为命令要一个路径和一个分支,而路径几乎总是能从分支推出来。听起来是个小麻烦。它是 worktree 一直停留在「有强观点的人才用」而不是默认做法的原因。

Worktrunk 用分支名来指代 worktree,路径按可配置模板算出来。任何接受分支的命令也接受该分支所在 worktree 的路径。于是那段尴尬的三步舞变成:

wt switch -c -x claude feat

建分支、建它的 worktree、在里面起 Claude,从你当前所在的任何地方。`-x` 在切换之后跑一个命令,你在分隔符后面追加的内容会传给它,这就是你把第一条指令交给 agent 的方式。

三条这样的命令,你就有三个 agent 在三个分支上,互相隔离,彼此不需要协调。

安装

macOS 或 Linux 用 Homebrew:brew install worktrunk && wt config shell install。Cargo、pacman、conda-forge、pixi 都能装。Windows 是 winget install max-sixty.worktrunk,然后 git-wt config shell install。

Windows 那条注释值得重复,因为它一定会坑到人:wt 已经指向 Windows 终端,所以 Winget 把工具装成 git-wt 来避开冲突。你也可以在应用执行别名里关掉 Windows 终端的别名,直接用 wt。

config shell install 这一步不能省。它装的是让命令能改变当前目录的 shell 钩子,也就是 wt switch 全部的机制。跳过它,每条命令看起来都什么也没做。

真正要紧的四条命令

wt switch 移动你。wt list 列出所有 worktree 和状态标记:@ 是当前位置,+ 是有暂存改动,↑1 是领先 main 一个提交,⇡ 是有未推送的提交。光是这个输出就比 git worktree list 强,后者只给你路径。

wt remove 收拾,把 worktree 和分支一起删掉,在 git 里是两条命令,还要在一个地方搞错。

wt merge main 是最有意思的。它 squash 当前分支、rebase 到 main、快进合并、删掉 worktree,一步。如果你曾经在三个并行分支上把同一个冲突解了三遍,你就知道它为什么存在。并行会放大合并问题,而合并问题本来就是这份工作里最不愉快的部分。

还有 wt switch pr:123,直接跳到某个 PR 背后的分支。小功能,生活质量不成比例。

存储是没人提醒你的那部分

十个 worktree 就是十份 node_modules 和十份 target/。在笔记本上是几百 GB,而且每一份第一次 cargo build 都是四分钟。

Worktrunk 用写时复制的构建缓存处理这个。在支持的文件系统上,macOS 的 APFS、Linux 上带 reflink 的 btrfs 和 XFS,worktree 共享构建目录,只在文件改变时才分叉。第一次构建付账,后面九次借用。

这类功能会暴露作者到底拿工具在干什么。没有人会给 worktree 管理器加共享构建缓存当作营销动作。他们是在第四次把磁盘塞满之后加的。

相关的细节是 hash_port,一个模板过滤器,给每个 worktree 分一个唯一端口。十个 worktree,十个开发服务器,不撞端口,不用手工记账。配上一个装依赖、起服务的 post-start 钩子,新 worktree 在 agent 启动那一刻就是可用的。

钩子是锋利的那一面

钩子在定义好的时机自动跑 shell 命令:worktree 启动之后、合并之前、合并之后。post-start 钩子就是你白得环境初始化的方式。

它们也是由一次 git 操作触发的任意代码执行。一个仓库可以带一份配置,在 wt switch 时跑点什么,如果你克隆了它、切进一个分支,你就跑了。这跟 npm install 跑 postinstall 是同一类风险,值得同样的对待:信一个仓库之前先读配置。

工具自己的回答是钩子声明在你能控制的配置里。这够不够取决于你的威胁模型,对任何会克隆陌生仓库的人,这事值得想一想。

它没修掉什么

worktree 共用一个 .git 目录,意味着共用分支引用、stash 和配置。两个 agent 不能 checkout 同一个分支。在一个 worktree 里 git rebase 会改动另一个 worktree 正坐在上面的历史。reflog 条目交错的方式会让事后取证更麻烦。

Worktrunk 让常见情况舒服,没有改变底层模型。如果你的 agent 需要真正独立的仓库,你要的是分开克隆,代价是失去让 worktree 变便宜的那个共享对象库。

还有一个工具不碰的协调问题。十个 agent 分在十个分支上,会产出十个动到同样三个文件的 PR,再多的 worktree 管理也不能让它们干净合并。真正从并行里拿到价值的团队,看起来是那些分配不重叠区域的,而不是跑最多 agent 的。

为什么这类工具在赢注意力

agent 框架拿走发布会。让 agent 能用的那些工具拿走星数。

这个模式这一年重复了很多次:记忆层、权限模式、沙箱、worktree 管理器。每一个之所以存在,都是因为模型已经好到能干那个活,而周围环境从来没为一个不会累、不会提问、会安安静静在错误目录里跑四十分钟的工人设计过。

Worktrunk 是对其中一个缺口小而专注的回答。它那 1.19 万颗星不是对 Rust 或对 git 的表态。它们数的是那些试着同时跑三个 agent、然后发现难的部分在文件系统上的开发者。

相关文章