Claude Code 插件结构指南
帮助你规划、配置并组织 Claude Code 插件及其组件。
内容强调使用相对路径和${CLAUDE_PLUGIN_ROOT}，并避免硬编码路径；示例也提到密钥和外部 MCP 集成，但未系统说明权限边界、用户确认、数据流、敏感信息处理、外部副作用或回滚，因此扣除10分。
目录、清单、组件和故障排查说明较完整，提供了可诊断的常见错误；但未提供针对关键路径的已执行测试或 CI 覆盖，且若干自动发现、重载和路径行为仅作断言，静态上限内评8分。
触发短语、目标用户场景和组件类型较明确，涵盖创建、脚手架和组织插件；但未充分定义不适用边界、输入输出契约、版本兼容性或中文使用情境，扣除5分。
信息架构、渐进式披露、命名约定、示例、引用资料和维护步骤较齐全；但许可证、发布版本、变更日志、维护责任和更新路径不完整，且README声称的部分资源规模与提供内容无法由本材料核验，评6分。
对插件目录布局、plugin.json、组件组织和路径引用提供了可直接参考的文本与示例，能覆盖核心咨询任务；但示例和行为未见执行验证，部分输出仍需用户结合实际版本核对，按静态上限评7分。
有固定版本的源文件、清单示例、参考文档和仓库 CI 片段，但 CI 未覆盖该技能关键路径，也没有第三方执行结果或交叉验证；因此仅评4分。
- 文档中的自动发现、嵌套目录支持、重载时机、默认路径和自定义路径合并行为未由该技能内的测试或官方交叉证据验证。
- 示例包含 MCP、环境变量、Slack、PagerDuty、Datadog、Terraform 和 Kubernetes 等外部系统，但未明确权限、密钥暴露、数据发送范围、用户确认或失败回滚要求。
- 未提供该技能自身的明确许可证、变更日志、维护负责人和兼容性矩阵；使用前应核对目标 Claude Code 版本的实际插件规范。
它能做什么 & 适用场景
这是 Claude Code 插件开发集合中的“插件结构”技能，专门说明插件目录布局、plugin.json 清单和组件组织方式。它覆盖 commands、agents、skills、hooks、MCP 服务器及脚本的默认位置、自动发现规则和命名约定。技能还解释如何使用 ${CLAUDE_PLUGIN_ROOT} 处理插件内路径，以及如何排查组件未加载和路径解析问题。它适合需要创建或维护 Claude Code 插件的人，但内容明显依赖 Claude Code 的插件架构。
提供插件目录树、.claude-plugin/plugin.json 示例、组件自定义路径配置、commands/agents/skills/hooks/MCP 配置示例和文件命名规则。它说明 Claude Code 如何扫描并加载组件，并给出 ${CLAUDE_PLUGIN_ROOT} 路径引用、最小插件、完整插件和技能型插件的结构示例。它还列出组件未加载、路径错误、自动发现失败和插件冲突的排查建议。
- 需要从零创建 Claude Code 插件的开发者，用它确定 manifest 和组件目录应放在哪里。
- 需要添加 slash command 或 agent 的团队，用它核对 Markdown 文件格式和自动发现位置。
- 需要组织多个技能的插件作者，用它设计 skills/<skill-name>/SKILL.md 结构。
- 需要配置 hooks 或 MCP 服务器的开发者，用它参考 JSON 配置和插件根路径写法。
- 维护已有插件的团队，用它检查命名、路径、版本和跨系统可移植性建议。
优缺点一览
- 覆盖插件目录、清单、组件、路径引用、自动发现和故障排查。
- 提供最小插件、完整插件和技能型插件等具体结构示例。
- 明确区分默认目录与自定义路径，并强调插件内路径的可移植写法。
- 专门针对 Claude Code 插件架构，迁移到其他平台需要调整。
- 源材料未提供该技能的独立安装或版本发布流程。
- 仓库 README 未给出该单个技能的测试套件或平台验证证据。
- MCP、hooks 和脚本属于可选组件，技能本身不表明每个插件都需要它们。
如何安装
源材料没有提供该单个技能的独立安装命令。它位于仓库的 plugins/plugin-dev/skills/plugin-structure/SKILL.md；README 只说明如何安装 Claude Code。MacOS/Linux 可运行 curl -fsSL https://claude.ai/install.sh | bash，Windows 可运行 irm https://claude.ai/install.ps1 | iex，然后在项目目录运行 claude。
如何使用
在已启用该技能的 Claude Code 环境中，使用自然语言提出与插件结构相关的请求，例如“create a plugin”“scaffold a plugin”“set up plugin.json”或“organize plugin components”。技能会根据请求提供目录、清单、组件路径和自动发现方面的指导。源材料未说明单独启用该技能的命令。