Plugins：怎么打包和复用

当你的 Skills、Agents、Hooks、MCP 配置已经不只是自己用时，
就该考虑 Plugins 了。

一、Plugins 解决什么问题

Claude Code 的高阶配置有一个常见难题：

“这套配置很好，但怎么复用给其他项目和其他人？”

Plugins 就是答案。

二、什么时候用 .claude/，什么时候用 Plugin

直接放 .claude/

适合：

• 个人配置
• 单个项目
• 快速试验

做成 Plugin

适合：

• 跨项目复用
• 团队共享
• 版本化管理
• 想发布到市场

三、插件里能装什么

插件不只是装 Skill。

它还能打包：

• Skills
• Agents
• Hooks
• MCP servers

四、插件最重要的文件

插件的核心清单文件是：

.claude-plugin/plugin.json

这个文件定义：

• name
• description
• version

五、插件技能怎么命名

插件技能会带命名空间。

如果插件叫 my-first-plugin，里面的 hello 技能调用时会变成：

/my-first-plugin:hello

这样做是为了防止不同插件里的技能撞名。

六、怎么测试插件

官方文档给的本地测试方法是：

claude --plugin-dir ./my-first-plugin

七、什么时候说明你真的需要插件了

当你出现下面这些情况，就该上插件：

• 这套能力不止一个项目要用
• 团队里别人也需要装
• 你不想再复制 .claude/ 到处贴

一句话总结：

插件不是“更高级的 Skill”，而是把高阶能力打包、复用、分发的方式。