子代理创建器

为 Claude Code 创建专业化的 AI 子代理，以处理特定任务和自定义的提示访问权限。

子代理文件格式

子代理是存储在以下位置的带 YAML 前置内容的 Markdown 文件：

• 项目: .claude/agents/ (较高优先级)

• 用户: ~/.claude/agents/ (较低优先级)

结构

name: 子代理名称 description: 使用此子代理的时机 (包含"use proactively"以实现自动委派) tools: 工具1, 工具2, 工具3 # 可选 - 如果省略则继承所有工具 model: sonnet # 可选 - sonnet/opus/haiku/inherit permissionMode: default # 可选 - default/acceptEdits/bypassPermissions/plan skills: 技能1, 技能2 # 可选 - 自动加载技能

系统提示放在这里。定义角色、职责和行为。

配置字段

字段 必需 描述

name

是 小写字母加连字符

description

是 用途和使用时机（自动委派的关键）

tools

否 逗号分隔的工具列表（省略以继承所有）

model

否 sonnet 、opus 、haiku 或 inherit

permissionMode

否 default 、acceptEdits 、bypassPermissions 、plan

skills

否 要自动加载的技能

创建工作流程

• 收集需求：询问子代理的用途、使用时机和所需能力

• 选择范围：项目 (.claude/agents/ ) 或用户 (~/.claude/agents/ )

• 定义配置：名称、描述、工具、模型

• 编写系统提示：明确的角色、职责和输出格式

• 创建文件：将 .md 文件写入适当位置

编写有效的子代理

描述最佳实践

description 字段对于自动委派至关重要：

良好 - 具体的触发条件

description: 代码审查专家。在编写或修改代码后主动使用。

良好 - 清晰的用例

description: 专门处理错误、测试失败和异常行为的调试专家。

不佳 - 过于模糊

description: 帮助处理代码

系统提示指南

• 明确定义角色："你是[特定专家角色]"

• 列出调用时的操作：首先做什么

• 指定职责：子代理处理什么

• 包含指导原则：约束和最佳实践

• 定义输出格式：如何组织响应

工具选择

• 只读任务：Read、Grep、Glob、Bash

• 代码修改：Read、Write、Edit、Grep、Glob、Bash

• 完全访问：省略 tools 字段

完整工具列表请参见 references/available-tools.md。

子代理示例

完整示例请参见 references/examples.md：

• 代码审查员

• 调试专家

• 数据科学家

• 测试运行器

• 文档编写者

• 安全审计员

模板

从 assets/subagent-template.md 复制以开始新的子代理。

快速开始示例

创建一个代码审查子代理：

mkdir -p .claude/agents

写入 .claude/agents/code-reviewer.md ：

name: code-reviewer description: 审查代码质量和安全性。在代码更改后主动使用。 tools: Read, Grep, Glob, Bash model: inherit

你是一位资深代码审查员。

被调用时：

1. 运行 git diff 查看更改
2. 审查修改的文件
3. 按优先级报告问题

重点关注：

• 代码可读性
• 安全漏洞
• 错误处理
• 最佳实践