跳到主要内容

多智能体开发工作流与交付门禁

多智能体系统的关键不是同时启动很多 Agent，而是让每个 Agent 有清晰边界，并让结果经过可验证的交接。小任务可以由单个 Agent 完成；只有存在并行收益、上下文隔离需求或不同专业检查时，才值得增加协调成本。

角色与任务流​

用户需求
   |
   v
主控 Orchestrator
   |  delegate_task
   +--> 需求分析 Agent
   +--> 实现 Agent
   +--> 测试 Agent
   +--> Review Agent
   |
   +<-- 失败回流到修复 Agent
   |
   v
合并、构建与交付
  • 主控 Orchestrator：维护目标、拆分任务、分配依赖、汇总结果，决定是否进入下一阶段。
  • 职责单一 Agent：一个 Agent 只负责分析、实现、测试或 review 中的一类工作，输出可检查的结果。
  • 任务委派：传递明确的输入、输出文件、验收条件和禁止触碰的范围，不要只传一句模糊目标。
  • 独立进程：为需要不同上下文的子任务启动独立进程，避免一个 Agent 的长上下文污染另一个任务。

隔离、交接与门禁​

  1. 工作目录隔离：为实现、实验或修复任务创建独立 worktree 和分支，让并行修改互不覆盖；主控只合并经过检查的提交或补丁。
  2. handoff 文件：每个 Agent 交接一份简短文件，至少记录任务、已修改文件、关键决策、测试命令、测试结果、已知风险和下一步。
  3. 任务队列：用“待处理 → 进行中 → 待测试 → 待 review → 完成/阻塞”表示状态，记录依赖和负责人，避免重复工作。
  4. 测试门禁：实现 Agent 完成后由测试 Agent 运行针对性测试，再根据改动风险运行类型检查、lint 或生产构建。
  5. Review 门禁：Review Agent 只依据需求、diff 和测试证据判断；发现问题时创建明确的修复任务，而不是直接绕过门禁合并。
  6. 失败回流：构建、测试或 review 失败时，把失败日志、复现命令和期望行为交给修复 Agent；修复后重新进入测试和 review。

最小可行流程​

需求登记
  -> Orchestrator 拆任务
  -> 分配 worktree 与独立进程
  -> Agent 完成并写 handoff
  -> 测试 Agent 验证
  -> Review Agent 审查
  -> 失败则回流修复
  -> 主控合并并运行最终构建

交付前检查清单​

  • 需求、输入、输出和禁止触碰范围已经写清楚。
  • 每个任务都有负责人、隔离目录、handoff 和测试证据。
  • 变更只包含目标文件，不把生成目录、调试日志或无关文件带入提交。
  • 文档内容经过安全检查，不包含真实代码托管地址、凭据、密钥或个人电脑绝对路径。
  • 生产构建后检查实际 HTML 的标题、描述、canonical、Open Graph 和 H1。