教程概述

oh-my-claudecode 的核心优势之一是其专业代理系统。32 个精心设计的代理各司其职，配合智能模型路由，让每个任务都能找到最合适的执行者。

你将学到

• ✅ 32 个专业代理的分类与用途
• ✅ 智能模型路由机制
• ✅ 委托规则和最佳实践
• ✅ 代理选择指南

代理系统概览

为什么需要专业代理？

flowchart LR
    A[通用代理] --> B[所有任务]
    B --> C[质量不稳定]
    C --> D[效率低下]

    E[专业代理] --> F[按需分配]
    F --> G[质量保证]
    G --> H[效率最优]

    style A fill:#ffebee
    style E fill:#e8f5e9

代理分类架构

mindmap
  root((32 专业代理))
    只读代理
      Explore 探索
      Plan 规划
      Analyst 分析
      Architect 架构
    执行代理
      Executor 执行器
      Debugger 调试器
      Designer 设计师
      Test-Engineer 测试工程师
    审查代理
      Code-Reviewer 代码审查
      Critic 评论家
      Verifier 验证器
      Security-Reviewer 安全审查
    专业代理
      Writer 写作
      Scientist 科学家
      Document-Specialist 文档专家
      Git-Master Git 专家

代理详解

只读代理（无写权限）

这些代理专注于分析和规划，不能修改文件。

执行代理（可写文件）

这些代理拥有完整的工具访问权限，可以读取、编辑、写入文件和执行命令。

审查代理（质量保证）

这些代理专注于验证和审查，确保交付质量。

专业代理（特定领域）

智能模型路由

模型层级

flowchart TD
    A[任务分析] --> B{复杂度评估}
    B -->|低| C[Haiku]
    B -->|中| D[Sonnet]
    B -->|高| E[Opus]

    C --> F[快速响应]
    D --> G[平衡性能]
    E --> H[深度推理]

    style C fill:#e8f5e9
    style D fill:#fff3e0
    style E fill:#e1f5ff

路由规则

成本优化

pie title 模型使用比例（推荐配置）
    "Haiku (快速任务)" : 30
    "Sonnet (标准任务)" : 50
    "Opus (复杂任务)" : 20

成本节省：智能路由可节省 30-50% 的 token 消耗。

委托规则

何时委托？

flowchart TD
    A[收到任务] --> B{是否简单？}
    B -->|是| C{是否频繁？}
    B -->|否| D{是否多步骤？}

    C -->|是| E[直接执行]
    C -->|否| F[直接执行]

    D -->|是| G{是否多文件？}
    D -->|否| H[评估委托]

    G -->|是| I[委托代理]
    G -->|否| H

    H --> J{是否需要专业视角？}
    J -->|是| I
    J -->|否| E

    style E fill:#e8f5e9
    style I fill:#e1f5ff

委托清单

✅ 应该委托：

• 多文件修改
• 需要专业视角（安全、架构、UI）
• 复杂调试
• 代码审查
• 测试编写

❌ 不应委托：

• 单行修改
• 简单查询
• 快速原型
• 文件读取

代理选择指南

按任务类型选择

flowchart TD
    A[任务类型] --> B{分类}

    B -->|架构设计| C[Architect]
    B -->|功能实现| D[Executor]
    B -->|UI 开发| E[Designer]
    B -->|调试修复| F[Debugger]
    B -->|测试编写| G[Test-Engineer]
    B -->|代码审查| H[Code-Reviewer]
    B -->|安全审计| I[Security-Reviewer]
    B -->|文档撰写| J[Writer]
    B -->|数据分析| K[Scientist]

    style C fill:#e1f5ff
    style D fill:#e8f5e9
    style E fill:#fff3e0

按复杂度选择

按质量要求选择

实战案例

案例 1：新功能开发

# 步骤 1：架构设计
/team 1:architect "design the payment system architecture"

# 步骤 2：功能实现
/team 3:executor "implement the payment flow"

# 步骤 3：代码审查
/team 1:code-reviewer "review the payment module code"

案例 2：安全审计

# 步骤 1：安全审查
/team 2:security-reviewer "audit the authentication module for OWASP top 10"

# 步骤 2：修复漏洞
/team 2:executor "fix the identified security issues"

# 步骤 3：验证修复
/team 1:verifier "verify the security fixes are complete"

案例 3：UI 重构

# 步骤 1：设计评审
/team 1:designer "redesign the dashboard layout"

# 步骤 2：实现组件
/team 2:designer "implement the new dashboard components"

# 步骤 3：测试验证
/team 1:test-engineer "add visual regression tests"

自定义代理

代理配置文件

代理定义在 .claude/agents/ 目录：

# .claude/agents/my-custom-agent.md

---
name: My Custom Agent
description: A custom agent for specific tasks
tools: [Read, Write, Edit, Bash]
model: sonnet
---

You are a specialized agent for [specific domain].
Your responsibilities include:
1. [responsibility 1]
2. [responsibility 2]

When working, you should:
- [guideline 1]
- [guideline 2]

工具限制

# 只读代理
tools: [Read, Grep, Glob]

# 执行代理
tools: [Read, Write, Edit, Bash]

# 受限代理
tools: [Read, Write]  # 无 Bash 访问

最佳实践

1. 匹配代理与任务

# ✅ 正确
/team 1:architect "design the system"
/team 1:executor "implement the design"

# ❌ 错误
/team 1:executor "design the system"  # Executor 不擅长架构设计

2. 组合使用代理

flowchart LR
    A[Architect 设计] --> B[Executor 实现]
    B --> C[Code-Reviewer 审查]
    C --> D[Verifier 验证]

    style A fill:#e1f5ff
    style B fill:#e8f5e9
    style C fill:#fff3e0
    style D fill:#f3e5f5

3. 避免过度委托

# ✅ 好：直接执行简单任务
# 直接说 "add a comment to function X"

# ❌ 坏：委托简单任务
/team 1:executor "add a comment to function X"

常见问题

Q1：如何查看可用代理？

# 查看代理列表
omc agents list

# 查看代理详情
omc agents show executor

Q2：代理可以创建子代理吗？

执行代理可以创建子代理，但有规则：

• 不能创建同级代理（避免无限递归）
• 只读代理不能创建任何代理
• 子代理继承父代理的限制

Q3：如何限制代理的文件访问？

在代理配置中设置：

restrictions:
  allowed_paths:
    - src/
    - tests/
  forbidden_paths:
    - .env
    - credentials/

小结

32 个专业代理配合智能路由，让 oh-my-claudecode 成为强大的多面手：

关键要点

• ✅ 按任务类型选择正确代理
• ✅ 理解模型路由的成本优化
• ✅ 组合使用代理获得最佳效果
• ✅ 避免过度委托简单任务

代理速查表

系列导航：

• ← 上一篇：教程 5：Magic Keywords 与 Deep-Interview
• → 下一篇：教程 7：Skills 系统自定义技能
• 返回：教程系列索引