你可能正经历这件事

Skill、Hook、Agent 散落各处，团队成员各写各的——这事儿你可能正经历。

我去年带一个 5 人小组用 Claude Code 做 DevOps 工具链，第 2 个月就出问题：每个人 .claude/skills/ 目录里都躺着自己写的 review.md命名一样内容五花八门；新人入职要拷贝 5 个文件夹、改 10+ 处方法、再手敲一次 hooks 注册；某个 Hook 脚本升级了谁也没通知谁，CI 上一半通过一半挂。这不是哪个人不靠谱，是缺一个"打包分发"的层。

Claude Code 在 M8 给出的答案叫 Plugin——把 Commands、Subagents、Hooks、MCP Servers 装进同一个目录、配一张身份证、能装能卸能升级的单元。M9 再叠上工程化治理，团队级用起来才稳。

下面把踩过的坑和能用上的冷门开关一条龙讲完。不过，

Plugin 是能力的封装与分发

不要把 Plugin 想成"另一个 Skill"。怎么说呢，Skill 是单点能力。Plugin 是容器——里面装什么由你决定。一个 Plugin 可以只放一个 Subagent，也可以同时塞进 Commands + Hooks + MCP + 条件化规则。

实际用下来Plugin 的真正价值不在"打包"，而在"分发 + 版本"。 我个人的判断是：单兵作战时 Plugin 收益有限，团队超过 3 人、跨项目复用时Plugin 是分水岭。再小就只能靠 Git submodule 强撑，那套玩法很难管。

plugin.json：Plugin 的身份证

每个 Plugin 根目录一张 plugin.json

{ "name": "team-toolkit","version": "1.0.0","description": "团队标准开发工具包：代码审查、测试、安全扫描一体化","author": "Platform Team"。"repository": "https://github.com/our-company/team-toolkit","license": "MIT","keywords":
}

"% 的人不知道 Plugin 的版本号要和 git tag 一致",否则 /plugin update 拉到的版本会和你 README 中写的对不上。 我自己吃过亏,发布后第二天就有同事说“装出来还是旧的”。 排查半小时才发现版本号没递增。不过，repository。字段也别瞎填,从 GitHub 安装时它就是下载源。

再看四种组件格式，装什么,怎么装?

"Plugin目录长这样:"

team-toolkit/
├── plugin.json
├── commands/
│ └── review.md
├── agents/
│ └── security-scanner.md
├── hooks/
│ ├── hooks.json
│ └── check-bash.sh
└── mcp/
└── mcp.json

"Subagent 用带 frontmatter 的 .md ",别写成纯文本:

`name: security-scanner description:扫描代码中的安全漏洞,生成结构化报告 tools: Read,Grep。Glob model: sonnet ---` 

`tools`字段做能力隔离——安全扫描只需要 Read/Grep/Glob,就别给 Bash.`model: sonnet`让 Subagent 用中等模型,避免主智能体上 Opus 时成本失控.

"Hooks 用.json`注册 + 脚本执行:" `hooks.json"`: `

{ HOOKS: },{ EVENT:`PostToolUse`,MATCHER:`Write`,COMMAND: } ] }`
``MCP Servers一样是.json `会话启动时加载:`
`
{ MCP SERVERS:{ POSTGRES:{ COMMAND:npx ARGS:[Y @ANTHROPIC/MCP-SERVER-POSTGRES ENV:{ DATABASE_URL:$${DATABASE_URL} } } }`

安装.管理.本地测试三板斧!
/plugin install react-workflow@community #从社区行业市场/plugin install github.com/username/react-workflow #从 GitHub仓库/plugin install ./path/to/my-plugin #从本地目录/plugin list #日常管理/plugin remove react-workflow/plugin update react-workflow
强调这方面，-PLUGIN-DIR是本地开发工具!不正式安装就能加载:

CLAUDE -PLUGIN-DIR ./MY-PLUGIN-DEV "


改一行 frontmatter重跑命令立刻验证.我开发 Plugin 时几乎不 /plugin install。全是 -plugin-dir起步,稳定了再发版。

至于实战，打包一个安全扫描 PLUGIN!

把前面零碎串起来.目标:能扫注入漏洞又能在 Bash危险命令时拦下来 PLUGIN.
目录骨架的观点是，