用途：指导开发 Claude Code 插件的智能体（agents）。资料强调智能体用于自主完成多步骤任务，而命令用于用户主动发起的操作。
文件结构：智能体为 Markdown 文件加 YAML frontmatter，frontmatter 字段包括 name（必填，小写字母、数字、连字符，3-50 字符，首尾为字母或数字）、description（必填，最关键，需写触发条件并含 2-4 个 <example> 块，含 Context、user、assistant 和 <commentary>）、model（inherit/sonnet/opus/haiku，推荐 inherit）、color（blue、cyan、green、yellow、magenta、red）、tools（可选，工具名数组，遵循最小权限）。
系统提示词：用 Markdown 正文书写，采用第二人称，包含核心职责、分析流程、质量标准、输出格式和边界情况处理；长度 20-10000 字符，建议 500-3000。
创建方式：一是 AI 辅助生成，按给定提示词模板产出 identifier、whenToUse、systemPrompt 的 JSON，再转为智能体文件；二是手动创建，保存为 agents/agent-name.md。agents/ 目录下所有 .md 文件会被自动发现，并按插件名与子目录自动命名空间。
校验与测试：可使用 scripts/validate-agent.sh 校验文件结构，用 scripts/test-agent-trigger.sh 测试触发是否正确；description 长度 10-5000 字符。参考资料位于 references/ 与 examples/ 目录。
限制：资料未说明具体版本要求、安装命令、收费信息或平台支持范围，暂未提供。