面向 Coding Agent 的多仓库 Git Worktree



导读 
introduction

在 《是时候了解一下 Git worktree 了》 一文中,我们介绍了如何在 Codex、Claude Code 等 Coding Agent 中利用 Git worktree 实现并行开发。不过,那篇文章聚焦于单仓库场景。当我们尝试将 worktree 应用于采用多仓库架构的 LLM Arena 平台时,又遇到了一系列新问题。


本文记录我们如何为多仓库场景设计面向 Coding Agent 的 worktree 工作流,以及如何处理子模块初始化、需求编号冲突和多 Agent 编排等问题。


全文 4199 字,预计阅读时间 7 分钟

《是时候了解一下 Git worktree 了》https://wangwei1237.github.io/2026/06/28/It-is-time-to-learn-about-git-worktree/

GEEK TALK

01

多仓库架构

在 如何利用 Harness “一句话交付产品功能”? 一文中,我们介绍过 LLM Arena 平台 的多仓库架构:使用 Git Submodule 管理多个代码仓库。

在 是时候了解一下 Git worktree 了 一文中,我们介绍了如何在 Codex、Claude Code 等 Coding Agent 中利用 Git worktree 实现并行开发。不过,那篇文章聚焦于单仓库场景。当我们尝试将 worktree 应用于采用多仓库架构的 LLM Arena 平台时,又遇到了一系列新问题。

本文记录我们如何为多仓库场景设计面向 Coding Agent 的 worktree 工作流,以及如何处理子模块初始化、需求编号冲突和多 Agent 编排等问题。

在 如何利用 Harness “一句话交付产品功能”? 一文中,我们介绍过 LLM Arena 平台 的多仓库架构:使用 Git Submodule 管理多个代码仓库。

在这种架构下,仅在 versus 父仓库中执行 git worktree add,并不能得到可直接开发的完整环境。父仓库的 worktree 只会创建 versus 的工作目录;其中的 Submodule 仍需单独初始化,并根据父仓库记录的 Gitlink 检出对应的子仓库 commit。

假设要同时开发两个需求:

  • REQ-001
  • REQ-002

并希望形成如下的目录结构:

.├── versus/            # 主仓库│   ├── versus-server/│   └── versus-fe/├── versus-REQ-001/    # REQ-001 的 worktree│   ├── versus-server/│   └── versus-fe/└── versus-REQ-002/    # REQ-002 的 worktree    ├── versus-server/    └── versus-fe/

1.1 为父仓库创建 worktree 

cd versus
git worktree add \    -b req-001 \    ../REQ-001 \    origin/master
git worktree add \    -b req-002 \    ../REQ-002 \    origin/master

此时,每个父仓库的 worktree:

  • 有独立工作目录
  • 有独立索引和当前分支
  • 共享父仓库的 Git 对象库
  • 可以由不同的 Coding Agent 并行操作
  • 但此时子模块目录可能还是空的,或者尚未初始化

1.2 在 worktree 中初始化子模块

cd ../REQ-001
git submodule sync --recursivegit submodule update --init --recursive

上述命令可以完成子模块初始化,但每次手动执行都很繁琐。如果让 Coding Agent 临时推理并生成操作步骤,不仅会消耗额外的 token,还容易因上下文差异产生不稳定行为。因此,我们编写了 wt.sh,将 worktree 创建、子模块初始化、端口分配和环境配置固化为确定性流程。

Git Submodule 的限制

Git 官方文档指出,多 worktree 场景下的 Submodule 支持仍不完整,并不推荐对 superproject 进行多重检出。因此,这套方案需要结合实际使用的 Git 版本、子模块结构和更新方式进行验证,不能直接视为通用方案。详见 git-worktree 官方文档。

https://git-scm.com/docs/git-worktree#_bugs

# wt.sh - Versus 多需求并行开发 worktree 管理脚本## 设计目标:#  - 每个需求一个独立 Git worktree,代码任务真正并行、互不干扰#  - 每个 worktree 分配独立端口(后端 9000+N / 前端 4000+N),接口测试可并行#  - 数据库共享 dev,不隔离;E2E 手动 / 顺序执行#  - 不改入库业务代码:端口与代理只在 worktree 内本地改 + assume-unchanged#  - 代码提交复用 scripts/commit.sh(百度 iCode Gerrit 评审流程)## 用法:#   ./scripts/wt.sh new id>                      # 创建 worktree (id 如 req-030 / REQ-030 / 030)#   ./scripts/wt.sh list                          # 列出所有 worktree + 端口 + 状态#   ./scripts/wt.sh go id>                       # 切换到 worktree (需 shell-init 的 function)#   ./scripts/wt.sh remove id> [--keep-branch]   # 删除 worktree (默认连带本地分支)#   ./scripts/wt.sh info id>                     # 查看单个 worktree 详情#   ./scripts/wt.sh current                       # 查看当前目录属于哪个 worktree
GEEK TALK

02

构建 worktree-manager Agent


在 如何利用 Harness “一句话交付产品功能”? 的“4.2 Harness 闭环设计”一节中,我们使用 6 个 Sub-Agent 实现需求开发闭环。

现在,我们还需要把 worktree 管理能力加入整个 Harness 闭环。为此,我们新增了 worktree-manager Agent。

每个需求都有一个贯穿开发流程的唯一 REQ-ID。引入 worktree-manager 后,REQ-ID 的生成也需要从需求设计阶段前移到 worktree 创建阶段。

2.1 定义 worktree-manager

---name: "worktree-manager"description: "Use this agent when a new requirement or modification task needs to be started and a dedicated worktree should be created f…
— 以上为试看内容(约 40%),开通会员后阅读全文 —