用途：为 Claude Code 创建生产级插件提供规范指导，涵盖插件结构、斜杠命令、技能与子智能体的编写方式。
主要能力与结构规则：插件根目录需包含 .claude-plugin/plugin.json 清单（必需）；commands/ 存放斜杠命令（.md）；skills/ 下必须是子目录，内部文件必须大写命名为 SKILL.md；agents/ 下存放 agent-name/AGENT.md。常见错误包括 skills/SKILL.md 缺少子目录、命名错误或使用 CamelCase，正确写法为 skills/my-skill/SKILL.md（kebab-case）。
manifest 格式：plugin.json 至少包含 name、description、version；完整示例还可含 author、homepage、repository、license、keywords。
命令格式：文件头必须以 # /plugin-name:command-name 开头，插件名与命令名用 kebab-case，命令不使用 YAML frontmatter。
技能格式：使用 YAML frontmatter，包含 name 与 description；description 需写入具体多样的激活关键词，避免过于笼统或缺少关键词。
子智能体格式：agents/agent-name/AGENT.md，带 frontmatter；调用方式为 Task({ subagent_type: "plugin-name:folder-name:yaml-name", prompt: "..." })。
测试流程：复制插件到 ~/.claude/plugins/ 或使用 claude plugin add github:username/my-plugin 安装；新增插件、修改 plugin.json、增删命令或改动 YAML frontmatter 后需重启 Claude Code；输入 "/" 验证命令出现，使用触发问题验证技能激活，并通过日志查看加载情况。
限制与排查：技能不激活时检查 YAML frontmatter、激活关键词、目录与文件名、是否重启；命令找不到时检查文件头格式、目录位置、插件名一致性及是否重启；YAML 解析错误多因引号未闭合、非法字符、缺少结束 --- 或缩进错误。命名统一使用 kebab-case，不用下划线或 CamelCase；SKILL.md 建议控制在 50KB 以内。