用途：面向 Claude Code 插件开发者的完整指南，覆盖插件架构、目录布局、组件与市场发布。
主要能力：说明插件清单 .claude-plugin/plugin.json 的必填字段与校验规则（author 须为对象、version 须为字符串、keywords 须为数组，且不写 agents/skills/slashCommands 等自动发现项）；介绍组件类型：commands/.md 斜杠命令、agents/.md 子智能体、skills/*/SKILL.md 技能、hooks/hooks.json 钩子、.mcp.json 的 MCP 服务器。所有 markdown 组件必须带 YAML frontmatter，否则不加载。技能采用三层渐进式加载（frontmatter、SKILL.md 正文、references/）。
使用方式：创建插件时先检测仓库上下文（存在 .claude-plugin/marketplace.json 则放入 plugins/ 目录），从 git config 取作者信息，再建目录与文件；若含第三方内容需在根目录建 NOTICES.md；最后在 marketplace.json 注册。常用操作：让 Claude 创建插件、运行 /validate-plugin 校验、用 /plugin marketplace add user/repo 与 /plugin install name@user 安装。内部路径统一用 ${CLAUDE_PLUGIN_ROOT}，避免硬编码绝对路径。
适用场景：开发、校验与发布 Claude Code 插件，设计以智能体优先、命令精简为原则。
限制：Windows 建议用 GitHub 市场安装，本地路径可能失败；Git Bash/MinGW 可用 $MSYSTEM 检测。插件不加载、命令缺失、智能体不触发等问题有对应排查项。更细内容见 references/ 下清单、组件模式与发布指南，以及 examples/ 示例。