多智能体协作开发

技能文档

---
name: multi-agent-collab-dev
description: 多智能体协作开发模式，通过为每个任务派遣独立子代理来执行实施计划，任务间自动进行规范合规审查与代码质量审查。适用于有独立任务模块的实施计划执行。触发词：子代理开发、多代理协作、任务分发执行、并行开发。
title: 多智能体协作开发
category: 开发工具
---

# 多智能体协作开发

通过为每个任务派遣独立子代理来执行实施计划，每个任务完成后进行两阶段审查：先检查规范合规性，再检查代码质量。

## 核心理念

**为什么使用子代理：** 将任务委派给具有隔离上下文的专用代理。通过精确构建指令和上下文，确保它们专注于各自任务。子代理不继承主会话的上下文或历史，由协调者精确构建所需信息。这也保护了协调者自身的上下文用于协调工作。

**核心原则：** 每个任务一个全新子代理 + 两阶段审查（规范 + 质量） = 高质量快速迭代

**持续执行：** 任务间不要暂停等待确认。持续执行计划中的所有任务。仅在以下情况停止：无法解决的阻塞状态、真正阻碍进展的歧义、或所有任务完成。

## 使用时机

- 已有实施计划
- 任务之间大多相互独立
- 希望在同一会话中完成（无需切换会话）

## 执行流程

1. **读取计划**：提取所有任务及完整文本，记录上下文
2. **逐任务执行**：
   - 派遣实现子代理执行任务
   - 如子代理提问，回答并提供上下文
   - 子代理完成实现、测试、提交、自审
3. **规范审查**：派遣规范审查子代理，确认代码符合规范
   - 不合规 → 实现子代理修复 → 重新审查
4. **质量审查**：派遣代码质量审查子代理
   - 有问题 → 实现子代理修复 → 重新审查
5. **标记完成**：通过审查后标记任务完成
6. **循环**：继续下一个任务
7. **最终审查**：所有任务完成后，派遣最终代码审查

## 模型选择策略

使用能胜任各角色的最低能力模型以节省成本并提高速度：

| 任务类型 | 推荐模型 | 特征 |
|---------|---------|------|
| 机械实现任务 | 快速经济型 | 涉及1-2个文件，规范完整 |
| 集成判断任务 | 标准型 | 多文件协调，模式匹配，调试 |
| 架构设计审查 | 最强可用 | 需要设计判断或广泛代码理解 |

## 子代理状态处理

| 状态 | 处理方式 |
|------|---------|
| DONE | 进入规范审查 |
| DONE_WITH_CONCERNS | 阅读关注点，正确性问题先处理再审查 |
| NEEDS_CONTEXT | 提供缺失上下文后重新派遣 |
| BLOCKED | 评估阻塞原因：上下文问题→补充上下文；推理不足→升级模型；任务过大→拆分；计划有误→上报用户 |

## 关键规则

**必须遵守：**
- 每个任务使用全新子代理
- 规范审查必须在质量审查之前完成
- 审查发现问题必须修复后重新审查
- 不要忽略子代理的提问或升级请求
- 不要并行派遣多个实现子代理（避免冲突）

**绝对禁止：**
- 跳过任何阶段的审查
- 带着未修复问题进入下一任务
- 让子代理直接读取计划文件（应由协调者提供完整文本）
- 在规范审查未通过时开始质量审查
- 忽略子代理的阻塞报告

## 效率优势

- 每个子代理拥有新鲜上下文，不会混淆
- 协调者精确策划每个子代理所需信息
- 审查环节自动进行，无需人工干预
- 问题在早期发现，比后期调试成本更低

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。