Claude Code 从零到精通：多Agent协作开发完全教程-第五章：Plugins 插件系统

第五章：Plugins 插件系统

5.1 Plugin vs Skill 的关系

Plaintext

┌──────────────────────────────────────────────────┐

│ Plugin 和 Skill 的关系 │

├──────────────────────────────────────────────────┤

│ │

│ Plugin（插件）= 多个 Skill 的集合 + 配置 │

│ │

│ ┌─────────────────────────────────┐ │

│ │ superpowers (插件) │ │

│ │ ┌───────────┐ ┌───────────┐ │ │

│ │ │brainstorm │ │write-plan │ │ │

│ │ │头脑风暴 │ │写计划 │ │ │

│ │ └───────────┘ └───────────┘ │ │

│ │ ┌───────────┐ ┌───────────┐ │ │

│ │ │code-review│ │ TDD │ │ │

│ │ │代码审查 │ │测试驱动 │ │ │

│ │ └───────────┘ └───────────┘ │ │

│ │ ┌───────────┐ ┌───────────┐ │ │

│ │ │ debugging │ │verify │ │ │

│ │ │ 系统调试 │ │完成验证 │ │ │

│ │ └───────────┘ └───────────┘ │ │

│ └─────────────────────────────────┘ │

│ │

│ 类比： │

│ - Plugin = 角色（如"保洁"） │

│ - Skill = 技能（如"扫地"、"擦桌子"、"拖地"） │

│ │

└──────────────────────────────────────────────────┘

5.2 插件市场：浏览、安装、管理

📖 官方文档：Discover and install plugins

打开插件管理器

在 Claude Code 交互模式中输入：

Plaintext

/plugin

会打开一个带四个标签页的管理界面（用 Tab 键切换）：

标签页 功能

Discover 浏览所有可用插件，支持搜索筛选

Installed 查看和管理已安装的插件

Marketplaces 添加、删除、更新市场源

Errors 查看插件加载错误

Anthropic 官方市场（claude-plugins-official）是内置的，无需手动添加，直接在 Discover 标签页浏览即可。

安装插件

方式一：交互式安装（推荐新手）

Plaintext

/plugin

→ 进入 Discover 标签 → 选中插件按 Enter → 选择安装范围（User/Project/Local）

方式二：命令行直接安装

Plaintext

/plugin install plugin-name@marketplace-name

例如：

Plaintext

/plugin install commit-commands@claude-plugins-official

安装范围说明：

范围 说明 适用场景

User 安装到个人级别，所有项目可用 个人常用工具

Project 写入 .claude/settings.json，团队共享 团队统一工具

Local 仅当前仓库、仅自己可用 试用或个人偏好

用 CLI 指定范围：

Plaintext

claude plugin install formatter@your-org --scope project

添加第三方市场

除了官方市场，你还可以添加第三方或团队私有市场：

Bash

从 GitHub 添加（最常用）

/plugin marketplace add owner/repo

从 GitLab 等平台添加

/plugin marketplace add https://gitlab.com/company/plugins.git

从本地路径添加（开发自己的插件时用）

/plugin marketplace add ./my-marketplace

简写：/plugin market 等同于 /plugin marketplace

管理已安装的插件

Bash

/plugin # 打开管理界面，切到 Installed 标签

/plugin disable plugin-name@marketplace-name # 暂时禁用（不卸载）

/plugin enable plugin-name@marketplace-name # 重新启用

/plugin uninstall plugin-name@marketplace-name # 卸载

/plugin marketplace list # 查看所有已配置的市场源

/plugin marketplace update marketplace-name # 更新某个市场的插件列表

官方市场中的热门插件

分类 插件示例 说明

代码智能（LSP） typescript-lsp、pyright-lsp、rust-analyzer-lsp、gopls-lsp 给 Claude 精确的代码导航能力

外部集成 github、gitlab、slack、figma、notion、sentry 连接第三方服务

开发工作流 commit-commands、pr-review-toolkit Git 提交和 PR 审查增强

插件开发 plugin-dev 开发自己的插件时用

5.3 Superpowers 插件详解

Superpowers 是最流行的开发流程插件之一，它提供了一套完整的软件开发工作流：

Plaintext

┌─────────────────────────────────────────────────────┐

│ Superpowers 工作流 │

├─────────────────────────────────────────────────────┤

│ │

│ 用户输入需求 │

│ │ │

│ ▼ │

│ ┌──────────────┐ │

│ │ Brainstorming │ ← 头脑风暴：探索需求、提问、确认 │

│ └──────┬───────┘ │

│ │ │

│ ▼ │

│ ┌──────────────┐ │

│ │ Writing Plans │ ← 写计划：输出详细实施方案 │

│ └──────┬───────┘ │

│ │ │

│ ▼ │

│ ┌──────────────┐ │

│ │ Task Setting │ ← 任务设定：拆分为可执行的子任务 │

│ └──────┬───────┘ │

│ │ │

│ ▼ (清空上下文，隔离) │

│ ┌──────────────┐ │

│ │ Executing │ ← 执行计划：按步骤编码实现 │

│ └──────┬───────┘ │

│ │ │

│ ▼ │

│ ┌──────────────┐ │

│ │ Code Review │ ← 代码审查：检查质量和规范 │

│ └──────┬───────┘ │

│ │ │

│ ▼ │

│ ┌──────────────┐ │

│ │ Verification │ ← 验证：运行测试确认功能正确 │

│ └──────────────┘ │

│ │

│ 核心价值：隔离上下文，分阶段工作，避免上下文爆炸 │

│ │

└─────────────────────────────────────────────────────┘

使用方式：

Plaintext

使用 superpowers 帮我开发一个笔记应用

Claude 会自动触发 superpowers 的头脑风暴流程，然后逐步推进。

安装方式：

Plaintext

/plugin marketplace add obra/superpowers-marketplace

然后在 Discover 标签页中找到 superpowers 并安装。

📖 Superpowers GitHub（42k+ stars）：https://github.com/obra/superpowers

5.4 插件管理命令速查

操作 命令

打开插件管理器 /plugin

安装插件 /plugin install 插件名@市场名

卸载插件 /plugin uninstall 插件名@市场名

暂时禁用 /plugin disable 插件名@市场名

重新启用 /plugin enable 插件名@市场名

添加市场源 /plugin marketplace add owner/repo

查看市场列表 /plugin marketplace list

更新市场 /plugin marketplace update 市场名

删除市场 /plugin marketplace remove 市场名

验证插件 /plugin validate .

5.5 创建自定义插件

你完全可以让 Claude Code 帮你写插件：

Plaintext

帮我创建一个 Claude Code 插件，功能包括：

1. 管理我的 Agent 团队成员
2. 自动分配任务
3. 监控团队进度

5.6 动手练习

以下练习由浅入深，建议逐个完成。每个练习都可以直接在 Claude Code 中用自然语言完成。

练习 1：安装你的第一个插件

在 Claude Code 中执行 /plugin，浏览插件市场，选一个感兴趣的插件安装并体验。

Plaintext

/plugin

安装后试着用自然语言触发它，观察它做了什么、调用了哪些 skill。

练习 2：用 Superpowers 完成一个小项目

选择一个简单的目标（比如"一个 Todo List 网页应用"），体验完整的 superpowers 工作流：

Plaintext

使用 superpowers 帮我开发一个 Todo List 网页应用

重点观察：

•头脑风暴阶段它问了你哪些问题？

•它是如何拆分任务的？

•上下文是怎么在阶段之间隔离的？

练习 3：写你的第一个 Skill

创建一个"每日代码检查"skill，每次调用时自动：

1.查看 git 状态

2.列出最近的修改

3.跑一遍 lint

4.输出今日工作摘要

提示：在 .claude/skills/daily-check/SKILL.md 中编写，然后用 /daily-check 调用。

Markdown

<!-- .claude/skills/daily-check/SKILL.md -->

---

name: daily-check

description: 每日代码健康检查

disable-model-invocation: true

---

执行每日代码健康检查：

1. 运行 git status 查看工作区状态
2. 运行 git log --oneline -10 查看最近提交
3. 运行项目的 lint 命令检查代码规范
4. 用一段简短的中文总结今日代码状态，包括：

• 有多少未提交的变更
• 最近做了哪些工作
• 有没有 lint 警告需要处理

练习 4：创建一个自定义插件

挑战自己——让 Claude Code 帮你从零写一个插件：

Plaintext

帮我创建一个 Claude Code 插件叫 "quick-notes"，包含以下 skills：

1. /note-add：快速记录一条开发笔记到 .claude/notes.md
2. /note-list：列出所有笔记
3. /note-search <关键词>：搜索笔记内容

完成后检查 .claude/skills/ 下生成的文件结构，理解插件是怎么组织的。

学习要点：通过这些练习你会发现——你不需要手写每一行配置，只需要用自然语言描述你想要的工作流，Claude Code 自己就能帮你生成 skill 文件。核心能力是清晰地定义需求，而不是记住语法。