:从单一功能到完整工具包

在前面的文章中,我们已经学习了:

• Skills:让 AI 掌握领域知识的模块化能力
• Agent:专业化的子智能程序统
• Hooks:事件驱动的自动化机制

但在实际使用中,你可能会遇到这些场景:

至于痛点一，功能分散。难以管理

├── commands/
│ ├── deploy.md
│ ├── test.md
│ └── format.md
├── agents/
│ └── reviewer.md
├── hooks/
│ └── hooks.json
└── .mcp.json

从问题来看，这些功能是一套完整的工作流,但分散在各处

• 团队成员需要手动复制多个文件
• 更新时需要逐个文件同步
• 难以版本管理

从痛点二来看，团队共享困难

你: "我写了一套很好用的代码审查流程,包含 Agent、Skill 和 Hook"
同事的观点是，"能分享给我吗?"
你: "好的,你需要复制这3个文件到这里。那2个文件到那里..."
至于同事，"这么复杂?算了我自己写吧..." 😓

说到痛点三，无法跨项目复用

项目 A 中精心配置的开发工具:
- Git 提交规范 Skill
- 代码格式化 Hook
- 测试运行 Agent
- CI/CD 集成 MCP
从问题来看，切换到项目 B 时,又要重新配置一遍

💡 Plugin 程序的价值

Plugin 就是解决这些问题的终极方案——它是一个打包和分发机制:

1. 📦 统一打包: 将 Skills、Agents、Hooks、MCP 打包成一个完整的工具包
2. 🚀 一键安装: 通过 /plugin install 命令,一次性获得完整功能
3. ♻️ 跨项目复用: 安装一次。在所有项目中使用
4. 🔄 版本管理: 支持语义化版本,方便升级和回滚
5. 🌐 环境共享: 通过 Marketplace 与社区共享优秀工具

这篇主要内容:

1. Plugin 的主要概念与工作原理
2. Plugin、Skill、Agent、MCP、Hook 的关系梳理
3. 官方 Plugin 介绍与使用场景
4. 创建自定义 Plugin:从单一功能到完整工具包
5. Plugin Marketplace:建立团队和社区的工具环境
6. 再看常用方法，Plugin 的组织、测试和分发

一、Plugin 程序全景图  🔎

什么是 Plugin?

Plugin是 Claude Code 的轻量级打包机制**，用于组合多种 点:

Plugin = Skills + Agents + Hooks + MCP Servers + LSP Servers

主要特点：

• 📁 单一目录：所有相关功能组织在一个目录中。
• 📋 统一配置：plugin.json 管理元数据和依赖。
• 🎯 一键安装：/plugin install 就可以使用。
• 🔄 版本控制：semantic versioning 与自动更新。怎么说呢，

Plugin 与其他 机制的关系  ⚙️

• - 最底层： T​ools
• - 第二层： MCP Servers
• - 第三层： S​kills 、A​gents 、H​ooks
例：PDF 处理 Skill、后端架构师 Agent、保存后格式化 Hook。
- 第四层：P​lugin - 最顶层：M​arketplace

层级	名称	作用	示例

T​ools Builtin capabilities E.g.,Read/Write/Grep/Bash ="">

…

Plugin vs 独立配置  🆚

Claude Code 支持两种方式添加自定义功能：

skill="" ”>位置方式适用场景

独立配置.claude/目录/hello/个人工作流、项目特定定制✅ 快速实验

Plugin.claude-plugin/plugin.json 目录/my-plugin:hello/团队共享、跨项目复用✅ 版本管理 ✅ Marketplace 分发

何时使用独立配置？

li> ✅ 为单一项目定制 li> ✅ 个人配置，无需共享 li> ✅ 实验性功能。打包前测试 li> ✅ 想要短 Skill 名称 /li>

何时使用 Plugin？

li> ✅ 团队或社区共享 li> ✅ 多项目共用 li> ✅ 需要版本控制与便捷更新 li> ✅ Marketplace 分发 li> ✅ 避免命名冲突 /li>

二、Plugin 的结构与组成  🗂️

标准 Plugin 目录结构  

enterprise-plugin/
├── .claude-plugin/ # 元数据目录
│ └── plugin.json # Plugin 清单文件
├── commands/ # 简单 Skills
│ ├── deploy.md
│ └── status.md
├── skills/ # Agent Skills
│ ├── code-reviewer/
│ │ ├── SKILL.md
│ │ └── scripts/
│ └── pdf-processor/
│ ├── SKILL.md
│ └── reference.md
├── agents/ # 子智能体
│ ├── security-reviewer.md
│ ├── performance-tester.md
│ └── compliance-checker.md
├── hooks/ # 事件钩子
│ ├── hooks.json
│ └── security-hooks.json
├── .mcp.json # MCP 服务器设置
├── .lsp.json # LSP 服务器设置
├── scripts/ # 辅助脚本
│ ├── security-scan.sh
│ ├── format-code.py
│ └── deploy.js
├── README.md # 使用文档
└── LICENSE # 许可证
└── CHANGELOG.md # 版本历史

/ ⚠️关键说明：目录位置 / strong>

li>/ ✅ 所有组件目录必须在 Plugin 根目录 / li>
li>/ ❌ 不要把它们放在 .claude‑plugin/ 内 / li>
li>/ ✅ .claude‑plugin/ 内只放 plugin.json / li>


commands/ vs skills/ 的区别  

/ 推荐做法 / strong>

li>/ ✅ 新 Skills 使用 skills/ 格式 / li>
li>/ ✅ 简单一次性命令可以放 commands/ / li>
li>/ ✅ 包含脚本或示例的复杂 Skill 必须用 skills/. / li>


Plugin 清单文件：plugin.json  


{
至于"name"。"enterprise-tools","version": ".","description": "公司级开发工具集，包含部署、审查、测试完整流程","author": {
从"name"来看，"Development Team","email": "","url": "https://github.com/company"
},...
}


/ 必填字段 / strong>
…

三、官方 Plugin 介绍  

feature-dev：完整的功能开发流程  

用途


需求分析
bash
/plugin install feature-dev
/feature-dev:start “添加使用者登录功能”

code-review：并行代理代码审查  
...
...

四、创建自定义 Plugin  

从快速了解来看，创建第一个 Plugin 


Create directory
bash
mkdir my-first-plugin
   ...




... 

五、Plugin Marketplace：建立工具环境 

六、Plugin 开发常用方法 

七、Plugin 环境与社区 

八、实战 






字段
类型
说明
示例




"name"
"string"
"唯一标识符 "
"deployment-tools"

---