claude-code/docs/agent/sub-agents.mdx
2026-04-01 09:16:41 +08:00

70 lines
2.3 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: "子 Agent分身术"
description: "当一个 AI 不够用时,它会召唤更多的自己"
---
{/* 本章目标:解释子 Agent 机制的设计和应用场景 */}
## 为什么需要子 Agent
有些任务太大,一个 AI 实例忙不过来:
- "在 5 个不同的文件中分别找到并修复同类 bug"
- "一边重构后端 API一边更新前端调用"
- "研究这个库的用法,同时修改我们的代码"
## 分身术的运作方式
Claude Code 中的 Agent 工具让 AI 能够**启动另一个 AI 实例**来处理子任务:
<Steps>
<Step title="主 Agent 分析任务">
主 Agent 判断任务可以被拆解为独立的子任务
</Step>
<Step title="启动子 Agent">
通过 Agent 工具创建一个或多个子 Agent每个子 Agent 收到一个清晰的子任务描述
</Step>
<Step title="并行执行">
多个子 Agent 可以同时工作,互不干扰
</Step>
<Step title="结果汇总">
子 Agent 完成后,结果返回给主 Agent主 Agent 汇总并呈现给用户
</Step>
</Steps>
## 子 Agent 的边界
子 Agent 不是和主 Agent 完全一样的——它有明确的能力边界:
| 特性 | 主 Agent | 子 Agent |
|------|---------|---------|
| 可用工具 | 全部工具 | 受限子集(不能再启动子 Agent 等) |
| 上下文 | 完整的会话历史 | 只有主 Agent 给的任务描述 |
| 权限 | 用户设定 | 继承主 Agent 的权限,或更严格 |
| 状态 | 可修改全局状态 | 隔离的状态空间 |
## 通信方式
主 Agent 和子 Agent 之间通过**消息邮箱**通信:
- 主 Agent 通过 `Agent` 工具启动子 Agent
- 子 Agent 通过 `SendMessage` 工具向主 Agent 报告进度
- 这种松耦合的通信方式让 Agent 可以异步协作
## 适用场景
<CardGroup cols={2}>
<Card title="并行研究" icon="magnifying-glass">
多个子 Agent 同时搜索不同方向的信息
</Card>
<Card title="分治修改" icon="code-branch">
把大规模修改拆分到多个子 Agent 并行执行
</Card>
<Card title="前后台配合" icon="layer-group">
一个子 Agent 在后台运行测试,主 Agent 继续写代码
</Card>
<Card title="隔离实验" icon="flask">
在 worktree 中启动子 Agent 尝试一个方案,不影响主分支
</Card>
</CardGroup>