name: 创建智能体 description: | 创建Claude Code子智能体用于任务委派。指导智能体配置、工具选择和系统提示编写。当用户想要创建新智能体、将任务委派给专家或询问子智能体时使用此技能。

创建智能体

指导创建Claude Code子智能体用于任务委派。

快速开始

定义智能体用途（处理什么任务？）
选择存储位置（项目级或用户级）
选择工具（所需的最小工具集）
编写系统提示
保存到.claude/agents/目录

工作流程：创建新智能体

进度：
- [ ] 定义用途和触发条件
- [ ] 选择存储位置
- [ ] 选择工具和模型
- [ ] 编写系统提示
- [ ] 创建智能体文件

步骤1：定义用途

询问用户：

此智能体应处理什么具体任务？
何时应调用它？（触发短语）
应主动运行还是按需运行？

步骤2：选择位置

位置	路径	用途
项目级	`.claude/agents/`	团队共享，项目特定
用户级	`~/.claude/agents/`	个人使用，跨项目

项目级智能体优先级高于用户级智能体。

步骤3：选择工具和模型

工具 - 授予最小所需权限：

工具	用途
读取	读取文件
写入	创建文件
编辑	修改文件
全局搜索	查找文件
内容搜索	搜索内容
Bash	运行命令
任务	生成子智能体

模型 - 根据任务选择：

模型	最适合
`opus`	复杂推理，细微决策
`sonnet`	通用任务（默认）
`haiku`	快速查找，简单分析
`inherit`	使用父级模型

步骤4：编写系统提示

保持提示聚焦：

清晰说明智能体角色
定义范围和约束
提供示例（如有帮助）
避免不必要的细节

步骤5：创建智能体文件

---
name: {智能体名称}
description: {何时使用 - 包含触发词}
tools: 读取, 内容搜索, 全局搜索
model: sonnet
---

{系统提示内容}

保存到.claude/agents/{名称}.md

智能体文件格式

---
name: 智能体名称          # 必需：小写，连字符
description: |            # 必需：何时调用
  审查代码质量问题。
  当用户要求代码审查时使用。
tools: 读取, 内容搜索, 全局搜索   # 可选：省略则继承所有
model: sonnet             # 可选：opus, sonnet, haiku, inherit
permissionMode: default   # 可选：权限处理模式
skills: 技能1, 技能2    # 可选：自动加载技能
---

定义智能体行为的系统提示。

内置智能体

创建自定义智能体前，了解内置智能体：

智能体	模型	工具	用途
通用目的	sonnet	全部	复杂多步骤任务
规划	haiku	读取, 全局搜索, 内容搜索, Bash	研究和策略
探索	haiku	读取, 全局搜索, 内容搜索	快速代码库探索

何时创建自定义智能体：

需要不同的工具限制
需要领域特定的提示
需要主动调用

何时使用每种类型

需求	使用
快速文件搜索	内置`探索`智能体
规划前的研究	内置`规划`智能体
多步骤代码变更	内置`通用目的`智能体
具有特定规则的代码审查	自定义审查智能体
安全分析	自定义安全智能体
领域专业知识（数据库、API等）	自定义专家智能体

主动调用

要让Claude自动使用您的智能体，请在描述中包含：

“主动"或"必须使用”
清晰的触发条件

description: |
  主动审查所有代码变更提交前。
  当用户提到"审查"或"检查代码"时必须使用。

模板

使用templates/目录中的模板：

templates/reviewer.md - 代码审查智能体
templates/researcher.md - 只读研究智能体
templates/specialist.md - 领域专家智能体

查看reference.md获取完整配置详情。