多AI团队并行开发不冲突Agent Teams AI的Git Worktree分支策略详解【免费下载链接】agent-teams-aiYoure the boss, agents are your team. They handle tasks on their own, message each other, and review each others work. You just watch the kanban board and give high-level commands. Codex/Claude/OpenCode/Cursor/Grok/GitHub/Kiro/Z.AI/Xiaomi/MiniMax/Kimi(300 models, 200 LLM providers, free models no auth) Build your AI company with multiple teams项目地址: https://gitcode.com/gh_mirrors/cl/agent-teams-ai让多个 AI 智能体团队同时改一个代码库最怕的就是互相踩踏。Agent Teams AI 是一套多 AI 团队协作工具你负责下高层指令、看看板AI 团队自己领任务、互相发消息、互审代码。它的核心能力之一就是基于 Git Worktree 的分支隔离策略给每个队友分配独立的 worktree 检出目录和专属分支让并行开发不再冲突。本文面向新手详解这套 Git Worktree 分支策略的原理、启用条件和审查流程。为什么多AI并行开发必然产生冲突当你同时让 3 个 AI 队友修改同一个仓库时传统做法下会发生这些问题文件覆盖两个 AI 同时编辑policy.ts后写的把先写的改动覆盖了状态污染lead 自己的工作区还没提交队友的修改混进来分不清谁改了什么合并地狱所有变更堆在同一个分支上最后审查时一锅粥Agent Teams AI 的思路很直接一人一个 worktree一人一个分支物理隔离 逻辑隔离双保险。三种并行策略按团队规模选对模式官方文档 git-worktree-strategy.md 给出了一张清晰的策略对照表策略适用场景取舍主 worktree单人工作、只改文档、只有一个队友简单但并行编辑会冲突功能分支一个团队做一项连贯变更审查目标清晰但队友仍共享文件Worktree 隔离多个 OpenCode 队友并行编辑同一仓库隔离性最好合并需要更多纪律核心建议从简单开始。只有在真正可能出现并行编辑时才启用 worktree 隔离而不是给每个任务都建一份检出——那样只会拖慢审查节奏。什么时候该启用 Worktree 隔离满足以下任意一条就值得为 OpenCode 队友开启 worktree 隔离✅ 两个或更多队友可能同时编辑同一个仓库✅ 某个任务会运行格式化工具、代码生成器或大范围测试✅ 你希望每个队友的分支和 diff 彼此独立✅ lead 工作区是脏的有未提交改动不该被队友直接动反之以下情况保持关闭即可任务是只读的、只有一个队友在编辑、仓库还没被 Git 跟踪或运行时路径不支持该隔离模式。⚠️ 注意Worktree 隔离目前仅适用于 OpenCode 成员且项目必须已被 Git 跟踪。自动化机制每个队友一个专属分支这套策略的底层实现在 TeamMemberWorktreeManager.ts 中它会自动完成三件事你完全不用手动敲 git 命令1️⃣ 生成确定性的专属分支名分支名格式为agent-teams/团队名/成员名-仓库哈希例如agent-teams/atlas/bob-a1b2c3d4e5。同一成员重复启动团队时哈希保证分支名稳定不会凭空产生一堆孤儿分支。2️⃣ 独立的检出目录每个成员拥有独立的 worktree 目录按「项目名-仓库哈希/团队/成员」三级组织存放在应用数据目录的team-worktrees下互不干扰。3️⃣ 幂等与防冲突保护代码中有一道关键防线创建前会检查git worktree list如果该分支已在别处被检出直接报错拒绝branch is already checked out elsewhere目录已存在时则校验它确实属于同一个 Git 仓库、且不在 detached HEAD 状态——队友上次做到哪条任务分支上就原样保留。前置条件检查Git 状态预检服务在真正创建 worktree 之前TeamWorktreeGitService.ts 会做一轮体检把常见坑提前拦下来项目路径必须是绝对路径且是真实存在的目录项目必须是 Git 仓库否则会提示 Worktree isolation requires a Git repository仓库必须有至少一次提交HEAD 存在。注意它只会提醒你手动提交绝不会自动帮你 commit如果项目还不是仓库服务也可以引导执行git init并创建初始提交把裸目录变成可隔离的工作区。分支卫生开始并行开发前的30秒清单在启动团队之前花 30 秒确认状态运行git status --short看看主工作区是否干净运行git branch --show-current确认当前分支主工作区有未提交改动也没关系——但要明确告诉智能体不要 revert 不相关文件并把任务范围收窄文档推荐了统一的分支命名风格agent/团队或任务/简短用途例如agent/docs/mcp-guide、agent/review/task-log-filtering一眼就能看出这条分支是谁、为哪个任务开的。审查流程完成不等于自动合并隔离带来的最大收益是审查路径变干净了每个 worktree 对应一个独立分支diff 精简、变更范围聚焦。审查界面里可以按文件、按代码块逐个 Accept 或 Reject标准审查流程 5 步看任务结果评论确认智能体说明了变更范围和验证方式在审查 UI 中逐块检查任务 diffdiff 碰了不相关文件→ 请求修改request changes测试/手动检查的风险等级与任务匹配后再批准有意识地合并或应用变更 最重要的纪律不要仅因任务完成就自动合并。完成只意味着智能体自认为准备好接受审查不代表变更真的安全。冲突处理策略4种常见情形怎么办即便做了隔离并行团队仍会遇到摩擦。官方给出的处理对照表情形操作两个队友编辑同一个文件暂停其中一个任务或指定一个负责人做整合生成的文件被大范围改动要求队友附评论说明所用生成器和命令主 worktree 有不相关改动保留这些改动只审查任务所属的变更Worktree 分支出现分叉审查后手动 rebase 或 merge不要在含糊的智能体任务里进行任务提示词的写法也直接影响冲突概率。一个好的提示词会指明允许的区域、敏感的边界、完成的证据例如在你的 worktree 中实现设置校验修复编辑限定在 settings 目录内不要碰 provider auth 和任务存储完成前提交测试命令和结果。更多示例见 team-brief-examples.md。从简单开始渐进式上隔离总结这套 Git Worktree 分支策略的心法单一队友/只读任务→ 直接用主 worktree别过度设计连贯变更的团队→ 开一条功能分支审查目标更清晰多 OpenCode 队友并行编辑→ 启用 worktree 隔离自动专属分支 独立 diff任何情况→ 完成 ≠ 合并审查永远由你把关想进一步了解可以阅读仓库内的策略研究笔记 research-worktrees.md涵盖 per-teammate、per-task 等进阶隔离模式的设计权衡、code-review.md审查机制详解以及 create-team.md创建团队入门。让 AI 团队并行狂奔你只管看板与合并——这正是 Agent Teams AI 你是老板智能体是团队的核心体验。【免费下载链接】agent-teams-aiYoure the boss, agents are your team. They handle tasks on their own, message each other, and review each others work. You just watch the kanban board and give high-level commands. Codex/Claude/OpenCode/Cursor/Grok/GitHub/Kiro/Z.AI/Xiaomi/MiniMax/Kimi(300 models, 200 LLM providers, free models no auth) Build your AI company with multiple teams项目地址: https://gitcode.com/gh_mirrors/cl/agent-teams-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 多AI团队并行开发不冲突Agent Teams AI的Git Worktree分支策略详解【免费下载链接】agent-teams-aiYoure the boss, agents are your team. They handle tasks on their own, message each other, and review each others work. You just watch the kanban board and give high-level commands. Codex/Claude/OpenCode/Cursor/Grok/GitHub/Kiro/Z.AI/Xiaomi/MiniMax/Kimi(300 models, 200 LLM providers, free models no auth) Build your AI company with multiple teams项目地址: https://gitcode.com/gh_mirrors/cl/agent-teams-ai让多个 AI 智能体团队同时改一个代码库最怕的就是互相踩踏。Agent Teams AI 是一套多 AI 团队协作工具你负责下高层指令、看看板AI 团队自己领任务、互相发消息、互审代码。它的核心能力之一就是基于 Git Worktree 的分支隔离策略给每个队友分配独立的 worktree 检出目录和专属分支让并行开发不再冲突。本文面向新手详解这套 Git Worktree 分支策略的原理、启用条件和审查流程。为什么多AI并行开发必然产生冲突当你同时让 3 个 AI 队友修改同一个仓库时传统做法下会发生这些问题文件覆盖两个 AI 同时编辑policy.ts后写的把先写的改动覆盖了状态污染lead 自己的工作区还没提交队友的修改混进来分不清谁改了什么合并地狱所有变更堆在同一个分支上最后审查时一锅粥Agent Teams AI 的思路很直接一人一个 worktree一人一个分支物理隔离 逻辑隔离双保险。三种并行策略按团队规模选对模式官方文档 git-worktree-strategy.md 给出了一张清晰的策略对照表策略适用场景取舍主 worktree单人工作、只改文档、只有一个队友简单但并行编辑会冲突功能分支一个团队做一项连贯变更审查目标清晰但队友仍共享文件Worktree 隔离多个 OpenCode 队友并行编辑同一仓库隔离性最好合并需要更多纪律核心建议从简单开始。只有在真正可能出现并行编辑时才启用 worktree 隔离而不是给每个任务都建一份检出——那样只会拖慢审查节奏。什么时候该启用 Worktree 隔离满足以下任意一条就值得为 OpenCode 队友开启 worktree 隔离✅ 两个或更多队友可能同时编辑同一个仓库✅ 某个任务会运行格式化工具、代码生成器或大范围测试✅ 你希望每个队友的分支和 diff 彼此独立✅ lead 工作区是脏的有未提交改动不该被队友直接动反之以下情况保持关闭即可任务是只读的、只有一个队友在编辑、仓库还没被 Git 跟踪或运行时路径不支持该隔离模式。⚠️ 注意Worktree 隔离目前仅适用于 OpenCode 成员且项目必须已被 Git 跟踪。自动化机制每个队友一个专属分支这套策略的底层实现在 TeamMemberWorktreeManager.ts 中它会自动完成三件事你完全不用手动敲 git 命令1️⃣ 生成确定性的专属分支名分支名格式为agent-teams/团队名/成员名-仓库哈希例如agent-teams/atlas/bob-a1b2c3d4e5。同一成员重复启动团队时哈希保证分支名稳定不会凭空产生一堆孤儿分支。2️⃣ 独立的检出目录每个成员拥有独立的 worktree 目录按「项目名-仓库哈希/团队/成员」三级组织存放在应用数据目录的team-worktrees下互不干扰。3️⃣ 幂等与防冲突保护代码中有一道关键防线创建前会检查git worktree list如果该分支已在别处被检出直接报错拒绝branch is already checked out elsewhere目录已存在时则校验它确实属于同一个 Git 仓库、且不在 detached HEAD 状态——队友上次做到哪条任务分支上就原样保留。前置条件检查Git 状态预检服务在真正创建 worktree 之前TeamWorktreeGitService.ts 会做一轮体检把常见坑提前拦下来项目路径必须是绝对路径且是真实存在的目录项目必须是 Git 仓库否则会提示 Worktree isolation requires a Git repository仓库必须有至少一次提交HEAD 存在。注意它只会提醒你手动提交绝不会自动帮你 commit如果项目还不是仓库服务也可以引导执行git init并创建初始提交把裸目录变成可隔离的工作区。分支卫生开始并行开发前的30秒清单在启动团队之前花 30 秒确认状态运行git status --short看看主工作区是否干净运行git branch --show-current确认当前分支主工作区有未提交改动也没关系——但要明确告诉智能体不要 revert 不相关文件并把任务范围收窄文档推荐了统一的分支命名风格agent/团队或任务/简短用途例如agent/docs/mcp-guide、agent/review/task-log-filtering一眼就能看出这条分支是谁、为哪个任务开的。审查流程完成不等于自动合并隔离带来的最大收益是审查路径变干净了每个 worktree 对应一个独立分支diff 精简、变更范围聚焦。审查界面里可以按文件、按代码块逐个 Accept 或 Reject标准审查流程 5 步看任务结果评论确认智能体说明了变更范围和验证方式在审查 UI 中逐块检查任务 diffdiff 碰了不相关文件→ 请求修改request changes测试/手动检查的风险等级与任务匹配后再批准有意识地合并或应用变更 最重要的纪律不要仅因任务完成就自动合并。完成只意味着智能体自认为准备好接受审查不代表变更真的安全。冲突处理策略4种常见情形怎么办即便做了隔离并行团队仍会遇到摩擦。官方给出的处理对照表情形操作两个队友编辑同一个文件暂停其中一个任务或指定一个负责人做整合生成的文件被大范围改动要求队友附评论说明所用生成器和命令主 worktree 有不相关改动保留这些改动只审查任务所属的变更Worktree 分支出现分叉审查后手动 rebase 或 merge不要在含糊的智能体任务里进行任务提示词的写法也直接影响冲突概率。一个好的提示词会指明允许的区域、敏感的边界、完成的证据例如在你的 worktree 中实现设置校验修复编辑限定在 settings 目录内不要碰 provider auth 和任务存储完成前提交测试命令和结果。更多示例见 team-brief-examples.md。从简单开始渐进式上隔离总结这套 Git Worktree 分支策略的心法单一队友/只读任务→ 直接用主 worktree别过度设计连贯变更的团队→ 开一条功能分支审查目标更清晰多 OpenCode 队友并行编辑→ 启用 worktree 隔离自动专属分支 独立 diff任何情况→ 完成 ≠ 合并审查永远由你把关想进一步了解可以阅读仓库内的策略研究笔记 research-worktrees.md涵盖 per-teammate、per-task 等进阶隔离模式的设计权衡、code-review.md审查机制详解以及 create-team.md创建团队入门。让 AI 团队并行狂奔你只管看板与合并——这正是 Agent Teams AI 你是老板智能体是团队的核心体验。【免费下载链接】agent-teams-aiYoure the boss, agents are your team. They handle tasks on their own, message each other, and review each others work. You just watch the kanban board and give high-level commands. Codex/Claude/OpenCode/Cursor/Grok/GitHub/Kiro/Z.AI/Xiaomi/MiniMax/Kimi(300 models, 200 LLM providers, free models no auth) Build your AI company with multiple teams项目地址: https://gitcode.com/gh_mirrors/cl/agent-teams-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考