目录
综述：各个组件和Plugin关系
- MCP 最灵活：可以独立配置，也可以打包在 Plugin 中
- Skills 次之：可以独立使用，也可以打包分发
- Commands/Agents/Hooks 最严格：必须通过 Plugin 系统
| 组件 | 是否必须用 Plugin | 如何使用 | 推荐方式 |
|---|---|---|---|
| MCP | ❌ 不需要。 | 1、独立使用：可以直接配置在 .claude.json 或全局配置文件
2、使用plugin |
简单场景用独立配置，复杂集成用 Plugin |
| Commands | ✅ 需要 | 只能通过 Plugin 提供 | 必须用 Plugin |
| Agents | ✅ 需要 | 只能通过 Plugin 提供 | 必须用 Plugin |
| Hooks | ✅ 需要 | 只能通过 Plugin 提供 | 必须用 Plugin |
| Skills | ❌ 不需要 | 1、独立使用：可以放在 .claude/skills/ 或 ~/.claude/skills/
2、使用plugin |
个人用独立，团队用 Plugin |
1 Commands/Agents/Hooks 必须用 Plugin
这三个功能只能通过 Plugin 系统提供，因为它们需要：
- 命名空间管理
- 生命周期控制
- 与 Plugin 系统集成
原因：
- Commands：需要注册到 Plugin 的命令系统
- Agents：需要 Plugin 的子代理管理机制
- Hooks：需要 Plugin 的事件总线
2 Skill与Plugin：在使用skill时,还需要封装成plugin？
2.1 三种使用Skill方式
2.1.1 Project Skills – 项目级别（不需要 Plugin）
|
1 2 3 4 5 |
your-project/ └── .claude/ └── skills/ └── my-skill/ └── SKILL.md |
- 用途：项目特定的工作流
- 分享：通过 Git 仓库共享
- 优点：简单直接，随项目一起版本管理
- 示例：项目编码规范、特定框架的最佳实践
2.1.2. User Skills – 用户级别（不需要 Plugin）
|
1 2 3 |
~/.claude/skills/ └── my-personal-skill/ └── SKILL.md |
- 用途：个人跨项目使用的技能
- 分享：手动复制文件或脚本安装
- 优点：所有项目都能访问
- 示例：个人用户手册（工作偏好和沟通风格）
2.1.3. Plugin Skills – 插件级别（需要 Plugin）
|
1 2 3 4 5 6 |
my-plugin/ ├── .claude-plugin/ │ └── plugin.json └── skills/ └── my-skill/ └── SKILL.md |
- 用途：解决分发问题，而不是共享零散的 Markdown 文件或复杂的安装脚本
- 分享：通过 Marketplace 或 Git 仓库。
- 优点：一键安装、版本管理、自动命名空间隔离。
- 示例：第三方工具集成、可复用的工作流包。
2.2 什么时候需要封装成 Plugin？
| 场景 | 是否需要 Plugin | 原因 |
|---|---|---|
| 单个项目使用 | ❌ 不需要 | 直接放置在 .claude/skills/ 目录下即可 |
| 个人多项目使用 | ❌ 不需要 | 可放置在用户目录下的 ~/.claude/skills/ 目录 |
| 团队内部分享 | ⚠️ 看情况 | 简单的技能可通过 Git 实现分享，复杂技能建议使用 Plugin |
| 公开分发 | ✅ 需要 | Plugin 具备规范的分发形式，能提供更优质的用户体验 |
| 需要使用 Commands/Agents/Hooks | ✅ 需要 | Commands、Agents、Hooks 相关功能仅能在 Plugin 中使用 |
| 需要搭载 MCP 服务器 | ✅ 需要 | 配置文件 .mcp.json 必须依托 Plugin 才能使用 |
| 需要规范版本管理 | ✅ 需要 | Plugin 拥有标准化的版本控制机制，便于版本维护 |
3 MCP与Plugin:MCP 可以独立使用（不需要 Plugin）
MCP 服务器有三种配置方式，都不需要 Plugin：
3.1 方式 1：全局配置（用户级别）
|
1 2 3 4 5 6 |
# 使用 CLI 命令直接添加 claude mcp add github -- npx -y @modelcontextprotocol/server-github # 或手动编辑配置文件 # macOS: ~/Library/Application Support/Claude/claude_desktop_config.json # Windows: %APPDATA%\Claude\claude_desktop_config.json |
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "mcpServers": { "github": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token" } } } } |
3.2 方式 2：项目级别配置
在项目根目录创建 .claude.json
|
1 2 3 4 5 6 7 8 9 |
{ "mcpServers": { "my-custom-tool": { "type": "stdio", "command": "node", "args": ["/path/to/my-tool/index.js"] } } } |
3.3 方式 3：通过 Plugin 打包（可选）
Plugin 可以包含 .mcp.json 来自动配置 MCP 服务器，但这只是为了方便分发，不是必需的。
