用途：指导在 Claude Code 插件中创建、编写和配置子代理（agent）。代理是自主子进程，用于独立处理复杂的多步任务；命令面向用户主动发起的操作，代理面向自主工作。
主要能力：定义代理的 Markdown 文件格式与 YAML frontmatter；设计 description 触发条件（含 2-4 个 <example> 示例，说明上下文、用户请求、助手响应与触发理由）；编写系统提示词（角色、核心职责、分析流程、质量标准、输出格式、边界情况）；配置 model（inherit、sonnet、opus、haiku，推荐 inherit）、color（blue、cyan、green、yellow、magenta、red）与可选 tools（如 ["Read","Write","Grep"]，省略则拥有全部工具）。
使用方式：可 AI 辅助生成（按给定提示词模式输出 identifier、whenToUse、systemPrompt 的 JSON，再转为带 frontmatter 的代理文件），或手动创建：选标识符、写 description、选 model 与 color、定义 tools、写系统提示词，保存为 agents/agent-name.md。agents/ 目录下所有 .md 文件会被自动发现，并按插件与子目录自动命名空间。可用 scripts/validate-agent.sh 校验结构、test-agent-trigger.sh 测试触发。
适用场景：为插件添加代码审查、测试生成、API 文档编写、安全分析等自主代理。
限制与规范：name 必填，3-50 字符，仅小写字母、数字、连字符，须以字母数字开头结尾；description 必填，10-5,000 字符，建议 200-1,000 字符；系统提示词 20-10,000 字符，建议 500-3,000 字符，用第二人称书写。具体安装命令与收费信息暂未提供。