Claude Code 插件如何打包你的命令、技能与钩子

随着你的 Agentic 开发需求的增加，在独立的文件夹中管理自定义命令、技能和钩子可能会变得有些杂乱无章。

插件包 (Plugin) 通过将你的技能、钩子和配置捆绑进一个单一的、连贯的、且易于分享的软件包中来解决这个问题。你可以把插件包看作是一个完整的应用程序或扩展，你可以把它放入任何工作区中以瞬间升级 Claude Code。

一个典型的 Claude Code 插件包目录结构如下所示：

my-awesome-plugin/
├── .claude-plugin/      <-- 元数据目录
│   └── plugin.json      <-- 清单文件放在这里
├── skills/              <-- 自定义技能文件夹
│   └── code-auditor/
│       └── SKILL.md
└── hooks/               <-- 自动化预处理脚本
    └── hooks.json

插件包的灵魂是 .claude-plugin/plugin.json。它承载插件包的元数据，而智能体会从插件根目录下各自的目录中自动发现技能、钩子等组件。

让我们来看看 plugin.json 的作用。这份清单文件保存元数据——名称、版本和描述。其中 name 是唯一必填字段，它会成为该插件包所有组件的命名空间前缀：

{
  "name": "developer-toolkit",
  "version": "1.0.0",
  "description": "Premium coding utilities for Claude Code."
}

你无需在清单中逐一列出每个技能。Claude Code 会从各组件的默认目录中自动发现它们：位于 skills/code-auditor/SKILL.md 的技能文件夹会被自动找到，并以带命名空间的技能 /developer-toolkit:code-auditor 形式暴露出来。文件夹名成为技能名，清单中的 name 成为前缀。

在开发阶段测试本地插件包时，启动 Claude Code 时加上 --plugin-dir 标志并指向插件目录即可。若要分享插件包供日常使用，则通过市场（marketplace） 分发，并用 /plugin 命令（或 claude plugin install）安装，该命令会把插件包注册到你的设置中。

这使得以下操作变得极其简单：

• 在你的工程团队中共享自定义智能体行为。
• 在不同的微服务仓库中标准化代码质量检查。
• 为特定的内部框架构建量身定制的助手。