任务子代理工具 (Task/Agent Tools)

# 需要全面能力的任务
- 分析大型代码库结构
- 执行复杂的代码重构
- 进行深度的技术调研
- 处理涉及多个子系统的问题

# 内容创作需求
- 编写产品介绍页面
- 创作技术博客文章
- 生成 README 文档
- 制作用户指南

# 任务分析示例
task_analysis = {
    "task_type": "content_creation",
    "complexity": "medium", 
    "domain": "technical_writing",
    "tools_needed": ["write", "edit", "research"]
}
 
# 子代理选择逻辑
if task_analysis["task_type"] == "content_creation":
    selected_agent = "writer"
elif task_analysis["complexity"] == "high" and task_analysis["tools_needed"] == "*":
    selected_agent = "general-purpose"
else:
    selected_agent = "general-purpose"  # 默认选择

# 明确指定使用 writer 子代理
请用 writer 子代理帮我编写一份 API 使用指南
 
# 指定使用 general-purpose 子代理进行复杂分析
请用 general-purpose 子代理分析这个项目的架构并提出优化建议

# 用户请求
帮我为开源项目创建完整的文档体系
 
# Claude 的子代理调度
🤖 启动 writer 子代理处理内容创作任务
📋 任务分解:
- 项目介绍和特性说明
- 安装和快速开始指南
- API 使用文档
- 贡献指南
 
✍️ Writer 子代理执行中...
✅ 已完成所有文档内容创作

# 用户请求  
分析这个微服务架构的性能瓶颈，并提供优化方案
 
# Claude 的子代理调度
🤖 启动 general-purpose 子代理处理复杂分析任务
🔍 分析范围:
- 代码库结构分析
- 性能指标收集
- 瓶颈点识别
- 优化方案设计
 
⚙️ General-purpose 子代理执行中...
📊 性能分析报告已生成
🚀 优化建议方案已提供

# 用户请求
重构用户认证模块，并更新相关文档
 
# Claude 的子代理调度策略
🤖 启动多子代理并行处理
 
并行任务分配:
├── General-purpose 子代理
│   ├── 分析现有认证代码
│   ├── 设计新的认证架构  
│   └── 实现代码重构
└── Writer 子代理
    ├── 更新 API 文档
    ├── 编写迁移指南
    └── 创建安全说明
 
⚡ 并行执行中...
📋 代码重构完成 + 📚 文档更新完成

# 共享上下文示例
General-purpose 子代理发现:
- API 端点: /auth/login, /auth/refresh
- 认证方式: JWT + Refresh Token
- 安全特性: 2FA, OAuth 集成
 
Writer 子代理接收上下文:
✅ 基于技术分析结果编写文档
✅ 确保文档与实际实现一致
✅ 包含所有发现的安全特性

# 整合策略
1. 技术实现 (General-purpose 子代理输出)
2. 文档更新 (Writer 子代理输出)  
3. 一致性检查 (主代理协调)
4. 最终交付 (统一的完整方案)

# 子代理使用策略
## 任务分配偏好
- 内容创作 -> writer 子代理
- 复杂分析 -> general-purpose 子代理
- 配置任务 -> 对应专门子代理
 
## 并行处理策略
- 启用多子代理并行
- 最大并发数: 3
- 超时时间: 10分钟
 
## 质量控制
- 子代理结果交叉验证
- 最终结果一致性检查

# 子代理性能优化
## 缓存策略
- 启用子代理结果缓存
- 缓存有效期: 1小时
- 缓存键: 任务特征哈希
 
## 负载均衡
- 子代理负载监控
- 动态任务分配  
- 故障转移机制

# 子代理性能指标
- 任务完成率: >95%
- 平均执行时间: 按任务类型统计
- 并行效率: 时间节省比例
- 结果质量: 用户满意度评分
 
# 监控命令
claude agents status          # 查看子代理状态
claude agents performance     # 性能统计
claude agents logs           # 执行日志

# 任务描述优化
❌ 模糊的任务: "帮我改进项目"
✅ 清晰的任务: "重构用户模块的数据层，并更新相关的 API 文档和单元测试"
 
❌ 单一化任务: "只写代码，不要写文档" 
✅ 并行化任务: "重构代码的同时更新文档，确保两者保持同步"