当前位置：首页 > news >正文

构建ClaudeAgent：Worktree+任务隔离

news 2026/4/20 21:13:47

在多智能体系统里，想让多个 AI 同时干活还不打架，是把这类工具真正用到实际项目中的关键一步。但现实中，很多人一让几个 Claude Agent 一起改代码，就会出问题：它们都用同一个文件夹，结果谁改了什么、有没有提交，大家互相看不见，很容易把对方的改动覆盖掉、搞混，甚至让整个项目跑不起来。这样一来，不仅开发变慢了，出了错也很难找原因，回退到之前的状态更是麻烦。

为了解决这个痛点，本文会一步步带你用 Git 的 Worktree 功能加上任务隔离的设计，从零搭出一个能让多个 Agent 安全、高效一起工作的系统。

一、问题到底出在哪：为什么多个 AI 一起写代码会乱？

平时只有一个 Agent 的时候，它在一个 Git 文件夹里改来改去没问题。可一旦同时派好几个 Agent 去做不同的事（比如一个优化配置文件，另一个调整工具函数），它们就共用同一套代码。这时候，如果 A 改了一半还没保存（提交），B 就可能读到一半对一半错的代码，接着做出错误判断。结果就是：

程序逻辑出错，行为奇怪
自动测试失败，但不知道是谁改的
想回到昨天能跑的版本？很难干净地回退

看起来是多人并行，实际上还是得排队干，效率根本提不上去，系统也不稳。

二、好办法来了：Git Worktree 就像给每个任务配个“独立工位”

1. Worktree 到底是什么？

Worktree 是 Git 自带的一个功能，它允许你在同一个代码仓库里开出多个独立的工作目录。每个目录有自己的文件和当前分支，但底层的 Git 数据（比如提交历史、文件内容）是共享的，所以不会多占很多硬盘空间。

打个比方：

以前：一个办公室（仓库），只有一张桌子（工作区）→ 多个人要用就得轮流坐。

现在：一个办公室（共享 Git 数据），每人一张桌子（独立 Worktree）→ 大家同时干活，谁也不挡谁。

2. 为什么这个特别适合 AI 写代码？

互不干扰：每个任务有自己的文件夹，改自己的，碰不到别人的。
省地方：不用复制整个项目，磁盘占用小很多。
切换快：不用存草稿（stash）或来回切分支，任务上下文一直都在。
好追踪：每个 Worktree 可以用任务编号命名，做完就能删，清清楚楚。

三、怎么在 ClaudeAgent 里用上它：把“派活”和“干活”分开管

我们的做法很简单：任务决定要做什么，Worktree 提供干活的地方，再用一个 ID 把它们绑在一起。这样，调度和执行就分开了，系统更清晰也更稳。

主要部分说明：

模块	干什么
任务调度器	负责分任务、看进度、管开始和结束
Worktree 管理器	自动建或删 Worktree，并跟任务 ID 对应上
操作记录器	把每一步操作都记下来，出问题能查，也能恢复

整个流程是这样的：

当一个新任务来了，调度器会给它一个唯一的编号；管理器马上在项目里建一个以这个编号命名的新 Worktree，并拉出一个专属分支（比如叫 task/123）；然后 Agent 就在这个干净、独立的环境里干活，所有修改都只影响自己；等任务完成，系统自动提交代码、发起合并请求，最后把临时文件夹清理掉。

四、代码长什么样（Java 示例）

public class WorktreeTaskIsolationSystem {private static final Path REPO_ROOT = detectRepoRoot(WORKDIR);public void executeTask(Task task) {String worktreePath = createWorktree(task.getId());try {// 在隔离环境里运行 AgentrunAgentInWorktree(worktreePath, task);} finally {cleanupWorktree(task.getId());}}private String createWorktree(String taskId) {String branch = "task/" + taskId;String path = REPO_ROOT.resolve("worktrees").resolve(taskId).toString();// 执行命令：git worktree add <path> <branch>executeCommand("git", "worktree", "add", path, branch);return path;}
}