用途：创建和维护 Claude Code 智能体/子智能体，文件位于 .claude/agents/<agent-name>.md（文件名用 kebab-case）。核心目标是行为可预测、工具最小权限、委派契约明确。
创建步骤：在 .claude/agents/ 下新建 agent 文件；添加 YAML frontmatter（name、description 必填；tools、model、permissionMode、skills、hooks 选填）；编写智能体提示词，包含职责、工作流和输出契约；从只读工具起步，按真实需要再添加；在真实任务上测试并迭代。
字段要点：name 必填，kebab-case 且与文件名（去 .md）一致；description 必填，写明何时调用、做什么，含用户会说的关键词，单行且面向触发；tools 选填，为显式允许列表，尽量小而专用；model 选填，haiku 用于快速检查、sonnet 用于多数任务、opus 用于高风险推理、inherit 与父级一致；permissionMode 选填，优先默认，改动需有明确理由；skills 选填，按需预加载领域技能包并保持最小；hooks 选填，用于自动化防护。
推荐实践：使用小型专用智能体，避免“全能智能体”；提示词保持简短，仓库约定放 CLAUDE.md/项目记忆，领域知识放 skills；控制上下文，传文件路径、最小片段与约束，避免倾倒长日志或代码；子智能体委派时写明目标、约束、输入与输出契约；高风险变更（安全、迁移、基础设施、认证）增加验证步骤。
工具语义与权限模式参见 references/agent-tools.md，编排与反模式参见 references/agent-patterns.md。校验清单：frontmatter 的 name 与文件名一致、description 单行且面向触发、tools 最小、model 匹配风险；提示词职责具体、工作流可执行、输出契约明确；委派简报具体且有边界，由编排者验证集成；确认破坏性操作，避免机密/PII。CLI 字段与功能可能变化，应以官方文档为准。具体安装命令与收费方式资料未提供。