meta-plugin-creator

插件创建器

概述

插件是可共享的软件包，可将技能、Agent、命令、钩子、MCP 服务和 LSP 服务打包成可安装的单元，供 Claude Code 使用。插件至少需要一个 .claude-plugin/plugin.json 清单；其他所有组件均为可选项，并会从插件根目录下的约定目录中自动发现。

适用场景： 在项目或团队间共享功能、通过市场分发、为可复用的 Agent 能力进行版本管理、将 MCP 服务与技能打包在一起。

不适用场景： 单个项目的自定义配置（请改用 .claude/ 目录）、打包前的快速试验、不需要分发的个人工作流。

快速参考

组件	位置	格式	发现方式
清单	.claude-plugin/plugin.json	JSON	必需
技能	skills/*/SKILL.md	Markdown + YAML	根据上下文自动发现
命令	commands/*.md	Markdown + YAML	自动发现，带命名空间
Agent	agents/*.md	Markdown + YAML	自动发现，通过 /agents UI
钩子	hooks/hooks.json	JSON	事件触发时自动发现
MCP 服务	.mcp.json	JSON	启用时自动发现
LSP 服务	.lsp.json	JSON	启用时自动发现
输出样式	自定义路径	依配置而定	通过清单指定
插件环境变量	${CLAUDE_PLUGIN_ROOT}	绝对路径	所有配置/脚本
项目环境变量	${CLAUDE_PROJECT_DIR}	绝对路径	所有配置/脚本
CLI 测试标志	--plugin-dir ./my-plugin	本地开发	手动加载
CLI 验证	claude plugin validate .	本地开发	手动检查
安装范围	--scope user|project|local	CLI 标志	每次安装

常见错误

错误	正确做法
将组件放在 .claude-plugin/ 中	只有 plugin.json 放在 .claude-plugin/ 中；组件应放在插件根目录
在配置中使用绝对路径	所有插件文件引用都使用 ${CLAUDE_PLUGIN_ROOT}
缺少 plugin.json 清单	创建 .claude-plugin/plugin.json，其中至少包含一个 name 字段
使用 ../ 路径遍历	将所有文件保留在插件目录内
钩子脚本不可执行	对钩子引用的所有脚本运行 chmod +x
忘记命名空间	插件技能的调用方式为 /plugin-name:skill-name
内联钩子中的事件名称大小写错误	事件名称区分大小写：应为 PostToolUse，而不是 postToolUse
误以为自定义路径会取代默认路径	自定义组件路径会补充默认目录，而不是取代它们

委派

• 插件组件创建：按照各自的标准构建技能、Agent 和命令
• 模式发现：使用 Explore Agent 查找代码库中现有的插件模式
• 代码审查：使用 Task Agent 验证插件结构

如果有 meta-skill-creator 技能，请将插件中的技能编写工作委派给它。 否则，建议使用：npx skills add oakoss/agent-skills --skill meta-skill-creator

参考资料

• 插件清单架构、目录结构和组件路径
• 插件中的技能、Agent、命令、钩子、MCP 服务和 LSP 服务
• 安装范围、环境变量和发布