Agent 多代理协作：并行架构与最佳实践

{
  "team": "fullstack-dev",
  "orchestrator": {
    "model": "hunyuan-pro",
    "system_prompt": "你是一个全栈开发团队的技术负责人...",
    "max_workers": 5
  },
  "workers": [
    {
      "id": "frontend",
      "name": "前端工程师",
      "model": "deepseek-v3",
      "system_prompt": "你是前端开发专家，擅长 Vue3/React...",
      "tools": ["filesystem", "browser", "npm"],
      "skills": ["frontend-dev", "ui-design"],
      "max_concurrent": 2
    },
    {
      "id": "backend",
      "name": "后端工程师",
      "model": "deepseek-v3",
      "system_prompt": "你是后端开发专家，擅长 Python/FastAPI...",
      "tools": ["filesystem", "subprocess", "database"],
      "skills": ["backend-dev", "api-design"],
      "max_concurrent": 2
    },
    {
      "id": "tester",
      "name": "测试工程师",
      "model": "hunyuan-pro",
      "system_prompt": "你是QA专家，负责编写和执行测试...",
      "tools": ["filesystem", "subprocess"],
      "skills": ["test-gen", "test-runner"],
      "max_concurrent": 1
    },
    {
      "id": "reviewer",
      "name": "代码审查员",
      "model": "hunyuan-pro",
      "system_prompt": "你是代码审查专家...",
      "tools": ["filesystem", "git"],
      "skills": ["code-review"],
      "max_concurrent": 1
    }
  ],
  "shared_context": {
    "mode": "pub_sub",
    "topics": ["code_changes", "test_results", "review_feedback"]
  }
}

用户：开发一个用户管理模块，包含注册、登录、权限管理

Orchestrator 拆分：
├── backend:   实现 /api/users 注册/登录接口 + JWT 鉴权
├── backend:   实现 /api/roles 角色权限 CRUD 接口
├── frontend:  实现注册/登录页面组件
├── frontend:  实现用户管理后台页面（角色分配、权限配置）
└── tester:    为以上所有接口和页面编写测试用例

用户：将项目从 JavaScript 迁移到 TypeScript

Orchestrator 拆分：
├── worker-1:  迁移 src/utils/*.js → *.ts
├── worker-2:  迁移 src/components/*.jsx → *.tsx
├── worker-3:  迁移 src/services/*.js → *.ts
└── worker-4:  更新 tsconfig.json 和类型声明文件

用户：完成从需求到部署的全流程

阶段1（并行）：
├── analyst:   需求分析与 PRD 编写
└── designer:  UI/UX 设计稿

阶段2（并行，依赖阶段1）：
├── frontend:  前端开发
└── backend:   后端开发

阶段3（依赖阶段2）：
└── tester:    集成测试

阶段4（依赖阶段3）：
└── devops:    部署上线

Orchestrator 汇总：
✅ backend:   创建了 5 个 API 文件
✅ frontend:  创建了 3 个页面组件
✅ tester:    编写了 12 个测试用例
📊 总计：8 个文件创建，12 个测试用例，耗时 3m20s

质量门禁：
├── 代码风格：eslint 检查 → ✅ 通过
├── 类型检查：tsc --noEmit → ✅ 通过
├── 单元测试：npm test → ❌ 2 个失败
├── 代码审查：reviewer 评估 → ⚠️ 3 个建议
└── 决策：自动修复测试失败，采纳审查建议后重新验证

# backend 发布代码变更
publish("code_changes", {
  files: ["src/api/users.py", "src/models/user.py"],
  summary: "新增用户注册接口"
})

# tester 订阅并自动触发测试
on("code_changes", (msg) => {
  runTests(msg.files)
})

# frontend 请求后端接口定义
const apiSpec = request("backend", "get_api_spec", {
  endpoint: "/api/users"
})

# backend 响应
response({
  method: "POST",
  params: { username: "string", password: "string" },
  returns: { token: "string", user: "object" }
})