🚀 Claude Code 多智能体并行开发 SOP

(google云盘)操作文档.pdf

核心原理与准备

核心原理:利用 git worktree 实现物理目录隔离,利用 Prompt/配置文件实现 AI 的权限与上下文隔离,最后通过 Git 完成代码合并。

📋 准备工作

  • 前提条件:已安装 Git 并熟悉基本操作;已全局安装并登录 Claude Code。
  • 项目状态:主项目(假设名为 my-project)已初始化 Git 仓库,且代码处于干净状态(无未提交的修改)。
  • 架构规约:在主项目中准备好一份接口文档(如 api-docs.md),确保前后端数据结构已定死。

🛠️ 第一阶段:创建物理隔离的开发环境

不要在同一个文件夹里开两个 Claude,我们需要用 Git 劈出两个平行的工作区。

1. 进入主干:打开终端,进入你的主项目目录。

1
cd my-project

2. 创建前端专属工作区:在主项目同级目录下新建文件夹,并绑定新分支。

1
git worktree add ../project-frontend feature-frontend

3. 创建后端专属工作区:同样在同级目录下新建文件夹,并绑定新分支。

1
git worktree add ../project-backend feature-backend

💡 提示:此时你的文件系统中会有三个平行的文件夹:my-project(主干)、project-frontend(前端分支)、project-backend(后端分支)。


🛡️ 第二阶段:配置 Claude 的“责任边界”

为了防止前端 Claude 乱改 Java 代码,后端 Claude 乱改 Vue 页面,我们需要给它们立下规矩。

📍 1. 配置前端 Claude

进入前端工作区:

1
cd ../project-frontend

在根目录新建配置文件 .clauderc,写入以下内容:

1
Custom Prompt: 你现在是 Vue 前端开发工程师。你的修改权限仅限于 src/views, src/components 和 src/api 目录。请严格参考根目录下的 api-docs.md 进行数据 Mock 和接口对接。绝对不允许修改任何后端代码或构建脚本。

📍 2. 配置后端 Claude

进入后端工作区(打开一个新的终端窗口):

1
cd ../project-backend

在根目录新建配置文件 .clauderc,写入以下内容:

1
Custom Prompt: 你现在是 Spring Boot 后端开发工程师。你的修改权限仅限于 src/main/java 和 src/main/resources 目录。请严格参考根目录下的 api-docs.md 编写 Controller 和 Service。绝对不允许修改任何前端文件。

💻 第三阶段:启动并行开发

它们现在会同时在各自的文件夹里写代码,互不干扰。

  • 前端开发:在前端终端(project-frontend 目录下),输入 claude 启动。

    • 指令示例:“帮我把 api-docs.md 里的登录接口对接到 Login.vue 页面,包含表单校验。”
  • 后端开发:在后端终端(project-backend 目录下),输入 claude 启动。

    • 指令示例:“帮我实现 api-docs.md 里的登录逻辑,使用 JWT,在 UserControllerAuthService 中完成代码。”

🔄 第四阶段:代码收口与合并

当两边的 Claude 都告诉你任务完成后,即可进行合并。

1. 分别提交代码:在两边的终端里让 Claude 帮你提交,或者你手动提交。

1
2
3
# 在前端和后端目录下分别执行
git add .
git commit -m "feat: 完成各自模块的开发"

2. 回到主干合并:关闭 Claude Code,回到你的主项目目录。

1
2
3
cd ../my-project
git merge feature-frontend
git merge feature-backend

3. 清理工作区(可选):合并完毕且测试无误后,你可以删掉那两个平行的文件夹,释放空间。

1
2
3
4
git worktree remove ../project-frontend
git worktree remove ../project-backend
git branch -d feature-frontend
git branch -d feature-backend