用途:该技能用于指导开发 Claude Code 插件中的子智能体(sub-agent)。智能体是自主子进程,可独立处理复杂的多步骤任务;命令面向用户主动发起的操作,而智能体面向自主工作。
主要能力:说明智能体 Markdown 文件格式与 YAML frontmatter 字段,包括 name(必填,小写字母、数字、连字符,3-50 字符,首尾须为字母数字)、description(必填,最关键,需含触发条件与 2-4 个 <example> 示例)、model(inherit/sonnet/opus/haiku,推荐 inherit)、color(blue、cyan、green、yellow、magenta、red)、tools(可选,按最小权限限制工具)、permissionMode(default、acceptEdits、bypassPermissions、plan、ignore)、skills(可选,逗号分隔自动加载)、capabilities(可选,仅插件子智能体)。正文即系统提示词,用第二人称书写,包含核心职责、分析流程、质量标准、输出格式与边界情况,建议 500-3000 字符、不超过 10000 字符。
使用方式:可 AI 辅助生成(按给定提示词模式产出 identifier、whenToUse、systemPrompt 的 JSON 再转为文件),或手动创建并保存为 agents/agent-name.md;agents/ 目录下 .md 文件会被自动发现并按插件命名空间调用。可用 scripts/validate-agent.sh 校验结构、test-agent-trigger.sh 测试触发。
适用场景:为插件编写代码审查、测试生成、API 文档、安全分析等自主智能体。
限制:需遵守标识符与描述长度校验规则;避免泛化描述、省略触发条件、授予多余工具权限或跳过测试。具体安装与运行细节资料未提供。