Claude Code 插件结构指南
帮助你规划目录、配置清单并组织 Claude Code 插件组件。
内容公开说明了插件路径、MCP、hooks及环境变量引用，并强调使用CLAUDE_PLUGIN_ROOT；但对自动启动MCP、自动执行hooks、API密钥传递和外部通知缺少用户确认、最小权限、数据流披露及回滚要求，因此扣10分。官方归属和Apache-2.0许可提供了可追溯性，但不构成安全保证。
目录、清单和组件说明较系统，且包含故障排查；但未提供针对关键路径的测试、版本兼容矩阵或可诊断的异常输出规范，并存在“无需重启”与排障中“重启以重新加载”之间的不一致，因此按静态证据保守给6分。
触发描述覆盖创建、脚手架、目录组织、plugin.json、路径变量和组件配置等明确场景，且给出输入结构和非目标的部分暗示；但未说明Claude Code版本边界、平台差异、中文使用支持或大陆网络可达性，部分行为依赖未在材料中验证，因此扣6分。
SKILL.md、README、references和examples形成了较好的渐进式披露，含命名、版本、维护更新步骤、许可证和发布建议；但没有该技能自身的变更日志、依赖版本、安装说明、责任联系方式或明确的兼容性治理，因此扣5分。仓库级Apache-2.0和Anthropic维护背景仅提供有限治理证据。
该技能能直接提供目录模板、manifest示例、组件组织模式和排障清单，核心脚手架指导具有实用价值；但示例未被静态材料中的测试或真实执行结果验证，部分高级示例依赖外部MCP、云凭据和脚本，用户仍需校验实际Claude Code行为，因此按静态上限给6分并扣9分。
源文件本身可审计，包含结构化文档、示例和部分仓库级CI维护信号；但没有针对本技能关键路径的提交测试、第三方复核或执行证据，多个行为声明只能视为作者文档，因此给4分并扣6分。
- 不要将文档中的自动发现、hooks或MCP行为视为已验证事实；安装前应针对目标Claude Code版本测试。
- 高级示例涉及Kubernetes、Terraform、GitHub、Slack、PagerDuty、Datadog及环境凭据；部署前应审查权限、秘密暴露、外部通信和回滚方案。
- 技能未提供中文说明或大陆网络可达性保证，中文用户可能需要额外解释和本地化验证。
它能做什么 & 适用场景
这是 Anthropic 官方插件目录中的一个 Claude Code 技能，专门讲解插件目录布局、plugin.json 配置和组件组织方式。它覆盖命令、代理、技能、钩子与 MCP 服务器的标准位置、格式和自动发现规则。内容还说明如何使用 ${CLAUDE_PLUGIN_ROOT} 保持路径可移植，以及如何排查组件加载和路径解析问题。它适合需要创建或维护 Claude Code 插件的开发者。
提供插件目录结构示例；说明 .claude-plugin/plugin.json 的必填字段、元数据和自定义组件路径；解释 commands、agents、skills、hooks、MCP 服务器和 scripts 的文件组织与自动发现方式；给出 kebab-case 命名、${CLAUDE_PLUGIN_ROOT} 路径引用、最小插件和完整插件示例；列出组件未加载、路径错误、自动发现失败及插件冲突的排查建议。
- 需要从零创建 Claude Code 插件，并希望先确定标准目录结构的开发者。
- 需要配置 plugin.json、组件路径或插件元数据的维护者。
- 需要组织命令、代理、技能、钩子和 MCP 配置的插件作者。
- 遇到组件未加载、路径解析错误或自动发现异常的 Claude Code 用户。
优缺点一览
- 覆盖插件主要组件类型及其标准目录位置。
- 提供 plugin.json、钩子和 MCP 配置示例。
- 明确说明默认目录、manifest 自定义路径和可移植路径引用的关系。
- 包含命名、组织、维护和故障排查建议。
- 内容针对 Claude Code 插件架构，不能直接视为通用 Agent Skill 打包规范。
- 源材料未提供独立安装命令、测试套件或已验证的平台列表。
- 部分能力是说明性指导，不会替用户实际创建或修改插件文件。
如何安装
该技能位于 anthropics/claude-plugins-official 的 plugins/plugin-dev/skills/plugin-structure/SKILL.md。整个插件目录可通过 Claude Code 插件系统安装：/plugin install plugin-dev@claude-plugins-official；也可以使用 /plugin > Discover 浏览。源材料未说明如何单独安装此技能。
如何使用
在 Claude Code 中提出与以下触发条件匹配的问题，例如：“create a plugin”“scaffold a plugin”“understand plugin structure”“set up plugin.json”或“use ${CLAUDE_PLUGIN_ROOT}”。技能将根据任务提供目录布局、清单配置、组件组织和架构实践指导。