3.1 子智能体 — 让多个 AI 同时干活

学习目标

学完这节课，你将能够：

• 理解子智能体的概念和工作原理
• 使用内置的 Plan、Explore、general-purpose 子智能体
• 实现"一个写代码、一个做审查"的并行工作模式
• 创建自定义子智能体来解决特定领域问题

---

什么是子智能体

你和 Claude Code 对话时，它是"一个人"在干活。但有些任务太复杂，需要多个角色协作——就像一个团队里有人写代码、有人做测试、有人审查。

子智能体（Sub-agents）就是 Claude Code 的"分身术"。主 Claude 可以派出多个独立的子智能体，每个子智能体有自己的上下文窗口、独立思考、互不干扰。主智能体负责协调，子智能体负责执行具体任务。

你 → 主智能体（Leader）
        ├── 子智能体 A：探索代码结构
        ├── 子智能体 B：编写实现代码
        └── 子智能体 C：审查代码质量

关键区别：子智能体不是"多轮对话"，而是真正的并行独立执行。它们各自拿到一份任务描述，独立完成后把结果汇报给主智能体。

---

内置子智能体

Claude Code 内置了三种子智能体，它会根据场景自动调用。

Plan 子智能体

当你使用 /plan 或者给出一个复杂需求时，Claude Code 会派出 Plan 子智能体来做规划分析。

你：帮我重构这个项目的数据库层，从 MySQL 迁移到 PostgreSQL

Plan 子智能体会独立分析受影响的文件、评估风险、输出分步骤的实施方案，然后交给主智能体展示给你确认。

[截图: Plan 子智能体输出的分步骤实施方案，能看到步骤编号和风险评估]

Explore 子智能体

遇到不熟悉的代码库时，Explore 子智能体会被派出去"侦察"。它会搜索文件、阅读源码、理解项目结构，然后把发现汇报回来。

你：这个项目的认证逻辑是怎么实现的？

Explore 子智能体会自主搜索 auth、login、session 相关的文件，追踪调用链，最后给你一份完整的认证流程分析。

[截图: Explore 子智能体在搜索和阅读多个文件后给出的架构分析]

General-purpose 子智能体

通用子智能体是最灵活的，主智能体可以给它任何任务。最常见的用途是代码审查——写完代码后，派一个独立的子智能体来"用新鲜的眼睛"审查刚写的代码。

[截图: 代码审查子智能体输出的审查报告，包含问题等级和修复建议]

---

实战：一个写代码，一个做审查

这是子智能体最经典的应用场景。来看一个真实的工作流：

第一步：描述需求

你：帮我实现一个用户注册功能，包含邮箱验证和密码强度校验。
    写完之后请用独立的子智能体审查代码质量。

第二步：Claude Code 自动编排

主智能体会先自己（或派子智能体）完成编码，然后派出一个全新的子智能体来审查。审查子智能体看到的是"别人写的代码"，不会有"自己写的所以没问题"的盲区。

第三步：审查与修复

审查子智能体会从这几个维度检查：

• 逻辑正确性：注册流程是否完整
• 边界情况：空邮箱、超长密码、重复注册
• 安全问题：密码是否明文存储、SQL 注入风险
• 代码风格：命名、注释、文件组织

如果发现问题，主智能体会修复后再次提交审查，直到通过。

[截图: 完整的"编码→审查→修复→通过"流程在终端中的展示]

---

自定义子智能体

内置子智能体不够用？你可以创建自己的。

在 ~/.claude/agents/ 目录下创建 Markdown 文件，定义子智能体的角色和行为：

# 创建 agents 目录
mkdir -p ~/.claude/agents

# 创建一个安全审查子智能体
touch ~/.claude/agents/security-reviewer.md

文件内容示例：

# Security Reviewer

## Role
你是一个专注于安全审查的代码审查员。

## Checklist
每次审查必须检查以下项目：
- [ ] 无硬编码密钥或密码
- [ ] 所有用户输入已验证和转义
- [ ] SQL 查询使用参数化方式
- [ ] API 端点有认证和授权检查
- [ ] 敏感数据不出现在日志中
- [ ] 错误信息不泄露内部细节

## Output Format
按 CRITICAL / HIGH / MEDIUM / LOW 分级报告问题。

创建完成后，Claude Code 在需要安全审查时就会调用这个自定义子智能体。

[截图: ~/.claude/agents/ 目录下的多个自定义子智能体文件]

更多自定义子智能体的思路：

子智能体	用途	适合场景
tdd-guide.md	测试驱动开发引导	新功能开发
architect.md	架构设计评审	系统设计决策
doc-updater.md	文档同步更新	代码变更后更新文档
performance-reviewer.md	性能审查	数据库查询、API 响应优化

---

小结

• 子智能体是 Claude Code 的"分身术"，可以并行处理多个独立任务
• 三个内置子智能体：Plan（规划）、Explore（探索）、General-purpose（通用）
• 最佳实践：写完代码后总是用独立子智能体做审查，避免"自己审自己"的盲区
• 通过 ~/.claude/agents/ 目录创建自定义子智能体，扩展专业能力
• 子智能体之间上下文隔离，不会互相污染，但也意味着每个子智能体需要足够的任务描述

安全提示：自定义子智能体的 Markdown 文件会影响 AI 的行为。不要从不可信来源直接复制子智能体配置文件，务必审查其内容，防止提示词注入攻击。