Claude Code 的子代理系统允许你委派专门任务，实现上下文隔离与并行工作。Claude HowTo 教程指南仓库提供了 9 个开箱即用的子代理定义模板，覆盖代码审查、测试、文档、调试、性能优化等核心开发场景。本文将完整引用这些模板，并重点剖析其权限模型、model 选择策略及设计哲学，助你快速构建高效的 AI 协作工作流。
9 个子代理模板：从代码审查到性能优化的完整代理定义
在复杂项目中，让 Claude Code 主代理一次性处理所有任务容易导致上下文污染和效率低下。子代理系统通过创建具有独立上下文窗口的专用 AI 助手来解决这个问题。Claude HowTo 教程指南仓库为此提供了 9 个精心设计的生产级子代理模板，它们代表了从只读审计到全功能实现的不同权限级别和专业化方向。
子代理的核心价值与设计模式
子代理并非主代理的简单复制品。每个模板都通过 YAML frontmatter 中的 tools、model 等字段，明确定义了其能力边界和行为模式，这体现了“最小权限”和“专业分工”的核心设计原则。主代理可以根据任务描述自动委派，或由用户通过 @ 提及显式调用。在深入了解具体模板前，可以参考 Claude HowTo 完全指南 了解其在整个功能体系中的位置。
9 个子代理模板深度解析
以下模板均可在仓库的 04-subagents/ 目录找到。每个 .md 文件都包含完整的系统提示和配置，是可直接复制的生产级定义。
1. code-reviewer.md - 通用代码审查专家
这是最通用的审查代理。它通过 git diff 捕获变更，并按照安全、性能、质量、测试、设计的优先级清单进行检查。其输出结构清晰，包含严重性、类别、位置、问题描述和修复建议。
关键配置：
tools: Read, Grep, Glob, Bash
model: inherit选择 inherit 模型意味着它继承主代理的能力，在大多数情况下能获得最佳平衡。授予 Bash 工具使其能执行 git diff 等命令来主动发现变更。
2. test-engineer.md - 测试自动化专家
专注于测试策略制定、覆盖率分析和自动化测试编写。它要求遵循项目现有测试框架，并设定了80%的最低覆盖率目标（关键路径100%）。
关键配置：
tools: Read, Write, Bash, Grep
model: inherit拥有 Write 权限是其能够创建测试文件的基础。结合 Bash，它可以运行测试以验证其工作成果。
3. documentation-writer.md - 技术文档专家
旨在创建清晰、全面的技术文档，包括 API 文档、用户指南和架构说明。它强调文档的清晰性、示例完备性和准确性。
关键配置：
tools: Read, Write, Grep
model: inheritRead 和 Grep 用于分析代码，Write 用于生成文档。它不需要 Bash 或 Edit，因为其主要产出是新文件而非修改现有代码。
4. secure-reviewer.md - 安全审计员（最小权限典范）
这是体现最小权限设计的模板。它被严格限制为只读模式，专注于识别安全漏洞，其设计哲学是“在安全审计期间不能意外破坏任何东西”。
关键配置：
tools: Read, Grep
model: inherit仅有 Read 和 Grep 权限，意味着它只能阅读文件和搜索模式（如 grep -r "password\s*="），无法写入、编辑或执行任何命令。这确保了审计过程的绝对安全。
5. implementation-agent.md - 全栈实现专家（完整工具访问）
这是拥有最全面工具集的模板，用于端到端的功能实现。它遵循从理解需求、分析模式到增量实现、测试和重构的完整开发流程。
关键配置：
tools: Read, Write, Edit, Bash, Grep, Glob
model: inherit授予了 Read、Write、Edit、Bash、Grep、Glob 全部六种核心工具。这使得它能够阅读规格说明、编写和修改代码、运行构建命令、在整个代码库中搜索和查找文件，具备一个高级开发者所需的全部操作能力。
6. debugger.md - 调试专家
专注于根因分析，遵循一个严谨的调试流程：捕获错误、检查变更、形成假设、隔离故障、实施并验证修复。
关键配置：
tools: Read, Edit, Bash, Grep, Glob
model: inherit拥有 Edit 权限以便实施最小修复，Bash 用于运行诊断命令和测试。没有 Write，暗示其修改应局限于现有文件的精确诊疗。
7. data-scientist.md - 数据科学专家
专门为 SQL 查询、BigQuery 操作和数据分析优化。它强调编写优化的 SQL 查询并提供数据驱动的见解。
关键配置：
tools: Bash, Read, Write
model: sonnet这是少数明确指定 model: sonnet 而非 inherit 的模板。选择 sonnet 可能是因为数据科学和复杂 SQL 查询通常需要更强的推理能力，而 sonnet 模型在此方面表现优异。工具组合支持通过 Bash 运行查询（如 bq 命令），Read/Write 用于处理数据和结果。
8. clean-code-reviewer.md - Clean Code 原则审查专家
这是一个专门针对 Clean Code 理论的审查代理。它以 Robert C. Martin 的原则为框架，系统性地检查代码在命名、函数、结构、SOLID/DRY/KISS/YAGNI 原则、错误处理和代码“坏味道”方面的违规情况。
关键配置：
tools: Read, Grep, Glob, Bash
model: inherit与通用 code-reviewer 类似，但系统提示内容完全不同。它提供了一个从“严重”（如函数超50行）到“低”的详细严重性级别定义，输出格式严格遵循其自定义的审查报告结构。
9. performance-optimizer.md - 性能优化专家
这是一个拥有全栈优化检查清单和丰富性能分析命令的专家。它覆盖算法、数据库、后端、前端和内存等多个维度的性能问题。
关键配置：
tools: Read, Edit, Bash, Grep, Glob
model: inheritEdit 权限用于实施优化，Bash 用于运行各种性能剖析命令（如 Node.js 的 --prof、Python 的 cProfile、Go 的 pprof、数据库的 EXPLAIN ANALYZE 等）。其优化清单详尽实用，从算法复杂度（Big O）到 N+1 查询、HTTP 压缩等均有涵盖。
模型选择策略：inherit vs sonnet
从这9个模板中可以清晰看出模型选择策略：
- 绝大多数代理使用
model: inherit：如code-reviewer、test-engineer、implementation-agent等。这意味着它们的能力将跟随主代理配置，提供了最佳的灵活性和一致性。 - 特定任务代理可指定更强模型：
data-scientist明确使用model: sonnet，可能因为数据分析任务对推理要求极高。这也表明，当任务需要超越主代理模型的能力时，可以通过指定模型来定制代理。
如何安装与使用这些模板
要将这些模板引入你的项目，只需一条命令：
# 将模板文件复制到你项目的 .claude/agents/ 目录
cp 04-subagents/*.md .claude/agents/复制完成后，删除 README 文件，然后在项目中使用 /agents 命令即可看到并管理这些新代理。详细安装和验证步骤可参考仓库的子代理系统指南。
子代理与工作流集成
这些模板并非孤立使用。例如，你可以先让 implementation-agent 实现一个功能，然后链式调用 secure-reviewer 和 clean-code-reviewer 进行审计，最后用 performance-optimizer 分析性能。每个代理都在其隔离的上下文中工作，结果被提炼回主代理进行综合决策，这避免了单个代理上下文过长的“疲劳”问题。
FAQ
Q: 这些子代理和斜杠命令有什么区别？ A: 斜杠命令是用户直接调用的快捷指令，通常在同一个上下文中执行。子代理则是具有独立上下文的专用AI助手，更适合复杂的、需要隔离环境的任务，其调用可以是自动委派或显式指定。你可以查阅 Claude Code 斜杠命令全解析 了解更多。
Q: 我如何根据项目需求修改这些模板？
A: 每个 .md 文件都是一个标准的模板。你可以直接编辑 YAML frontmatter 中的 tools、model 等字段来调整权限，或者修改 --- 以下的 Markdown 内容来定制系统提示，以更符合你的技术栈和团队规范。
Q: model: inherit 具体是什么意思？
A: 这意味着该子代理将使用与启动它的主代理相同的模型。例如，如果你的主代理配置使用 claude-sonnet-4-20250514，那么所有 model: inherit 的子代理也将使用该模型。这确保了能力的一致性，并简化了配置管理。