用途:该技能用于在 Claude Code 插件中创建、添加或编写子智能体(subagent)。智能体是独立处理复杂多步任务的自主子进程;智能体面向自主工作,命令面向用户发起的操作。
主要能力:定义智能体文件结构与 YAML frontmatter 字段。name 必填,小写字母、数字、连字符,3-50 字符,首尾为字母数字,如 code-reviewer。description 必填,是触发该智能体的关键字段,需写明触发条件、2-4 个典型触发场景的散文摘要,并指向正文中的“When to invoke”小节。model 必填,可选 inherit、sonnet、opus、haiku,一般推荐 inherit。color 必填,可选 blue、cyan、green、yellow、magenta、red,不同智能体宜用不同颜色。tools 可选,为工具名数组,省略则拥有全部工具,建议按最小权限限制,如只读分析用 ["Read", "Grep", "Glob"]。
使用方式:智能体为 Markdown 文件,保存于插件的 agents/ 目录,目录下 .md 文件会被自动发现,并按插件与子目录自动命名空间。创建方法一为 AI 辅助:按指定提示模板提取意图、设计专家角色、生成系统提示、标识符、触发描述,返回含 identifier、whenToUse、systemPrompt 的 JSON,再转成带 frontmatter 的智能体文件。方法二为手动:确定标识符、编写含示例的 description、选 model、选 color、按需定义 tools、编写系统提示,保存为 agents/agent-name.md。正文即系统提示,用第二人称撰写,包含核心职责、分析过程、质量标准、输出格式与边缘情况,建议不超过 10000 字符。
验证与测试:标识符、描述(10-5000 字符)、系统提示(20-10000 字符)均有校验规则;资料提到 scripts/validate-agent.sh 与 scripts/test-agent-trigger.sh 两个工具,以及 references/ 与 examples/ 下的参考与示例文件。测试需验证触发、流程步骤、输出格式和边缘情况。限制:资料未提供安装命令、收费与价格信息。