| name | multi-agent-programmer |
| description | Use this skill when implementing complex programming tasks that benefit from multi-agent collaboration. This skill coordinates a Master LLM (orchestrator) with specialized agents (Requirements Agent, Code Agent, Review Agent) to deliver high-quality software through a structured development workflow. |
Multi-Agent Programmer
协调多代理协作完成复杂编程任务的专业技能。通过主控LLM（Master）协调需求分析、代码实现和代码审查三个专业代理，实现结构化、高质量的软件开发流程。
使用时机
在以下场景使用此技能：
- 复杂功能开发：需要多步骤分析、设计和实现的功能
- 代码重构：涉及多个文件和架构调整的重构任务
- 系统集成：需要理解现有代码库并添加新功能
- 质量要求高：需要经过严格审查的代码实现
- 需求不明确：需要深入分析才能实现的模糊需求
不适合的场景：
- 简单的单文件修改
- 明确的Bug修复（单行或少量代码变更）
- 文档生成或简单配置修改
系统架构
┌─────────────────────────────────────────────────────────┐
│ Master LLM (主控) │
│ 职责：流程协调、任务分发、决策 │
└─────────────┬───────────┬───────────────┬───────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Requirements │ │ Code │ │ Review │
│ Agent │ │ Agent │ │ Agent │
│ (需求分析) │ │ (代码实现) │ │ (代码审查) │
└─────────────────┘ └─────────────┘ └─────────────────┘
代理角色定义
Master LLM (主控代理)
职责：
- 整体流程控制和协调
- 任务分解和分发
- 代理间通信桥接
- 最终决策和质量把关
能力要求：
- 全局视野和决策能力
- 任务优先级判断
- 冲突解决和协调
- 上下文管理
Requirements Agent (需求代理)
职责：
- 分析和理解用户需求
- 识别技术细节和约束条件
- 明确功能边界和验收标准
- 输出详细的技术规格说明
输入：用户原始需求
输出：结构化需求文档（参考 references/requirement_template.md）
能力配置：
- 高度分析性和细致性
- 强调技术细节
- 关注边界情况
- 输出结构化文档
Code Agent (代码代理)
职责：
- 根据需求规格实现代码
- 遵循项目代码规范
- 实现核心功能和边界情况处理
- 编写必要的注释和文档
输入：需求规格文档
输出：实现代码和修改说明
能力配置：
- 代码生成和实现导向
- 遵循最佳实践
- 注重可维护性
- 完整性思维
Review Agent (审查代理)
职责：
- 审查代码质量和正确性
- 检查安全漏洞和潜在问题
- 验证需求覆盖度
- 提出改进建议
输入：实现代码 + 需求规格
输出：审查报告和改进建议
能力配置：
- 批判性和审查性思维
- 安全和质量意识
- 细节观察力
- 建设性反馈
执行流程
阶段 1：需求分析 (Requirements Agent)
-
加载需求模板
使用 Read 工具加载：references/requirement_template.md
-
执行需求分析
- 理解用户意图和目标
- 识别功能需求和非功能需求
- 分析技术约束和依赖
- 定义验收标准
-
输出需求文档
- 使用模板生成结构化文档
- 包含：功能描述、技术规格、验收标准、边界情况
阶段 2：代码实现 (Code Agent)
-
分析现有代码库（如需要）
- 使用 Glob 查找相关文件
- 使用 Read 理解现有结构
- 识别需要修改的部分
-
生成实现代码
- 遵循需求规格文档
- 应用项目代码规范
- 处理错误和边界情况
-
输出实现结果
- 使用 Edit/Write 工具修改/创建文件
- 提供代码变更说明
阶段 3：代码审查 (Review Agent)
-
加载审查检查清单
使用 Read 工具加载：references/review_checklist.md
-
执行代码审查
- 检查代码质量和规范
- 验证需求覆盖度
- 识别安全和性能问题
- 评估可维护性
-
输出审查报告
- 使用模板生成报告
- 包含：问题清单、严重程度、改进建议
阶段 4：迭代优化 (Master 协调)
-
审查反馈处理
- 如果审查通过：进入最终确认
- 如果发现问题：返回 Code Agent 进行修正
-
迭代循环
- 最多进行 3 轮审查-修正循环
- Master 判断是否满足质量标准
-
最终确认
使用指南
启动技能
当用户提出编程任务时，Master 首先判断是否需要使用此技能：
判断标准：
- 任务复杂度 > 简单修改
- 涉及文件数 > 3
- 需要需求分析 = 是
- 质量要求 = 高
执行模式
模式 A：顺序执行（默认）
模式 B：迭代执行
- 需求 → 代码 → 审查 → [修正 → 审查] × N → 完成
模式 C：并行探索（复杂任务）
- 需求分解 → 多个代码任务并行 → 统一审查 → 集成
上下文管理
为避免上下文溢出，采用以下策略：
- Master 维护全局状态摘要
- 各代理仅关注其职责相关的上下文
- 使用
scripts/ 中的工具进行中间数据传递
资源文件
必需资源
需求模板：references/requirement_template.md
- 定义需求文档的标准格式
- 包含所有必需字段
- 提供填写示例
审查检查清单：references/review_checklist.md
- 代码审查的标准检查项
- 安全、性能、可维护性检查点
- 问题严重程度分级标准
可选资源
项目规范：references/project_conventions.md
- 项目特定的编码规范
- 架构模式和设计原则
- 依赖和工具使用指南
脚本工具
协调器脚本：scripts/agent_coordinator.py
- 自动化代理间通信
- 管理任务状态和上下文传递
- 生成执行报告
最佳实践
Master 协调原则
- 明确任务边界：每个代理的职责清晰
- 控制上下文大小：定期摘要和清理
- 及时决策：避免无限循环
- 透明沟通：向用户报告进展
需求分析原则
- 追问细节：不做出假设
- 结构化输出：便于后续代理理解
- 定义验收标准：明确成功条件
代码实现原则
- 先理解后修改：阅读相关文件
- 遵循现有模式：保持一致性
- 完整实现：包括错误处理
代码审查原则
- 建设性批评：指出问题并提供解决方案
- 分级评估：区分必须修复和可选改进
- 验证完整性：确保需求全部覆盖
输出格式
最终交付物
任务完成后，Master 应生成包含以下内容的交付报告：
# 任务完成报告
## 需求摘要
[简短描述需求和目标]
## 实现概述
[列出修改的文件和主要变更]
## 审查结果
- 通过项目：X / Y
- 问题数量：Z 个（已解决）
- 审查结论：[通过/有保留/不通过]
## 变更文件清单
- `path/to/file1.ext`：变更说明
- `path/to/file2.ext`：变更说明
## 后续建议
[可选：改进建议或注意事项]
故障排除
常见问题
问题 1：上下文溢出
- 症状：代理失去之前讨论的内容
- 解决：Master 定期生成状态摘要，清理历史
问题 2：需求理解偏差
- 症状：代码不符合预期
- 解决：Requirements Agent 增加确认环节
问题 3：无限审查循环
- 症状：Review Agent 和 Code Agent反复争论
- 解决：Master 强制决策，设置最大迭代次数
扩展开发
添加新代理
要添加新的专业代理：
- 在
references/ 中创建代理角色定义文件
- 在 SKILL.md 中添加代理描述
- 更新执行流程以集成新代理
自定义工作流
可以调整代理协作模式：
- 串行：一个接一个执行
- 并行：多个代理同时工作
- 层级：代理调用子代理
示例场景
场景 1：新功能开发
用户请求："添加用户认证功能"
Master: 启动多代理流程
→ Requirements Agent: 分析认证需求（OAuth/JWT/Session）
→ Code Agent: 实现认证中间件和路由
→ Review Agent: 检查安全性（CSRF/注入/会话管理）
→ Master: 确认完成，生成报告
场景 2：代码重构
用户请求："重构数据处理层，使其更易测试"
Master: 启动多代理流程
→ Requirements Agent: 分析当前架构，定义重构目标
→ Code Agent: 实施重构，添加接口抽象
→ Review Agent: 验证重构正确性和测试覆盖
→ Master: 确认无回归，完成
此技能通过多代理协作模式，实现复杂编程任务的系统化、高质量交付。
