引言：定制服装店的故事

想象一下，你雇佣了一位超级能干的 AI 编程助手 Claude Code。刚开始，他就像一家普通服装店——能提供标准服务，但都是"成衣"，不一定完全符合你的需求。

但 Claude Code 不一样，他更像一家可以深度定制的高级服装店。通过五大"定制系统"，你可以把他改造成完全符合你团队需求的专属助手：

Plugins（插件） - 像服装店的"整体套装"，打包好一整套搭配
Skills（技能） - 像裁缝的"专业技艺"，自动识别场合选择合适的服务
MCP（模型上下文协议） - 像服装店的"供应链"，连接外部的布料商、配饰商
SubAgents（子代理） - 像专业的"分工团队"，西装师傅、旗袍师傅各司其职
Commands（命令） - 像"快捷服务"，一句话就能启动固定流程

这五件套让 Claude Code 从"标准助手"变成"你的专属团队"。

一、Plugins（插件）：打包好的整体套装

什么是插件？

插件就是一个完整的功能包，把命令、子代理、钩子、MCP 配置等打包在一起，形成一个可以直接安装使用的"解决方案"。

类比：就像服装店推出的"商务套装包"，里面有西装、衬衫、领带、皮鞋，还附带搭配建议和保养说明。你买回家就能直接用，不用自己一件件去挑。

用来干什么？

插件的核心价值是模块化和复用：

把一套成熟的工作流固化下来
在不同项目之间快速复用
团队成员之间共享最佳实践
从社区获取别人开发好的功能

实际例子

场景一：代码审查插件

安装 "code-review-pro" 插件后：
✓ 新增命令：/review（启动审查）
✓ 新增子代理：security-checker（安全检查）
✓ 新增钩子：提交前自动运行 lint
✓ 新增 MCP：连接团队的代码规范库

场景二：全栈开发插件

安装 "fullstack-toolkit" 插件后：
✓ 前端开发子代理（React/Vue 专家）
✓ 后端开发子代理（API 设计专家）
✓ 数据库子代理（SQL 优化专家）
✓ 一键命令：/scaffold（生成完整项目脚手架）

插件的组成

一个插件就像一个"工具箱"，里面可以包含：

组件	说明	举例
命令	快捷指令	`/deploy`、`/test-all`
子代理	专业助手	`security-agent`、`doc-agent`
钩子	自动化触发器	保存前格式化代码
MCP 配置	外部系统连接	连接 GitLab、Jira

为什么需要插件？

没有插件时：

每次换项目都要：
1. 重新配置命令
2. 重新定义子代理
3. 重新设置工作流
4. 新人入职要学习很久

有了插件后：

新项目：npm install @company/dev-plugin
新人：安装公司开发插件，立即上手

二、Skills（技能）：裁缝的专业技艺

什么是技能？

技能是 Claude 自动触发的专业能力包。就像一个经验丰富的裁缝，看到客户穿着西装来，就知道要用商务礼仪沟通；看到客户穿着休闲服，就知道用轻松的方式交流。

技能最大的特点是自动触发——你不需要手动调用，Claude 会根据当前情况自动判断需要使用哪个技能。

用来干什么？

技能的核心价值是领域知识的封装和自动化应用：

把专业领域的规范、流程、最佳实践封装起来
Claude 自动识别场景并调用相应技能
避免每次都要重复输入同样的要求
保证输出的一致性和专业性

技能的"三层智能加载"

这是技能系统最巧妙的设计：

📦 第一层：名片（始终加载）
   "我是 API 文档生成专家"
   
📋 第二层：工作手册（需要时加载）
   "扫描代码 → 提取端点 → 生成 OpenAPI 规范"
   
🔧 第三层：工具箱（按需加载）
   脚本、模板、参考文档

为什么要分三层？

类比：你找裁缝做衣服

第一层：门口的招牌"专做旗袍"，让你知道要不要进去（不占用他的工作台）
第二层：进店后，裁缝拿出量体裁衣的流程（占用了他的注意力）
第三层：真正开始做时，才拿出针线、布料等工具（真正开始干活）

这样设计既节省了"注意力"（上下文空间），又保证了需要时能获得完整能力。

实际例子

例子一：API 文档生成技能

你在编辑 user_controller.py 文件，新增了一个接口
→ Claude 检测到 API 相关代码
→ 自动加载 "api-documentation" 技能
→ 提醒你："要不要我帮你生成 OpenAPI 文档？"
→ 生成符合团队规范的文档

例子二：安全审计技能

你写了一段处理用户输入的代码
→ Claude 自动加载 "security-audit" 技能
→ 主动检查：SQL 注入、XSS、CSRF 等风险
→ 给出符合 OWASP 标准的建议

技能 vs 插件

维度	技能（Skills）	插件（Plugins）
触发方式	自动识别场景触发	手动安装和调用
主要内容	专业知识和流程	命令、代理、工具的打包
类比	裁缝的专业技艺	打包好的套装
使用场景	"知道该做什么"	"快速获得一整套能力"

三、MCP（模型上下文协议）：服装店的供应链

什么是 MCP？

MCP（Model Context Protocol）是 AI 时代的"USB-C 接口"——让 Claude Code 能够标准化地连接各种外部数据源和工具。

类比：服装店原本只能用店里的布料做衣服。有了 MCP 后，店里可以：

连接意大利的高级面料供应商
连接法国的配饰工厂
连接日本的纽扣制造商
访问客户的历史订单数据库

所有这些外部资源，都通过**统一的"接口"**连接，不需要为每个供应商单独开发对接方案。

用来干什么？

MCP 的核心价值是打破数据孤岛，标准化集成：

让 Claude Code 访问公司内部系统（数据库、知识库、监控系统）
调用外部工具和 API（GitHub、Jira、Slack）
统一的连接方式，一次开发，到处使用
安全可控的权限管理

为什么叫"USB-C"？

回想一下没有 USB-C 之前的世界：

手机一个充电口
相机一个数据线
键盘一个接口
每个设备都不一样，一堆转接头

有了 USB-C：

一个接口，连接所有设备
标准化、可复用、生态繁荣

MCP 也是一样：

以前：Claude 要连接 10 个系统 → 写 10 套集成代码
现在：10 个系统都提供 MCP 服务器 → Claude 用统一方式连接

实际例子

例子一：连接公司知识库

没有 MCP：
你："帮我查一下公司的报销流程"
Claude："抱歉，我不知道你们公司的内部流程"

有了 MCP：
你："帮我查一下公司的报销流程"
Claude：[自动连接公司 Confluence]
Claude："根据公司知识库，报销流程如下：1. 填写报销单..."

例子二：连接生产数据库

你："最近一周有多少用户注册失败？原因是什么？"
Claude：[通过 database-mcp 查询]
Claude："共 127 个注册失败，主要原因：
       - 邮箱验证超时（78 次）
       - 手机号格式错误（32 次）
       - 系统异常（17 次）"

例子三：触发部署流程

你："/deploy production"
Claude：[通过 kubernetes-mcp]
Claude："正在部署到生产环境...
       ✓ 镜像构建完成
       ✓ 推送到仓库
       ✓ 滚动更新中 (2/5)
       ..."

MCP 的三要素

graph TD
    A[Claude Code<br/>客户端] -->|MCP 协议<br/>标准接口| B[MCP 服务器<br/>中间层]
    B --> C[数据源/工具<br/>数据库/API<br/>实际系统]
    
    style A fill:#e1f5ff
    style B fill:#fff4e6
    style C fill:#f3e5f5

MCP 的安全机制

就像银行的权限系统：

首次连接需要用户授权
可以设置只读/读写权限
所有操作都有审计日志
可以随时撤销权限

四、SubAgents（子代理）：专业分工团队

什么是子代理？

子代理是专门负责某个领域的"专家助手"。就像服装店里的分工：

西装师傅 - 只做西装，做了 20 年，专业
旗袍师傅 - 专精旗袍，手艺精湛
改衣师傅 - 专门负责修改调整

每个师傅都是各自领域的专家，比什么都做的"全能选手"更专业。

用来干什么？

子代理的核心价值是专业化和协作：

为特定任务创建专业的 AI 助手
不同子代理可以协同工作
子代理的"人设"和能力更聚焦，效果更好
避免"万金油"式的泛泛回答

子代理的自动调度

最神奇的地方：Claude 会自动判断何时该叫哪个"师傅"出场。

你在写 SQL 查询
→ Claude 自动叫来 database-specialist（数据库专家）

你在处理安全问题
→ Claude 自动叫来 security-auditor（安全审计师）

你在写文档
→ Claude 自动叫来 doc-generator（文档生成器）

实际例子

例子一：调试专家（Debug Agent）

你："这段代码报错了，帮我看看"
Claude："让我叫调试专家来帮你"

→ debug-expert 上线
→ 分析错误堆栈
→ 追踪变量状态
→ 定位根本原因
→ 提供修复方案

例子二：前后端协作

你："开发一个用户管理功能"
Claude："这个需求涉及前后端，让我协调团队"

→ frontend-specialist：设计 UI 界面和交互
→ backend-specialist：设计 API 接口
→ database-specialist：设计数据表结构
→ test-specialist：生成测试用例

→ 主 Claude 整合所有结果

例子三：安全审查流程

你："准备上线这个功能"
Claude："让安全专家先审查一下"

→ security-auditor 介入
→ 检查 SQL 注入风险
→ 检查 XSS 漏洞
→ 检查认证授权
→ 生成安全报告

→ 通过后才建议部署

子代理的"人设"

每个子代理都有明确的"人设"和"职责"：

---
name: security-auditor
description: 资深安全工程师，专注代码安全审计
personality: 严谨、细致、警觉
expertise: OWASP、漏洞检测、安全加固
---

你是一位有 15 年经验的安全工程师，曾在多家互联网公司担任安全负责人。
你的工作风格是：
- 宁可多疑，不可大意
- 遵循 OWASP 安全标准
- 给出具体可执行的修复建议
- 评估漏洞的严重程度和影响范围

这种明确的"人设"让子代理的回答更专业、更一致。

三种协作模式

模式一：顺序协作（流水线）

生成代码 → 生成测试 → 生成文档 → 安全审计 → 完成

模式二：并行协作（分工）

        ┌→ 前端开发
主任务  ├→ 后端开发  → 汇总结果
        ├→ 数据库设计
        └→ 测试用例

模式三：递归协作（层层细化）

架构设计师
  └→ 微服务架构师
      ├→ API 设计师
      ├→ 数据库设计师
      └→ 安全设计师

五、Commands（命令）：快捷服务菜单

什么是命令？

命令就是预定义的"快捷服务"，类比服装店的快捷菜单：

输入 /干洗 - 启动干洗流程
输入 /修改裤长 - 启动改衣流程
输入 /定制西装 - 启动西装定制流程

一个命令就是一个"提示词模板"，把复杂的提示词固化成简单的指令。

用来干什么？

命令的核心价值是效率和标准化：

把常用的复杂提示词变成简单命令
团队使用统一的命令，保证输出一致性
减少重复输入，提升工作效率
新人快速上手，不需要学习复杂提示词

命令的两种形式

1. 内置命令（Claude Code 自带）

/help       - 显示帮助
/clear      - 清除对话
/agents     - 管理子代理
/mcp        - 管理 MCP 连接
/config     - 查看配置

2. 自定义命令（你可以自己创建）

/review     - 代码审查
/test-all   - 运行所有测试
/deploy     - 部署流程
/doc-api    - 生成 API 文档
/optimize   - 性能优化

实际例子

例子一：代码审查命令

不用命令（每次都要说一大段）：
你："请对这个文件进行详细的代码审查，包括代码质量、性能、安全性、
     最佳实践、测试覆盖率，给出详细的改进建议和优先级排序..."

用命令（一句话搞定）：
你："/review user_service.py"

例子二：带参数的命令

/deploy staging     → 部署到测试环境
/deploy production  → 部署到生产环境（需要额外确认）

/test unit          → 只运行单元测试
/test integration   → 运行集成测试
/test all           → 运行所有测试

例子三：组合命令（工作流）

/ship-feature "用户登录"

执行流程：
1. 运行所有测试
2. 代码审查
3. 生成变更日志
4. 构建生产版本
5. 部署到生产环境
6. 更新文档
7. 通知团队

命令的本质

命令就是提示词的快捷方式：

# /review 命令的定义
---
description: 执行全面的代码审查
argument-hint: [文件路径]
---

请对 $1 进行详细的代码审查，包括：

1. **代码质量**
   - 检查代码风格和一致性
   - 识别代码异味和重复代码

2. **性能**
   - 识别性能瓶颈
   - 提出优化建议

3. **安全性**
   - 检查常见安全漏洞
   - 验证输入验证

4. **最佳实践**
   - 是否遵循设计模式
   - 是否符合 SOLID 原则

请给出优先级排序的改进建议。

当你输入 /review app.py 时，实际上是用 app.py 替换了 $1，把这一大段提示词发给 Claude。

为什么需要命令？

没有命令：

❌ 每次都要重复输入长提示词
❌ 不同人说法不一样，输出不一致
❌ 新人不知道该怎么提问
❌ 容易遗漏重要检查项

有了命令：

✅ 一个斜杠搞定，简单快速
✅ 团队使用统一命令，输出标准化
✅ 新人看命令列表就知道能做什么
✅ 把最佳实践固化在命令里

六、五件套如何协同工作

完整协作流程示例

假设你要开发一个新的 API 功能，看看五件套如何协同工作：

你：/api-create user-profile GET /api/users/:id
    └─ 1️⃣ Commands 解析命令

Claude：识别到 API 开发任务
        └─ 2️⃣ Skills 自动加载 "api-design" 技能

        协调子代理分工：
        ├─ 3️⃣ SubAgent: backend-specialist（生成服务器代码）
        ├─ 3️⃣ SubAgent: database-specialist（设计数据表）
        ├─ 3️⃣ SubAgent: test-generator（生成测试用例）
        └─ 3️⃣ SubAgent: doc-generator（生成 API 文档）

        访问外部系统：
        ├─ 4️⃣ MCP: database-tools（创建数据库表）
        ├─ 4️⃣ MCP: api-gateway（注册新端点）
        └─ 4️⃣ MCP: monitoring（配置监控）

        触发自动化：
        ├─ 5️⃣ Plugin Hook: before-commit（运行 lint）
        ├─ 5️⃣ Plugin Hook: after-commit（触发 CI/CD）
        └─ 5️⃣ Plugin Hook: on-deploy（更新文档站点）

Claude：✅ API 创建完成！

五件套的关系图

graph TD
    A[Plugins<br/>大礼包] -->|包含| B[Commands<br/>菜单]
    A -->|包含| C[SubAgents<br/>团队]
    A -->|包含| D[MCP<br/>供应链]
    
    B --> E[Skills<br/>技艺]
    C --> E
    D --> E
    
    E -.->|自动调用| E
    
    style A fill:#e3f2fd
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style D fill:#e8f5e9
    style E fill:#fce4ec

理解关系：

Plugins 是最外层的"打包"，可以包含其他四样
Commands 是入口，用户通过命令启动
Skills 在后台自动工作，提供专业知识
SubAgents 是专业分工，执行具体任务
MCP 是连接外部世界的桥梁

类比总结

用"定制服装店"完整类比：

组件	服装店类比	实际作用
Plugins	套装礼盒	把整套工具打包分发
Skills	裁缝技艺	自动识别场景提供专业能力
MCP	供应链	连接外部数据源和工具
SubAgents	专业师傅	分工协作，各司其职
Commands	服务菜单	快速启动固定流程

七、如何开始使用

第一步：从命令开始（最简单）

创建你的第一个命令，体验定制化：

# 在项目根目录创建
mkdir -p .claude/commands

创建 .claude/commands/review.md：

---
description: 代码审查
argument-hint: [文件名]
---
请审查 $1，关注代码质量和性能。

现在你就可以用 /review app.py 了！

第二步：创建子代理（专业化）

当你发现某类任务重复出现，创建专门的子代理：

mkdir -p .claude/agents

创建 .claude/agents/backend-expert.md，定义一个后端专家。

第三步：安装 MCP（连接外部）

当需要访问数据库、API 等外部系统时，配置 MCP：

# .mcp.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

第四步：开发技能（自动化）

当某个领域的知识和流程稳定了，封装成技能，让它自动工作。

第五步：打包插件（分享复用）

把成熟的配置打包成插件，分享给团队或社区。

八、五件套的价值

没有五件套：

❌ 每次都要重复输入复杂提示词
❌ 不同人用法不一样，输出不一致
❌ 无法访问公司内部系统
❌ Claude 是"万金油"，不够专业
❌ 新人不知道如何使用
❌ 无法复用和分享最佳实践

有了五件套：

✅ 命令一键启动，简单高效
✅ 团队标准化，输出一致
✅ MCP 打通内外数据源
✅ 子代理各司其职，专业高效
✅ 技能自动触发，省心省力
✅ 插件打包分享，快速复用

核心价值

提升效率 - 从重复劳动中解放出来
保证质量 - 把最佳实践固化下来
团队协作 - 统一工作流程和标准
知识沉淀 - 经验变成可复用的资产
降低门槛 - 新人快速上手

九、学习路径建议

适合新手：Commands → SubAgents → Plugins

先创建几个自定义命令，体验便捷性
创建针对性的子代理，体验专业化
把常用的组合打包成插件

适合团队：Plugins → Commands → Skills

安装团队或社区的插件，快速获得能力
学习插件里的命令怎么用
理解技能如何自动工作

适合企业：MCP → Plugins → Skills

先打通企业内部系统（MCP）
开发企业专用插件
沉淀领域知识为技能

十、常见问题

Q1: 五件套必须都用吗？

A: 不必须。根据需求选择：

只想提升个人效率 → 用 Commands
团队协作 → 用 Plugins
需要访问内部系统 → 用 MCP

Q2: 和提示词工程有什么关系？

A: 五件套是"提示词工程的工程化"：

提示词工程 = 如何写好提示词
五件套 = 如何管理和复用提示词

Q3: 学习成本高吗？

A: 分层次：

Commands - 5 分钟上手
SubAgents - 半小时理解
MCP - 需要一定技术背景
Skills、Plugins - 进阶内容

Q4: 可以分享给团队吗？

A: 完全可以！这正是五件套的核心价值之一。

把 .claude/ 目录提交到 Git
团队成员拉取代码即可使用

结语

Claude Code 的五件套，让 AI 编程助手从"通用工具"进化成"专属团队"。

就像从成衣店升级到定制店：

Commands - 快捷菜单，一键启动
Skills - 专业技艺，自动识别
MCP - 供应链，连接外部
SubAgents - 专家团队，分工协作
Plugins - 整体方案，打包复用

记住一句话：五件套的本质是"让 AI 助手更懂你的业务和团队"。

从今天开始，用五件套打造你的专属 AI 编程助手吧！🚀

下一步阅读

本文聚焦于概念理解，如需深入学习具体实现，请阅读：

《Plugins 插件开发实战指南》
《Skills 技能系统详解》
《MCP 协议与服务器开发》
《SubAgents 子代理最佳实践》
《Commands 命令系统完全指南》

文档版本：2.0.0（概念版）
最后更新：2025-11-10
适合人群：所有 Claude Code 用户

Claude Code 五件套全解：打造你的专属 AI 编程助手

评论区

需要帮助？