我拿 Claude Code 子代理搭了一套 PR 自动审查工作流，效率翻倍还省了 token

最近我把 Claude Code 的子代理（Subagents）和 Agent Teams 整套扒了一遍，照着官方文档把一套「PR 自动审查」的工作流搭了出来。

先说结果：以前一个代码审查要盯着终端看 Claude 一行行吐、占满整个上下文，现在拆成几个专职子代理并行跑，主对话基本只剩一句结论，token 占用直接下来了，审查还更全面。这套玩法不是玄学，全是官方文档里白纸黑字写的配置，下面带你照着做。

一、子代理到底在干什么

子代理的本质就一句话：当一个辅助任务（搜代码、查日志、读一堆文件）会把你的主对话上下文塞爆、而且你之后用不到那些原始结果时，就丢给一个子代理，让它在自己独立的上下文里跑完，只把摘要带回来。

官方文档原话：

> 子代理是处理特定类型任务的专门 AI 助手。每个子代理在自己的 context window 中运行，具有自定义系统提示、特定的工具访问权限和独立的权限。

四个直接好处：

• 保留上下文——把探索和实现留在主对话之外；
• 强制约束——限制子代理能用的工具；
• 跨项目复用——用户级子代理放 ~/.claude/agents/，全机器通用；
• 控制成本——把任务路由到更快更便宜的模型（比如 Haiku）。

二、五个内置子代理

Claude Code 自带几个子代理，自动就会用，但你得知道各自边界：

• Explore：Haiku，只读，找文件、搜代码、摸清代码库
• Plan：继承主模型，只读，plan mode 下做规划前的研究
• general-purpose：继承主模型，全部工具，复杂多步骤任务
• statusline-setup：Sonnet，部分工具，配 /statusline
• claude-code-guide：Haiku，部分工具，回答 Claude Code 功能问题

Explore 调用时指定彻底程度——quick（定点找）、medium（平衡）、very thorough（全面扫）。别无脑全用最重的。

三、手把手建你自己的第一个子代理

子代理就是一个带 YAML frontmatter 的 Markdown 文件。两种建法：交互式（推荐）和手写。

交互式：敲 /agents 打开子代理管理界面 → 切 Library 选 Create new agent → 选范围（项目级 .claude/agents/ 可进版本控制，用户级 ~/.claude/agents/ 全机器通用）→ 选 Generate with Claude 用一句话描述 → 砍工具（只读审查者把 Edit/Write 全取消）→ 选模型（审查 Sonnet、文档 Haiku 省钱）→ 保存。

手写（可复现、能提交进 git）：直接在 .claude/agents/ 放个 .md，我这套 PR 审查用的就是这种，全文贴在下面可直接抄：

---

name: pr-reviewer

description: Reviews staged changes for bugs, security issues, and code quality. Use proactively before commits and PRs.

tools: Read, Grep, Glob, Bash

model: sonnet

---

You are a senior code reviewer. Review the current staged changes (use git diff --staged).

For each file changed, check:

Security

• Input validation on user-facing endpoints
• No hardcoded secrets or credentials
• Proper authentication/authorization checks

Quality

• Functions under 50 lines
• Clear naming conventions
• No duplicated logic
• Error handling for edge cases

Output Format

For each issue found:

• File: path/to/file.ts:42
• Severity: High / Medium / Low
• Issue: Description
• Fix: Suggested resolution

调用就一句话：Use the pr-reviewer agent to review my staged changes。

几个文档点名的坑：tools 按「最小够用」砍；description 里写 "proactively"，Claude 才会自动派活；模型能降级就降级，别全上 Opus。

四、升级到 Agent Teams：把 PR 审查做成流水线

单个子代理审查 PR 还差口气。真正的提效是拆成一支队伍并行覆盖不同维度，文档给了直接能用的提示词：

Create an agent team to review PR #142.

Spawn three reviewers:

1. One focused on security implications

2. One checking performance impact

3. One validating test coverage

Have them each review and report findings.

一个 Lead 负责汇总。还有个高级玩法——对抗式排查：根因不明的 bug，开一队互相对抗的子代理各自押假设、再去证伪别的，像科学辩论一样把站不住脚的理论筛掉。

省钱小技巧：子代理跑的时候按 Ctrl+B 丢后台，主对话继续干别的，它跑完自动弹结果，用 /tasks 看进度。等于把子代理从「阻塞等待」变成「真并行」。

五、避坑清单（全是文档写明的错法）

1. 别给琐事开子代理——改个 typo，子代理的开销把收益全吃掉了；

2. 别造一堆重叠角色——「安全专家、渗透测试员、漏洞扫描器」四个本质是一回事，选真正互补的不同维度；

3. 关键代码先开 plan mode（连按两次 Shift+Tab）再放子代理，避免它们直接动手改；

4. 并行子代理千万别碰同一批文件。

判断用哪套架构：代码单一关注点用单 Agent；需隔离上下文用 Custom Subagent；子任务可并行用 Parallel Subagents；要互相通信用 Agent Team；顺序依赖、改同一文件用单 session 或 Sequential Subagents。一句话：能用最简单的就别上最重的。

实操总结

把子代理/Agent Teams 当成一套「可复用、可进版本控制、能省钱」的工作流资产，而不是一堆零散的「让 AI 跑快一点」的咒语，这才是真正的价值。照上面那份 pr-reviewer 配置抄一份进你的 .claude/agents/，下个 PR 审查直接 @pr-reviewer，你会立刻感觉到主对话干净了一大截。

官方子代理文档（含完整 frontmatter 字段、/agents 界面、决策表）：https://code.claude.com/docs/sub-agents