子代理 (Sub-Agents)

1. 静态代码分析
2. 架构模式评估  
3. 安全风险扫描
4. 性能瓶颈识别
5. 改进建议生成

# API 文档标准格式
## 接口概述
- 功能描述
- 业务场景
- 调用频率建议
 
## 请求参数
- 参数验证规则
- 类型定义
- 示例值
 
## 响应格式  
- 成功响应结构
- 错误码定义
- 边界情况处理
 
## 代码示例
- 多语言 SDK 调用
- curl 命令示例
- 错误处理最佳实践

# 指定代码审查子代理
请用 code-reviewer 子代理深度分析这个认证模块的安全性
 
# 指定 API 文档子代理
请用 api-documenter 子代理为这个 GraphQL API 创建完整的文档

# 电商系统开发的角色分工示例
 
👨‍💼 产品经理子代理
- 需求分析和整理
- 功能优先级排序
- 用户体验设计
 
👨‍💻 技术架构师子代理  
- 系统架构设计
- 技术选型决策
- 性能指标制定
 
👨‍🔧 开发工程师子代理
- 具体功能实现
- 代码质量保证
- 单元测试编写
 
👨‍🔍 测试工程师子代理
- 测试方案设计
- 自动化测试实现
- 质量保证流程
 
👨‍📚 技术文档师子代理
- API 文档编写
- 用户手册创作
- 部署指南制作

# 子代理配置策略
 
## 专业领域映射
### 代码质量相关
- 代码审查 -> code-reviewer 子代理
- 重构任务 -> refactoring-specialist 子代理  
- 测试相关 -> test-engineer 子代理
 
### 文档创作相关
- API 文档 -> api-documenter 子代理
- 教程创作 -> tutorial-creator 子代理
- 技术写作 -> technical-writer 子代理
 
## 调用策略
- 自动级联调用: 启用
- 并行处理上限: 5个子代理
- 超时设置: 每个子代理最长10分钟
 
## 质量控制
- 子代理输出交叉验证
- 专业知识一致性检查
- 最终成果质量保证

# 自定义子代理示例
 
## security-auditor (安全审计子代理)
### 专精能力
- OWASP Top 10 检查
- 依赖漏洞扫描
- 权限控制审查
- 数据加密验证
 
### 工作流程
1. 静态代码安全分析
2. 依赖包安全检查
3. 配置安全评估
4. 安全建议报告
 
### 输出格式
- 安全风险等级评定
- 具体漏洞位置标注
- 修复建议和代码示例
- 安全最佳实践推荐

# 用户请求：开发一个待办事项管理系统
 
## 子代理调度策略
🤖 主代理: 任务分解和协调
├── 📋 产品经理子代理: 需求分析
├── 🏗️ 架构师子代理: 技术架构设计
├── 💻 前端开发子代理: React 界面实现
├── ⚙️ 后端开发子代理: API 服务开发
├── 🗄️ 数据库设计子代理: 数据模型设计
├── 🧪 测试工程师子代理: 测试策略制定
└── 📚 文档师子代理: 项目文档编写
 
## 并行执行结果
✅ 完整的产品需求文档
✅ 清晰的技术架构图  
✅ 可运行的前端应用
✅ 完整的后端 API
✅ 优化的数据库设计
✅ 全面的测试套件
✅ 详细的项目文档

# 用户请求：重构老旧的电商订单系统
 
## 子代理分工协作
🔍 代码分析阶段:
├── architecture-analyzer: 现有架构问题分析
├── code-reviewer: 代码质量问题识别  
└── security-auditor: 安全漏洞扫描
 
🛠️ 重构实施阶段:
├── refactoring-specialist: 重构策略制定
├── database-designer: 数据模型优化
└── performance-optimizer: 性能瓶颈解决
 
📋 质量保证阶段:
├── test-engineer: 回归测试设计
├── api-documenter: API 文档更新
└── deployment-specialist: 部署策略制定
 
## 交付成果
✅ 清晰的架构升级方案
✅ 高质量的重构代码
✅ 完善的测试覆盖
✅ 详细的迁移指南

# 关键性能指标 (KPI)
 
## 效率指标
- 任务完成时间: 相比单一子代理的时间节省比例
- 并行化程度: 同时运行的子代理数量
- 资源利用率: CPU/内存使用效率
 
## 质量指标  
- 输出准确度: 专业领域内的正确率
- 一致性评分: 子代理间结果的一致性
- 用户满意度: 基于反馈的质量评估
 
## 协作指标
- 信息传递效率: 子代理间的协作流畅度
- 冲突解决能力: 处理不同观点的能力  
- 整合质量: 最终成果的完整性

# 子代理优化方法
 
## 智能调度
- 基于任务特征选择最合适的子代理
- 动态负载均衡避免资源浪费
- 智能缓存减少重复计算
 
## 专业知识库
- 维护各子代理的专业知识库
- 定期更新最佳实践和模式
- 跨项目经验积累和共享
 
## 协作机制优化
- 标准化子代理间的通信协议
- 优化任务分解和结果整合流程
- 建立有效的冲突解决机制

# 降级处理流程
子代理故障 → 检测故障类型 → 选择降级策略
 
## 降级策略类型
1. 水平降级: 切换到同级别的其他子代理
2. 垂直降级: 降级到上级子代理处理
3. 分片降级: 将任务拆解给多个子代理
4. 缓存降级: 使用历史类似任务的结果

# 子代理效果优化
## 任务描述技巧
✅ 明确专业领域: "请用 security-auditor 审查用户认证模块的安全性"
❌ 模糊的要求: "检查一下代码有没有问题"
 
## 协作配置技巧  
✅ 明确角色分工: "产品经理子代理负责需求，架构师子代理负责设计"
❌ 重复分工: "都帮我分析一下需求和技术方案"
 
## 期望管理技巧
✅ 合理预期: "预计需要3-5个子代理协作，耗时20-30分钟"  
❌ 过高预期: "马上给我一个完美的解决方案"