用途:介绍 Claude Code 插件的标准化目录结构与组件组织方式,帮助创建结构清晰、易维护且能被自动发现的插件。
主要能力:说明约定式目录布局与自动组件发现;以 .claude-plugin/plugin.json 为清单驱动配置;按组件类型组织 commands、agents、skills、hooks;使用 ${CLAUDE_PLUGIN_ROOT} 实现可移植路径引用;区分显式配置与自动发现加载。
结构要点:plugin.json 必须位于 .claude-plugin/ 目录;commands、agents、skills、hooks 等组件目录必须位于插件根级,不能嵌套在 .claude-plugin/ 内;只创建实际使用的组件目录;目录与文件名使用 kebab-case。清单必填 name,推荐 version、description、author、homepage、repository、license、keywords;自定义路径须相对插件根并以 ./ 开头,且为补充而非替换默认目录。
组件用法:commands 与 agents 为带 YAML frontmatter 的 Markdown 文件,自动加载;skills 为每个技能独立子目录并含 SKILL.md;hooks 通过 hooks/hooks.json 或清单内联配置,支持 PreToolUse、PostToolUse、Stop、SubagentStop、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification 等事件;MCP 服务器通过 .mcp.json 或清单内联定义。
适用场景:创建或脚手架化插件、理解插件结构、组织插件组件、配置钩子与 MCP 集成。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;路径不得使用绝对路径、工作目录相对路径或 ~ 快捷方式;组件变更在下次 Claude Code 会话生效。