Skip to content

AI 代理系统

Claude Code 拥有20个专业化 AI 代理,覆盖软件开发的各个职责领域。每个代理都有明确的专业分工,通过智能协作为您提供全方位的编程支持。

智能推荐系统

Claude Code 具备智能任务分析和代理推荐能力:

  • 自动匹配:基于任务关键词和上下文自动推荐最适合的代理
  • 能力评分:实时评估代理与任务的匹配度(0-100%)
  • 协作建议:推荐多代理协作的最佳组合
  • 学习优化:根据历史成功率持续优化推荐算法

快速选择指南

bash
# 智能推荐 - 只需描述任务
"我想实现一个用户认证系统" 自动推荐:架构师(85%) + 执行器(95%) + 安全专家(80%)

# 精确匹配 - 使用关键词
数据分析 数据分析师     | 性能问题 调试器
API设计 架构师         | UI界面 前端专家  
测试用例 QA工程师      | 文档编写 撰写员

按职责分类的代理系统

产品规划与管理 (4个代理)

负责产品战略、需求分析、市场研究和项目管理。

代理专业级别核心技能推荐场景匹配度
产品经理专家级PRD创建、用户故事、功能优先级、产品研究产品策略定义、需求文档、企业级产品管理90%
产品负责人高级Backlog管理、故事完善、验收标准、Sprint规划敏捷开发、团队协作、冲刺管理85%
商业分析师专业市场调研、竞品分析、头脑风暴、项目发现市场研究、竞争分析、商业洞察80%
规划师专业功能规划、需求分析、技术设计、任务分解新功能规划、开发前期准备75%

架构与设计 (3个代理)

负责系统架构、技术设计、界面设计和用户体验。

代理专业级别核心技能推荐场景匹配度
架构师大师级系统架构、代码分析、基础设施规划、企业架构项目架构设计、技术选型、性能优化95%
UI/UX设计师专家级界面设计、用户体验、设计系统、原型制作用户界面设计、交互优化、设计规范88%
UX专家👥 专业用户研究、可用性测试、交互设计、用户洞察用户体验优化、产品可用性评估82%

开发实现 (4个代理)

负责代码编写、功能实现、问题调试和性能优化。

代理专业级别核心技能推荐场景匹配度
执行器通用型编码实现、文件操作、构建部署、多语言支持具体功能开发、快速原型、任务执行95%
全栈开发者专家级全栈开发、系统集成、重构优化、最佳实践复杂应用开发、架构实现、技术重构90%
调试器专业错误诊断、性能分析、根因调查、系统监控问题排查、性能调优、系统诊断85%
移动开发专家专家级iOS/Android/Flutter/React Native、原生集成移动应用开发、跨平台方案、性能优化92%

质量保障 (3个代理)

负责代码审查、测试策略、质量控制和流程优化。

代理专业级别核心技能推荐场景匹配度
审查员专家级代码审查、安全检查、性能分析、最佳实践代码质量控制、安全审计、技术评估88%
质量保证专业测试策略、自动化测试、缺陷管理、质量体系测试规划、质量流程、持续集成86%
Scrum Master高级敏捷流程、团队协调、障碍移除、持续改进敏捷管理、团队效能、流程优化82%

文档与知识管理 (1个代理)

负责技术文档编写、内容创作和知识管理。

代理专业级别核心技能推荐场景匹配度
撰写员专家级技术写作、API文档、用户指南、多语言支持文档编写、内容创作、知识整理90%

系统编排 (2个代理)

负责任务规划、工作流协调和跨领域任务管理。

代理专业级别核心技能推荐场景匹配度
主控大师级跨领域专业知识、任务编排、智能决策复杂任务协调、多领域项目、战略规划93%
编排器专家级多代理协调、工作流管理、资源优化工作流设计、团队协作、效率优化87%

数据与分析 (2个代理)

负责数据处理、统计分析、机器学习和数据洞察提取。

代理专业级别核心技能推荐场景匹配度
数据分析师专家级数据探索、统计建模、可视化、A/B测试、洞察提取业务分析、数据报告、用户行为研究92%
AI/ML工程师专家级深度学习、模型训练、MLOps、部署优化、AI架构机器学习项目、AI应用开发、智能系统94%

基础设施与运维 (1个代理)

负责系统部署、容器化、监控和基础设施管理。

代理专业级别核心技能推荐场景匹配度
DevOps工程师专家级CI/CD、容器化、云部署、监控自动化、基础设施即代码应用部署、运维自动化、云平台管理91%

智能代理选择指南

任务类型自动匹配表

任务关键词推荐代理组合成功率平均耗时
"实现登录功能"架构师(80%) + 执行器(95%)97%2-4小时
"分析用户数据"数据分析师(95%)94%1-3小时
"优化页面性能"调试器(90%) + 前端专家(85%)91%2-6小时
"设计API接口"架构师(95%) + 后端专家(88%)96%1-2小时
"编写技术文档"撰写员(95%)98%1-2小时
"部署到云平台"DevOps工程师(95%)93%2-4小时
"移动端适配"移动开发专家(95%)92%3-6小时
"训练ML模型"AI/ML工程师(95%)89%4-8小时

按开发阶段的最佳实践

需求与规划阶段

bash
市场调研 商业分析师(80%) + 数据分析师(70%)
产品规划 产品经理(90%) + 架构师(75%)  
技术选型 架构师(95%) + 各领域专家(80%)
界面设计 UI/UX设计师(88%) + 用户体验专家(82%)

开发实现阶段

bash
功能开发 执行器(95%) | 复杂功能 全栈开发者(90%)
问题修复 调试器(85%) + 相关领域专家(75%)
性能优化 调试器(90%) + 架构师(80%)
代码审查 审查员(88%) + 安全专家(75%)

测试与部署阶段

bash
测试策略 QA工程师(86%) + 自动化专家(80%)
部署上线 DevOps工程师(91%) + 架构师(75%)
监控告警 DevOps工程师(91%) + 调试器(70%)
文档更新 撰写员(90%) + 领域专家(65%)

多代理协作推荐

高频协作组合 (成功率>90%)

bash
 经典三人组: 架构师 + 执行器 + 审查员 (96% 成功率)
 数据驱动: 数据分析师 + AI/ML工程师 + 撰写员 (94% 成功率)  
 敏捷开发: 产品经理 + 执行器 + QA工程师 (93% 成功率)
 云原生: DevOps工程师 + 架构师 + 调试器 (92% 成功率)
 移动全栈: 移动专家 + UI/UX设计师 + 执行器 (91% 成功率)

项目规模推荐

bash
 小项目 (1-3人):    执行器 + 撰写员
 中项目 (3-6人):    架构师 + 执行器 + 审查员 + QA工程师  
 大项目 (6-10人):   完整团队 + 专业领域专家
 企业级 (10+人):    所有代理 + 编排器协调

代理协作流程

标准开发流程

完整项目流程

协作模式

1. 顺序协作

bash
# 标准开发流程
用户请求 规划师(规划)  执行器(实现)  审查员(审查)  撰写员(文档)

2. 并行协作

bash
# 复杂项目分析
用户请求 架构师(结构分析) + 审查员(质量分析)  执行器(优化实现)

3. 递归协作

bash
# 迭代优化
执行器(实现) → 审查员(发现问题) → 调试器(解决问题) → 执行器(重新实现)

代理激活机制

自动激活

Claude Code 通过智能分析用户请求自动选择合适的代理:

关键词匹配

yaml
规划师: ["规划", "设计", "需求", "功能", "计划"]
架构师: ["项目", "结构", "架构", "初始化", "分析"]
执行器: ["实现", "编码", "创建", "构建", "部署"]
审查员: ["审查", "检查", "质量", "安全", "优化"]
调试器: ["调试", "错误", "问题", "修复", "性能"]
撰写员: ["文档", "说明", "教程", "注释", "README"]
产品经理: ["产品", "需求", "用户故事", "PRD", "优先级"]
UI/UX设计师: ["界面", "设计", "用户体验", "原型", "UI", "UX"]

上下文分析

  • 文件类型: 根据涉及的文件类型选择代理
  • 任务复杂度: 复杂任务可能激活多个代理
  • 项目阶段: 根据开发阶段选择主要代理

手动激活

您也可以通过以下方式手动指定代理:

bash
# 命令行激活
claude --agent=planner "设计用户认证系统"

# 交互模式切换
> @planner 我需要规划一个新功能
> @architect 分析当前项目结构
> @executor 实现登录接口

通过编排器激活

bash
# 访问编排器
> @orchestrator

# 编排器会帮您选择合适的代理
*agent analyst    # 切换到商业分析师
*agent architect  # 切换到架构师  
*agent dev        # 切换到全栈开发者
*help             # 查看所有可用命令

直接代理激活

bash
# 直接激活特定代理
> @analyst        # 商业分析师
> @po             # 产品负责人
> @dev            # 全栈开发者
> @qa             # 质量保证
> @pm             # 产品经理
> @sm             # Scrum Master
> @uiux           # UI/UX设计师

命令系统

bash
# 通用命令(所有代理支持)
*help             # 显示代理特定命令
*create-doc       # 使用模板创建文档
*execute-checklist # 执行检查清单
*yolo            # 切换快速模式
*exit            # 退出代理模式

# 特定代理命令示例
# 产品经理命令
*create-prd           # 创建PRD
*create-brownfield-prd # 创建现有项目PRD

# 架构师命令
*create-full-stack-architecture  # 创建全栈架构
*create-front-end-architecture   # 创建前端架构

# 商业分析师命令
*perform-market-research     # 执行市场研究
*create-competitor-analysis  # 创建竞品分析
*brainstorm                 # 头脑风暴会议

使用策略

按项目阶段的代理使用策略

项目启动阶段

bash
1. 商业分析师 市场研究、竞品分析
2. 架构师 分析现有代码,生成项目文档
3. 产品经理 PRD创建、需求定义
4. 规划师 规划新功能,制定开发计划

功能开发阶段

bash
1. 规划师 详细设计功能规格
2. 执行器/全栈开发者 实现核心功能
3. 审查员 代码质量检查
4. 调试器 解决发现的问题
5. 撰写员 编写功能文档

质量保证阶段

bash
1. 质量保证 测试策略、质量检查
2. 审查员 安全和质量检查
3. UX专家 用户体验优化
4. Scrum Master 流程改进、障碍移除

维护优化阶段

bash
1. 调试器 诊断性能问题
2. 执行器 实施优化方案
3. 撰写员 更新相关文档
4. 产品负责人 Backlog更新、优先级调整

敏捷开发流程中的代理协作

bash
1. 产品负责人 Backlog管理、优先级设定
2. 规划师 Sprint规划、任务分解
3. 全栈开发者 用户故事实现
4. 质量保证 持续测试、质量检查
5. Scrum Master 每日站会、障碍移除

代理个性化

自定义代理行为

每个代理都可以通过配置文件进行个性化:

yaml
# agents/custom-planner.md
---
name: senior-planner
base: planner
specialization: enterprise-architecture
additional_capabilities:
  - microservices_design
  - scalability_planning
  - security_architecture
personality:
  detail_level: high
  risk_assessment: conservative
  innovation_preference: balanced
---

代理能力扩展

yaml
# 扩展执行器能力
executor_extensions:
  - cloud_deployment
  - container_orchestration
  - ci_cd_pipeline
  - database_migration

性能监控

代理效率指标

  • 响应时间: 每个代理的平均响应时间
  • 任务成功率: 任务完成的成功率统计
  • 协作效率: 多代理协作的效率评估
  • 用户满意度: 基于用户反馈的满意度评分

监控命令

bash
# 查看代理状态
claude --agent-status

# 性能统计
claude --agent-stats

# 协作分析
claude --collaboration-report

高级配置

代理优先级设置

json
{
  "agent_priority": {
    "planner": 1,
    "architect": 2,
    "executor": 3,
    "reviewer": 4,
    "debugger": 5,
    "writer": 6
  }
}

专业领域配置

json
{
  "domain_specialization": {
    "frontend": ["executor", "reviewer"],
    "backend": ["architect", "executor"],
    "mobile": ["planner", "executor", "reviewer"],
    "devops": ["architect", "executor"]
  }
}

最佳实践

1. 明确任务分工

  • 规划阶段优先使用规划师
  • 实现阶段主要依靠执行器
  • 质量检查必须用审查员
  • 文档工作交给撰写员

2. 合理利用协作

bash
# 好的协作模式
规划师(需求分析) → 执行器(功能实现) → 审查员(质量检查)

# 避免的模式
执行器(直接实现) → 无质量检查 → 产生技术债务

3. 上下文传递

  • 确保代理间信息传递完整
  • 使用项目文档提供上下文
  • 保持会话连续性

4. 性能优化

  • 复杂任务启用 Wave 系统
  • 合理配置代理激活阈值
  • 监控代理性能指标

与检查清单系统集成

企业代理与检查清单系统紧密集成,提供完整的质量控制流程:

代理 ↔ 检查清单映射

工作流集成

bash
# 代理中直接执行检查清单
*execute-checklist architect-checklist    # 架构师检查清单
*execute-checklist pm-checklist          # 产品经理检查清单
*execute-checklist story-dod-checklist   # 故事完成检查清单

详细了解:检查清单系统

深入学习

产品规划与管理

架构与设计

开发实现

质量保障

文档与支持

协调与管理

配套系统


AI 代理系统 - 让专业的代理做专业的事

Claude Code 使用指南