用途:该技能是 Claude Code 插件开发的规范指南,在上下文出现 .claude-plugin/、plugin.json、marketplace.json、commands/、agents/、skills/ 或 hooks/ 时触发,用于创建、修改与调试插件。
主要能力:诊断当前仓库布局(只读);提出最小安全动作,如脚手架、校验或评审;在用户同意后通过 /plugin-development:... 命令执行;复杂审计可升级至 plugin-reviewer 代理。提供模式文件(plugin-manifest.md、hooks-schema.md、marketplace-schema.md)、模板、示例与最佳实践,并列出组件与发布检查清单。
必要用法:脚手架 /plugin-development:init <name>;添加组件 /plugin-development:add-command|add-skill|add-agent|add-hook;校验 /plugin-development:validate;本地测试 /plugin-development:test-local。skill 的 frontmatter 需 name(小写字母、数字、连字符,最多 64 字符,不可含保留词 anthropic、claude、不可含 XML 标签)与 description(说明做什么与何时用,最多 1024 字符,不可含 XML 标签),可选 model、allowed-tools;SKILL.md 建议不超过 500 行,细节放入同级文件。hook 脚本需 chmod +x 并用 ${CLAUDE_PLUGIN_ROOT} 引用路径。
限制与常见错误:组件目录须置于插件根目录,不可放进 .claude-plugin/;标准目录会被自动发现,不要在 plugin.json 中声明 commands、agents、skills、hooks 字段;忽略校验、未 chmod +x、使用相对路径或保留词都会导致静默失败,应在测试前先运行 /plugin-development:validate。默认只读,改动前先征求同意并优先给出命令或 PR 风格 diff。