用途:创建与配置 Claude Code 智能体文件(.claude/agents/*.md),包含 YAML frontmatter、工具权限、模型选择与系统提示结构。智能体文件放在项目目录 .claude/agents/ 或用户目录 ~/.claude/agents/,项目级智能体在同名时覆盖用户级。
主要能力:frontmatter 控制智能体的发现与调用,markdown 正文编码其行为。frontmatter 字段包括 name(必填,kebab-case,最多 64 字符,须与文件名一致)、description(必填,第三人称、主动语态,需含“Use when”触发条件)、tools(可选,逗号分隔,省略则继承全部工具)、model(可选,haiku/sonnet/opus/inherit)、skills(可选,可调用的技能名)。描述质量直接决定调用准确度,推理按描述直接匹配。工具声明用于限定权限:只读为 Read、Glob、Grep;可写为 Read、Edit、Write、Glob、Bash;编排为 Task、Read、Glob、TodoWrite;省略字段则继承全部工具。模型选择在能力、延迟与成本间权衡:opus 适合复杂推理与多文件范围,sonnet 适合常规开发,haiku 适合快速查找与过滤,inherit 跟随会话默认。命名使用角色型、动作型或领域型,kebab-case,文件名与 name 字段一致。
使用方式:读取 index.md、frontmatter.md、prompt.md、workflow.md 等参考文件,加载 style-standards 技能,按工作流执行 UNDERSTAND、ACQUIRE、RESEARCH、AUTHOR、VALIDATE 五个阶段,并通过验证质量门检查。可使用 agent.template.md 模板,验证清单见 validation.md。
适用场景:构建或修改 Claude Code 智能体、配置子智能体、设置工具权限与模型、编写系统提示结构时使用。
限制:描述须避免 might、could、should、probably 等模糊词;不要使用 helper、processor、agent 等泛化名称,不使用下划线或混合大小写;不在 tools 列表中缺少 Read 的情况下引用 @path;只读型 reviewer 应限定只读工具。资料未提供安装命令、收费与价格信息。