我是如何使用 Claude Code 的｜插件篇

一、插件是 Claude Code 的武器库

裸装的 Claude Code 已经很强：它能读写文件、执行命令、搜索代码。但加上插件之后，它的能力边界会被彻底打开：它能操控浏览器、生成设计稿、管理 Obsidian 知识库、部署到 Vercel、甚至变成一个 Telegram Bot。

我目前的配置：9 个 Marketplace，29 个插件。这篇文章就来聊聊这些插件是怎么组织的，以及我是怎么用它们的。

二、插件生态概览

2.1 Marketplace 机制

Claude Code 的插件通过 Marketplace 分发，每个 Marketplace 本质上是一个 GitHub 仓库。安装插件就是从对应仓库拉取代码到本地。

我使用的 9 个 Marketplace 可以分为三类：

官方 Marketplace（2 个）：

① claude-plugins-official（anthropics/claude-plugins-official）—— 官方维护的核心插件库，我的大部分插件都来自这里。包含 26 个插件：

② anthropic-agent-skills（anthropics/skills）—— 官方技能包。包含 1 个插件：

社区 Marketplace（7 个）：

③ compound-engineering-plugin（EveryInc/compound-engineering-plugin）—— Every 公司开源的工程实践插件。包含 1 个插件：

④ claude-obsidian-marketplace（AgriciDaniel/claude-obsidian）—— [[Obsidian]] Wiki 管理。包含 1 个插件：

⑤ ralph-marketplace（snarktank/ralph）—— Ralph 自主工作代理。包含 1 个插件：

⑥ openai-codex（openai/codex-plugin-cc）—— OpenAI Codex 集成。包含 1 个插件：

⑦ claude-code-warp（warpdotdev/claude-code-warp）—— Warp 终端集成。包含 1 个插件：

⑧ thedotmack（thedotmack/claude-mem）—— 持久化记忆系统。包含 1 个插件：

自建 Marketplace（1 个）：

⑨ botao-plugins（Bo-Tao/claude-code-plugins）—— 我自己维护的插件仓库。包含 1 个插件：

自建 Marketplace 的好处是可以封装自己的工作流，并且可以方便地在多台设备间同步。只需要创建一个符合 Claude Code 插件规范的 GitHub 仓库，然后在 通过 /plugin marketplace add <marketplace> 中添加即可。

2.2 插件的五种组件类型

一个插件可以包含以下五种组件的任意组合：

以 hookify 插件为例，它同时包含了 skills、commands、hooks、agents 和 core 五个目录——是组件类型最丰富的插件之一。而像 caffeinate 这样的简单插件，只有一个 hooks 目录。

Skills 和 Commands 的区别值得说明：Skills 通常是完整的工作流程（比如 brainstorm → plan → execute），包含详细的执行步骤指导；Commands 更像是快捷入口，通常触发一个特定动作（比如 /hookify:list 列出已有规则）。

2.3 插件的安装范围

插件有三种安装范围，决定了它在什么场景下生效：

我的大部分插件都安装在 User 级别。但有 1 个例外：

• claude-obsidian 安装在 Project 级别（仅在 llm-wiki 知识库项目中生效）

Local 级别适合存放不想提交到仓库的个人偏好配置，比如通过 enableAllProjectMcpServers: false 来控制项目级 MCP Server 的默认行为。

三、MCP Server — 连接外部世界的桥梁

MCP（Model Context Protocol）Server 是让 Claude Code 能够操作外部工具的关键。每个 MCP Server 暴露一组工具（tools），Claude 可以根据任务需要自动调用。

3.1 context7（来自 context7 插件）

解决一个核心痛点：Claude 的训练数据有截止日期，但框架和库的 API 在不断变化。context7 通过实时查询文档来弥补这个 gap。

工作流程：先通过 resolve-library-id 找到库的 Context7 ID，再通过 query-docs 查询具体文档。比如查询 "Vue 3 composables 最佳实践"，它会返回最新的官方文档片段，而不是可能过时的训练数据。

3.2 playwright（来自 playwright 插件）

这是浏览器操作的配置：

playwright 启动独立的浏览器实例，可以导航页面、填写表单、点击元素、执行 JavaScript。适合自动化操作。

3.3 figma（来自 figma 插件）

通过 OAuth 连接 Figma 账号，可以读取设计稿中的组件、样式和布局信息。在做前端开发时，Claude 可以直接从 Figma 设计稿中提取规格，生成对应的代码——减少"设计稿到代码"之间的信息损耗。

3.4 pencil（来自 pencil 插件）

与 Figma 方向相反，pencil 是让 AI 直接生成设计。它操作 .pen 文件格式，可以创建 frame、文本、矩形等元素，支持 layout 系统、变量主题和组件复用。适合快速原型设计或在没有设计师的情况下生成 UI 方案。

3.5 supabase / vercel（来自 supabase、vercel 插件）

两个后端/部署服务的 MCP 集成：

• supabase 连接 Supabase 平台，管理数据库、认证、存储等
• vercel 连接 Vercel 平台，管理部署、环境变量、域名等

两者都通过 OAuth 认证，配置完成后 Claude 可以直接操作这些平台，实现"开发-部署"一体化。

3.6 telegram（来自 telegram 插件）

把 Claude Code 变成 Telegram Bot。配置好 Bot Token 后，Claude 可以接收 Telegram 消息、回复文本、发送文件、添加 emoji 反应。实际使用场景：在手机上通过 Telegram 给 Claude Code 发送任务，它在本地电脑上执行后把结果发回来。

3.7 claude-mem（来自 claude-mem 插件）

持久化记忆系统。Claude Code 原生的记忆（auto memory）是基于文件的简单存储，而 claude-mem 提供了更强大的能力：语义搜索（search）、时间线浏览（timeline）、结构化代码分析（smart_search / smart_outline / smart_unfold）。适合在大型项目中快速定位之前的工作记录和代码模式。

四、Skills — 可复用的工作流封装

Skills 是我使用最频繁的插件组件。它们本质上是 Markdown 文件，定义了一套完整的工作流程——Claude 读取后会严格按照步骤执行。通过 /skill-name 调用。

4.1 开发工作流类

superpowers 全家桶（来自 superpowers 插件）

这是我最核心的工作流插件，提供了完整的软件开发生命周期覆盖：

• /superpowers:brainstorm —— 头脑风暴，发散思维探索方案
• /superpowers:write-plan —— 撰写实现计划
• /superpowers:execute-plan —— 按计划执行实现
• /superpowers:verification-before-completion —— 完成前验证
• /superpowers:requesting-code-review —— 发起代码审查
• /superpowers:test-driven-development —— TDD 工作流
• /superpowers:dispatching-parallel-agents —— 并行派遣子代理

典型流程：brainstorm → write-plan → execute-plan → verification → code-review。

compound-engineering 三段式（来自 compound-engineering 插件）

Every 公司开源的工程实践，更侧重于企业级开发流程：

• /compound-engineering:ce-plan —— 制定计划
• /compound-engineering:ce-work —— 执行工作
• /compound-engineering:ce-review —— 审查代码

它还内置了大量专项 Skill：git-commit、git-commit-push-pr、reproduce-bug、proof（验证方案）等。

feature-dev 全流程（来自 feature-dev 插件）

专注于 Feature 开发的三阶段模型：

• /feature-dev:feature-dev —— 主入口，自动编排以下阶段
• code-explorer（subagent） → 深度分析现有代码
• code-architect（subagent） → 设计实现方案
• 实现 → 写代码

4.2 前端专项类（来自 antfu/skills）

Anthony Fu 维护的前端技术栈 Skill 合集，安装在 ~/.claude/skills/ 目录，共 13 个：

• /vue、/nuxt、/pinia、/vue-router-best-practices、/vue-best-practices —— Vue 生态最佳实践全家桶
• /vitest、/vue-testing-best-practices —— 测试驱动开发
• /unocss、/vite、/tsdown、/pnpm —— 构建工具链
• /vueuse-functions —— VueUse 工具函数指南
• /slidev —— 用 Markdown 写幻灯片

当我在 Vue/Nuxt 项目中工作时，这些 Skill 确保 Claude 生成的代码符合最新的生态惯例，而不是用过时的 Options API 或 webpack 配置。

4.3 知识管理类

claude-obsidian（来自 claude-obsidian 插件）

把 Claude Code 变成 [[Obsidian]] Wiki 管理员：

• /claude-obsidian:wiki-ingest —— 批量录入，从 .raw/ 目录读取原始素材，提取概念和实体，创建 Wiki 页面
• /claude-obsidian:wiki-query —— 知识查询，搜索 Wiki 中的信息
• /claude-obsidian:wiki-lint —— 健康检查，扫描孤页、死链、缺失引用等问题
• /claude-obsidian:save —— 保存当前会话到 Wiki

李继刚系列（来自李继刚的 Skills）

一套学习和思维训练工具：

• /ljg-learn —— 学习笔记
• /ljg-card —— 知识卡片
• /ljg-skill-map —— 技能图谱
• /ljg-relationship —— 关系梳理
• /ljg-roundtable —— 圆桌讨论（模拟多角色辩论）

4.4 文档与设计类

document-skills（来自 document-skills 插件）

一站式文档生成工具包：

• /document-skills:pdf —— 生成 PDF
• /document-skills:docx —— 生成 Word 文档
• /document-skills:pptx —— 生成 PowerPoint 演示文稿
• /document-skills:xlsx —— 生成 Excel 表格

还包括一些特色能力：

• /document-skills:frontend-design —— 前端设计
• /document-skills:mcp-builder —— MCP Server 构建器
• /document-skills:web-artifacts-builder —— Web Artifacts 构建

图表与可视化类（来自 markdown-viewer/skills）

Markdown Viewer 团队维护的图表生成 Skill 合集，共 15 个，涵盖从技术图表到商业可视化的全谱系：

• /graphviz —— Graphviz DOT 语言图表（依赖树、模块关系）
• /uml —— UML 图（类图、序列图、活动图等）
• /bpmn —— 业务流程建模（工作流、审批流程）
• /archimate —— 企业架构图（TOGAF 视图）
• /architecture —— 分层系统架构图
• /vega —— Vega/Vega-Lite 数据可视化
• /infocard —— 杂志风格信息卡片
• /infographic —— 信息图表（KPI、时间线、漏斗图）
• /canvas —— 空间节点图（思维导图、知识图谱）
• /cloud —— 云基础设施架构图
• /network —— 网络拓扑图
• /iot —— IoT 设备架构图
• /data-analytics —— 数据分析可视化
• /security —— 安全架构图
• /mind-map —— 思维导图

4.5 项目管理与安全守护类

gstack 工程流程（来自 garrytan/gstack）

Garry Tan 维护的全栈工程实践 Skill 合集，共 29 个，覆盖从开发到部署的完整工程流程：

• /ship —— 发布流程
• /canary —— 灰度发布
• /freeze / /unfreeze —— 冻结/解冻编辑范围
• /guard —— 全安全模式（= /careful + /freeze），保护分支和危险操作
• /careful —— 危险命令警告
• /review —— 代码审查
• /qa / /qa-only —— 质量保证检查
• /browse —— Web 浏览
• /autoplan —— 自动规划
• /benchmark —— 性能基准测试
• /investigate —— 问题调查
• /retro —— 回顾总结
• /office-hours —— 办公时间模式
• /plan-ceo-review / /plan-eng-review / /plan-design-review —— 多角色计划审查
• /design-consultation / /design-review —— 设计咨询与审查
• /land-and-deploy / /setup-deploy —— 部署工作流
• /document-release —— 发布文档
• /connect-chrome / /setup-browser-cookies —— 浏览器配置
• /cso —— 首席安全官模式
• /codex —— Codex 集成
• /gstack / /gstack-upgrade —— gstack 自身管理

代码审查工作流

• /code-review:code-review（来自 code-review 插件）—— 通用代码审查
• /pr-review-toolkit:review-pr（来自 pr-review-toolkit 插件）—— PR 审查，自动派遣多个专项 reviewer 代理

五、Hooks —— 事件驱动的自动化

Hooks 是绑定到 Claude Code 生命周期事件的自动化脚本。与 Skills 不同，Hooks 不需要手动调用——它们在特定事件发生时自动执行。

我使用的 Hooks 主要来自以下插件：

caffeinate（来自 caffeinate 插件，自建）

我自建的第一个插件，功能很简单：在 Claude Code 运行期间防止 Mac 进入休眠。当你让 Claude 执行一个耗时几十分钟的任务时，你不希望电脑中途睡过去。底层就是调用 macOS 的 caffeinate 命令。

warp（来自 warp 插件）

Warp 终端的集成插件。如果你使用 Warp 作为终端，这个插件能让 Claude Code 更好地与 Warp 的特性配合，例如通知功能。

security-guidance（来自 security-guidance 插件）

安全检查钩子，在代码操作时自动检查潜在的安全问题。

hookify（来自 hookify 插件）

这是一个"元插件"——它不是执行某个特定的 Hook，而是帮你从对话中发现并生成 Hook 规则。当你在对话中遇到 Claude 的某些不期望行为时，可以用 /hookify 分析对话历史，自动生成防护规则。它内部有一套规则引擎（rule_engine.py），支持 regex 匹配、字段提取等能力。

guard Skill 内置 Hooks（gstack 自定义 Skill）

/guard Skill 激活后会注册 PreToolUse 钩子：当 Claude 要执行 Bash 命令时，自动检查是否包含危险操作（rm -rf、DROP TABLE、--force 等）；当 Claude 要编辑文件时，自动检查是否超出了冻结的编辑范围。

六、Agents —— 子代理协作

Agents 是可以被 Claude 派遣去执行专项任务的子代理。每个 Agent 有自己的工具权限和专业领域，执行完毕后将结果返回给主 Claude。

code-simplifier（来自 code-simplifier 插件）

专注于代码简化——审查刚写完的代码，找出可以优化的冗余、不一致和可维护性问题。在完成实现后自动触发。

feature-dev 三剑客（来自 feature-dev 插件）

• code-explorer —— 深度分析现有代码，追踪执行路径，映射架构层次
• code-architect —— 设计 Feature 架构，给出具体的文件创建/修改方案
• code-reviewer —— 审查代码质量，检查 bug、安全漏洞和规范遵守情况

三个代理按阶段串行执行，覆盖"理解 → 设计 → 审查"全流程。

pr-review-toolkit 多维审查（来自 pr-review-toolkit 插件）

这是我见过最全面的代码审查代理集合，包含多个专项 reviewer：

• silent-failure-hunter —— 猎杀静默失败，检查错误处理是否充分
• type-design-analyzer —— 分析类型设计质量，评估封装性和不变量表达
• pr-test-analyzer —— 分析测试覆盖率和质量
• code-simplifier —— 代码简化审查
• comment-analyzer —— 注释准确性审查

每个 reviewer 从不同维度审查同一份代码，最终汇总出全面的审查报告。

compound-engineering 专家团（来自 compound-engineering 插件）

Every 公司的工程审查矩阵，根据代码变更的类型自动选择对应的 reviewer：

• correctness-reviewer —— 逻辑正确性（always-on）
• maintainability-reviewer —— 可维护性（always-on）
• testing-reviewer —— 测试覆盖（always-on）
• security-reviewer —— 安全审查（触发条件：涉及 auth/权限）
• performance-reviewer —— 性能审查（触发条件：涉及数据库查询/循环）
• adversarial-reviewer —— 对抗性审查（触发条件：大 diff 或高风险领域）

还有更多细分角色：Rails reviewer、TypeScript reviewer、Python reviewer、API contract reviewer 等。

codex（来自 codex 插件）

调用 OpenAI 的 Codex 作为"第二意见"。当 Claude 自己卡住或者需要不同视角时，可以把问题交给 Codex 处理，然后综合两方结果。有点像请了一个外部顾问。

七、总结与建议

插件选择原则

插件不是越多越好。29 个插件听起来很多，但每一个都有明确的使用场景。选择插件的原则：

1. 匹配你的工作流 —— 不做前端就不需要 Vue 全家桶 Skill；不用 Obsidian 就不需要 claude-obsidian
2. 分层配置 —— 通用工具放 User 级别，项目特定的放 Project 级别，个人偏好放 Local 级别
3. 组件类型互补 —— MCP Server 解决"能不能"，Skills 解决"怎么做"，Hooks 解决"自动做"，Agents 解决"帮我做"