鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册
站长：程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
7
3
14

Claude Code凯神实战指南 - 第六章：Plugins全攻略——一键安装海量扩展，还能自己造轮子

lenyan
lenyan
2026-03-30 15:11
阅读 4643
lenyan
2026-03-30 15:11
阅读 4643

第六章：Plugins全攻略——一键安装海量扩展，还能自己造轮子

📖 项目简介

这是由凯神精心打造的一套完整的 Claude Code 实战教程系列，从零基础环境安装，到企业级安全合规，全面系统地覆盖 Claude Code 的所有核心功能。

8个完整章节，包含：Commands / MCP / Hooks / Skills / Plugins / 团队协作 / 企业安全 等全部内容。

全中文编写，实战导向，每个章节都经过真实场景验证，帮助你快速从零开始，到能独立管理企业级项目。

👨‍🏫 关于作者

Lenyan 凯神

一名即将进入社会的应届生开发工程师。在学习 Claude Code 的过程中，深刻体验到它能极大提升开发效率。凯神把自己的学习笔记和实践经验整理成这套教程，希望帮助更多同学和新人开发者快速掌握这个强大工具。

这套教程的初衷很简单：让大家真正用上 Claude Code，提升编程效率，少走弯路。

凯神的观点：做好指挥官，让 AI 为你工作。

📚 笔记链接目录

1、Claude Code 实战指南 - 从零到起飞✨第一章

2、Claude Code 实战指南 - 30+命令与快捷键✨第二章

3、Claude Code 实战指南 - 自定义Commands让AI秒懂你✨第三章

4、Claude Code 实战指南 - MCP、Hooks与Subagent实战✨第四章

5、Claude Code 实战指南 - Skills定制给Claude装能力✨第五章

6、Claude Code 实战指南 - Plugins全攻略✨第六章

7、Claude Code 实战指南 - 企业级协作规范与CICD✨第七章

8、Claude Code 实战指南 - 企业深水区密钥安全✨第八章

立即开始学习 → 点击上方任意章节开始你的 Claude Code 之旅！🚀

目录

  • 1. 前言
  • 2. Plugin 核心概念
    • 2.1 Plugin 是什么
    • 2.2 Plugin vs Commands / Skills / MCP
    • 2.3 生态现状
  • 3. 5 分钟安装第一个 Plugin
    • 3.1 前置检查
    • 3.2 浏览与安装 Marketplace
  • 4. Plugin 管理全流程
    • 4.1 安装 Plugin（Discover 标签页）
    • 4.2 管理已安装的 Plugin（Installed 标签页）
    • 4.3 管理 Marketplace 源（Marketplaces 标签页）
  • 5. 创建自定义 Plugin
    • 5.1 Plugin 结构规范
    • 5.2 plugin.json 详解
    • 5.3 实战：Hello World Plugin
    • 5.4 进阶：带 Skill 的完整 Plugin
    • 5.5 开发最佳实践
  • 6. 发布与分享
    • 6.1 发布前检查清单
    • 6.2 发布到 GitHub
    • 6.3 提交到官方 Marketplace
  • 7. 故障排查
  • 8. 常见问题 FAQ
  • 9. 总结
  • 10. 参考资料
  • 下一步学习

1. 前言

学完 Skills，你已经能给 Claude 装上各种专属能力包了。

但你有没有想过一个问题——辛辛苦苦写好的 Commands + Skills + Hooks 配置，换个项目又得重来一遍？想分享给团队成员？手动复制粘贴？

Plugin 就是解决这个问题的终极方案：

痛点Plugin 怎么解决类比
配置不可移植一个 Plugin 打包所有配置，一键安装手机备份恢复
分享靠手动复制Marketplace 搜一下装一下App Store
更新全靠自己盯自动更新，作者推了新版你自动获得APP 自动更新
找好用的工具费时间社区 200+ Plugin 直接选排行榜推荐

说白了：Plugin = 可分享、可安装、可自动更新的 Commands + Skills + Hooks + MCP 打包体。

2. Plugin 核心概念

2.1 Plugin 是什么

Plugin 是 Claude Code 的扩展包——把 Commands、Skills、Hooks、MCP 配置打包成一个可安装、可分享、可自动更新的整体。

类比理解：

手机Claude Code
操作系统（iOS/Android）Claude Code 核心
App StorePlugin Marketplace
安装的 APP已安装的 Plugins
APP 自动更新Plugin 自动更新

核心价值：

价值说明
可复用一次开发，多个项目使用
可分享通过 Marketplace 一键安装，不用手动复制
模块化每个 Plugin 专注一个领域，互不干扰
社区驱动200+ 社区 Plugin 开箱即用

2.2 Plugin vs Commands / Skills / MCP

很多人问："我已经有 Commands 和 Skills 了，为什么还要 Plugin？"

一张表说清楚：

维度CommandsSkillsMCPPlugins
定义Markdown 提示词专业 Agent 能力外部服务集成打包的扩展
存放位置.claude/commands/.claude/skills/.mcp.json.claude/plugins/
可分享性❌ 手动复制❌ 手动复制⚠️ 需配置✅ 一键安装
自动更新❌ 手动更新❌ 手动更新⚠️ 部分支持✅ 自动更新
包含内容单个提示词多个文件+配置服务器配置全部都能包含
适用场景简单重复任务复杂专业任务外部 API 调用所有场景

关键区别：Plugin 是一个**"超集"**概念——Plugin = Commands + Skills + Hooks + MCP 配置 + 文档，打包成一个可以一键安装和分享的整体。

何时用什么？决策指南：

  • Commands：项目内简单重复任务（如 /format-code）——够用就行，别上 Plugin
  • Skills：项目内复杂专业任务（如代码注释生成）——能力需要积累和复用
  • MCP：需要调用外部服务（如 GitHub API、数据库）——解决连接问题
  • Plugins：✅ 想分享给团队或社区的任何功能——打包分发的最佳选择

2.3 生态现状

三大 Marketplace：

平台地址特点
Anthropic 官方 Marketplacecode.claude.com/plugins审核严格，质量保证
Jeremy Longshore 社区合集github.com/jeremylongshore/claude-code-plugins-plus200+ Plugin，持续更新
Composio Integrationcomposio.dev集成 2000+ 外部工具

热门 Plugin 分类速查：

分类典型 Plugin用途来源热度
文档处理document-skillsPDF/PPTX/XLSX 全套文档处理Anthropic 官方⭐⭐⭐⭐⭐
示例学习example-skills官方 Skill 开发示例Anthropic 官方⭐⭐⭐
代码质量code-review-expert自动代码审查社区⭐⭐⭐⭐
项目管理task-master-ai任务拆解和跟踪社区⭐⭐⭐⭐
API 集成connect-appsGmail/Slack/GitHub 联动社区⭐⭐⭐⭐⭐
数据分析data-viz-pro数据可视化社区⭐⭐⭐

说明：document-skills 是 Anthropic 官方出品的文档处理套件（来自 anthropics/skills 源），安装后包含 document-skills:pdf、document-skills:pptx、document-skills:xlsx 等多个 Skill，一次安装全部可用。

3. 5 分钟安装第一个 Plugin

3.1 前置检查

▼
bash
复制代码
# 1. 确认 Claude Code 版本（需 v2.1+）
claude --version

# 2. 确认在项目目录中
cd /path/to/your/project

Plugin 功能于 2025 年 10 月 9 日随 Claude Code v2.1 发布。如果版本过低，先升级。

3.2 浏览 Marketplace

方式一：对话内 /plugin 命令（最方便）

在 Claude Code 对话中直接输入：

▼
text
复制代码
/plugin

会进入 Plugin 管理界面，切换到 Marketplace 标签页即可浏览所有可用 Plugin。

方式二：CLI 命令

▼
bash
复制代码
# 添加社区 Marketplace 源（第一次用需要先添加）
claude plugin marketplace add anthropics/skills

# 查看已添加的 Marketplace 源
claude plugin marketplace list

添加成功后，就能从该源浏览和安装 Plugin 了。

image.png

实战：添加 Marketplace 源并安装 Plugin

以添加 VoltAgent Subagent 代理库为例，完整流程：

▼
bash
复制代码
# 1. 添加 Marketplace 源
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents

▼
bash
复制代码
# 2. 从该源安装你需要的 Plugin
claude plugin install <plugin-name>

或者在对话中输入 /plugin，切换到 Installed 界面自行浏览安装。

网络问题？ 如果安装过程中遇到超时或下载失败，需要检查代理软件配置：

▼
powershell
复制代码
# Windows PowerShell（根据自己的代理端口修改）
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"

▼
bash
复制代码
# macOS / Linux
export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"

方式三：Web 浏览器

直接访问官方 Marketplace 网页：https://code.claude.com/plugins

4. Plugin 管理全流程

在 Claude Code 对话中输入 /plugin，进入图形化管理界面。界面顶部有四个标签页，覆盖所有管理场景：

标签页功能
Discover浏览并安装 Plugin（默认打开）
Installed查看和管理已安装的 Plugin
Marketplaces管理 Plugin 源
Errors排查加载错误

界面导航：↑↓ 上下移动，空格 快速安装/切换，回车 进入详情，ESC 返回上级

4.1 安装 Plugin（Discover 标签页）

打开 /plugin，默认进入 Discover 标签页，列出所有已添加 Marketplace 源中的可用 Plugin：

安装步骤：

  1. 用 ↑↓ 移动光标，选中想安装的 Plugin
  2. 按回车查看详情（或直接按空格快速安装）
  3. 在详情页选择安装范围，确认安装

安装范围说明：

范围说明适用场景
Install for you (user scope)个人级：你的所有项目都可用日常通用工具（推荐）
Install for all collaborators on this repository (project scope)项目级：整个仓库的协作者共享团队协作项目
Install for you, in this repo only (local scope)本地仓库级：仅自己在此项目可用本地测试、不想影响他人

三种安装来源：

来源操作方式
Marketplace Plugin（推荐）在 Discover 标签页直接选中安装
GitHub URL在 Discover 页顶部输入 GitHub 仓库地址
本地目录在 Discover 页顶部输入本地路径（开发测试用）

找不到想装的 Plugin？ 先去 Marketplaces 标签页添加对应的源，再回 Discover 刷新列表。

4.2 管理已安装的 Plugin（Installed 标签页）

切换到 Installed 标签页，查看所有已启用的 Plugin：

列表中同时显示 Plugin 系统安装的扩展和 MCP 连接，每条显示名称、版本和状态。

更新 / 禁用 / 卸载操作：

选中某个 Plugin，按回车进入详情，可执行以下操作：

操作效果
更新升级到最新版本（有新版本时显示）
禁用临时停用，保留文件，下次可重新启用
卸载彻底删除 Plugin 及其所有文件

自动更新：Claude Code 启动时会自动检查所有 Plugin 更新，无需手动触发。

4.3 管理 Marketplace 源（Marketplaces 标签页）

切换到 Marketplaces 标签页，管理 Plugin 的来源：

界面列出所有已添加的 Marketplace 源，每个源显示可用 / 已安装的 Plugin 数量，以及最后更新时间。

添加新 Marketplace 源：

  1. 在 Marketplaces 标签页选择"添加源"
  2. 输入源地址（格式：用户名/仓库名）
  3. 确认添加后，Discover 标签页自动同步新来源的 Plugin

推荐 Marketplace 源：

源地址内容推荐指数
anthropics/skills官方 Skills 套件（含 document-skills 全家桶）⭐⭐⭐⭐⭐
anthropics/claude-plugins-officialAnthropic 官方 Plugin⭐⭐⭐⭐
VoltAgent/awesome-claude-code-subagents100+ 专家 Subagent（详见第04章）⭐⭐⭐⭐
jeremylongshore/claude-code-plugins-plus社区 200+ Plugin，持续更新⭐⭐⭐

Marketplace 源详情示例（anthropics/skills）：

▼
text
复制代码
anthropic-agent-skills (anthropics/skills)
3 available · 1 installed · Updated 2026/3/6

  ✅ document-skills (installed)
     Collection of document processing suite including Excel...
  ○  example-skills
     Collection of example skills demonstrating various capabi...

推荐先装：document-skills（官方文档处理套件），安装后自动获得 pdf、pptx、xlsx 等全套 Skill，一次搞定所有文档格式。

5. 创建自定义 Plugin

5.1 Plugin 结构规范

Plugin 本质上是一个目录，里面有个 .claude-plugin/plugin.json 清单文件，加上你要打包的各种能力。

最小结构（一个 Skill）：

▼
text
复制代码
my-plugin/
├── .claude-plugin/
│   └── plugin.json      # 必需：Plugin 清单
└── skills/
    └── my-skill/
        └── SKILL.md

完整结构（所有能力）：

▼
text
复制代码
my-plugin/
├── .claude-plugin/
│   └── plugin.json      # 必需：Plugin 清单（只有这个在 .claude-plugin/ 内）
├── README.md            # 推荐：使用文档
├── LICENSE              # 推荐：开源协议
├── skills/              # 可选：Agent Skills
│   └── my-skill/
│       └── SKILL.md
├── commands/            # 可选：Slash Commands
│   └── my-command.md
├── agents/              # 可选：自定义 Agent 定义
├── hooks/               # 可选：事件钩子
│   └── hooks.json
├── .mcp.json            # 可选：MCP 服务配置
└── settings.json        # 可选：Plugin 启用时的默认设置

⚠️ 常见踩坑：commands/、skills/、agents/、hooks/ 都放在插件根目录，不要放进 .claude-plugin/ 里——那里只放 plugin.json。

各目录职责速查：

目录/文件职责
.claude-plugin/plugin.jsonPlugin 清单，定义名称/版本/作者
skills/Agent Skills（含 SKILL.md 的子目录）
commands/Slash 命令（Markdown 文件）
agents/自定义 Agent 定义
hooks/事件处理器（hooks.json）
.mcp.jsonMCP 服务配置
settings.jsonPlugin 启用时应用的默认设置

5.2 plugin.json 详解

plugin.json 放在 .claude-plugin/ 目录下，是 Plugin 的「身份证」。

完整示例：

▼
json
复制代码
{
  "name": "my-awesome-plugin",
  "description": "一句话说明这个 Plugin 做什么",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "license": "MIT",
  "homepage": "https://github.com/yourname/my-plugin",
  "repository": "https://github.com/yourname/my-plugin"
}

字段速查：

字段是否必填说明
name✅Plugin 唯一标识，同时是 Skill 的命名空间前缀
description✅功能描述，Marketplace 中用于搜索和展示
version✅语义化版本号（主.次.补丁，如 1.0.0）
author推荐作者信息（name / email / url）
license推荐开源协议（推荐 MIT 或 Apache-2.0）
homepage可选项目主页或文档地址
repository可选代码仓库地址

关键点：name 字段决定了 Skill 的调用前缀。Plugin 名叫 my-plugin，里面的 hello Skill 就要用 /my-plugin:hello 来触发——命名空间设计防止多个 Plugin 的 Skill 名称冲突。

5.3 实战：Hello World Plugin

5 分钟从零创建并测试你的第一个 Plugin：

Step 1：创建目录结构

▼
bash
复制代码
mkdir -p hello-plugin/.claude-plugin
mkdir -p hello-plugin/skills/hello

Step 2：创建清单 .claude-plugin/plugin.json

▼
json
复制代码
{
  "name": "hello-plugin",
  "description": "一个简单的问候示例 Plugin",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "license": "MIT"
}

Step 3：创建 Skill skills/hello/SKILL.md

▼
markdown
复制代码
---
description: Greet the user with a friendly message
---

用友好的方式向用户打招呼。

步骤：
1. 获取当前系统时间
2. 根据时间段（上午/下午/晚上）调整问候语
3. 用轻松愉快的语气回复

示例输出：
"早上好！现在是 10:23，新的一天，有什么我能帮你的？"

Step 4：本地测试

不需要安装，直接用 --plugin-dir 标志加载：

▼
bash
复制代码
# 加载插件并启动 Claude Code
claude --plugin-dir ./hello-plugin

# 启动后在对话里输入（注意命名空间格式）
> /hello-plugin:hello

看到问候输出，第一个 Plugin 就跑通了！

--plugin-dir 是开发专用标志，每次修改 Skill 后重启 Claude Code 即可生效，无需安装。要同时测试多个 Plugin，可以多次指定：claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b

Step 5：带参数的 Skill

$ARGUMENTS 占位符可以捕获用户输入的文本，让 Skill 动态响应：

▼
markdown
复制代码
---
description: Greet the user with a personalized message
---

用友好的方式向名叫 "$ARGUMENTS" 的用户打招呼，让问候更有温度。

重启后测试：

▼
bash
复制代码
> /hello-plugin:hello 凯神
# Claude 会用你传入的名字问候

5.4 进阶：带 Skill 的完整 Plugin

创建一个代码质量检查 Plugin，演示 Skill + Commands 的组合威力：

项目结构：

▼
text
复制代码
code-quality-checker/
├── .claude-plugin/
│   └── plugin.json
├── README.md
├── skills/
│   └── code-review/
│       └── SKILL.md
└── commands/
    └── check.md

.claude-plugin/plugin.json：

▼
json
复制代码
{
  "name": "code-quality-checker",
  "description": "自动检查代码质量，按严重程度给出改进建议",
  "version": "1.0.0",
  "author": { "name": "Your Name" },
  "license": "MIT"
}

skills/code-review/SKILL.md：

▼
markdown
复制代码
---
description: Reviews code for best practices, security issues, and quality problems. Use when reviewing code, checking PRs, or analyzing code quality.
---

# 代码质量检查专家

## 角色定义
你是一位资深代码审查专家，擅长发现代码质量问题并给出具体改进建议。

## 检查维度
1. **命名规范**：变量名/函数名是否语义清晰
2. **函数复杂度**：单个函数是否过长或嵌套过深
3. **重复代码**：是否存在可抽取的重复逻辑
4. **错误处理**：异常边界是否覆盖
5. **安全隐患**：是否存在注入/XSS 等风险

## 输出格式
按严重程度排序：
- 🔴 严重：必须修复
- 🟡 警告：建议修复
- 🟢 建议：可以改进

每条包含：问题描述 + 代码位置 + 修复建议

commands/check.md：

▼
markdown
复制代码
对指定代码进行质量检查。

参数：$ARGUMENTS（可选，指定检查的文件路径）

步骤：
1. 如果指定了文件路径，只检查该文件
2. 如果未指定，检查最近修改的文件（通过 git diff --name-only 获取）
3. 按 5 个维度逐项分析，输出分级报告

测试：

▼
bash
复制代码
claude --plugin-dir ./code-quality-checker

# 触发 Skill（自动识别）
> 帮我检查这段代码的质量

# 显式调用命令（注意命名空间）
> /code-quality-checker:check src/app.ts

Plugin 的「超集」威力在这里体现得很清楚：Commands 提供触发入口，Skills 提供专业能力，打包在一起就是可分享的完整工具。

5.5 开发最佳实践

1. 先用独立配置，再转 Plugin

阶段方式原因
实验期直接放 .claude/skills/Skill 名短（/hello），迭代快
准备共享打包成 PluginSkill 带命名空间（/my-plugin:hello），便于分发

2. 语义化版本号

▼
text
复制代码
版本号格式：主.次.补丁（如 1.2.3）
  - 主版本（1.x.x）：破坏性变更，不向后兼容
  - 次版本（x.2.x）：新增功能，向后兼容
  - 补丁版（x.x.3）：Bug 修复

3. README 必须包含四个部分

部分内容
功能说明这个 Plugin 做什么，解决什么问题
安装方法从 Marketplace 或 GitHub 安装的命令
使用示例至少一个真实使用场景（含 Skill 调用格式）
配置说明如果有可配置项的话

4. Skill description 是关键

SKILL.md frontmatter 中的 description 决定 Claude 能否自动识别场景并激活 Skill：

▼
markdown
复制代码
# ❌ 太模糊，自动激活不准
description: Code review tool

# ✅ 明确触发场景，自动识别准确
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.

6. 发布与分享

6.1 发布前检查清单

必须完成：

  • ✅ .claude-plugin/plugin.json 格式正确，name/description/version 填写完整
  • ✅ README.md 包含安装和使用说明（含 Skill 调用格式 /插件名:skill名）
  • ✅ LICENSE 文件存在（推荐 MIT）
  • ✅ 用 claude --plugin-dir . 本地测试通过，所有 Skill 和命令正常工作

推荐完成：

  • ⭐ CHANGELOG.md 记录每个版本的变更内容
  • ⭐ GitHub 仓库添加 Topics 标签（如 claude-code-plugin），便于被搜索
  • ⭐ README 中注明最低 Claude Code 版本要求

6.2 发布到 GitHub

▼
bash
复制代码
# 1. 初始化仓库
cd my-plugin
git init
git add .
git commit -m "feat: initial release v1.0.0"

# 2. 推送到 GitHub
git remote add origin https://github.com/yourname/my-plugin.git
git branch -M main
git push -u origin main

创建 Release（让别人能按版本安装）：

  1. 进入 GitHub 仓库页面，点击 Releases → Draft a new release
  2. Tag version 填 v1.0.0（必须以 v 开头）
  3. 填写本次发布说明
  4. 点击 Publish release

发布后，其他人就能通过 GitHub URL 直接安装：

▼
bash
复制代码
# 在 /plugin 界面的 Discover 页顶部输入 GitHub 地址安装
# 或用 CLI
claude plugin install https://github.com/yourname/my-plugin

在 README 中加个版本徽章，一眼看出当前版本：

▼
markdown
复制代码
[Version](https://img.shields.io/github/v/release/yourname/my-plugin)

6.3 提交到官方 Marketplace

想让全球 Claude Code 用户都能搜到你的 Plugin？直接用应用内提交表单，不需要 Fork 仓库、提 PR，一个表单搞定：

平台提交入口
Claude.aiclaude.ai/settings/plugins/submit
Anthropic Consoleplatform.claude.com/plugins/submit

提交前确认：

审核项要求
.claude-plugin/plugin.json格式正确，必填字段完整
README安装和使用说明完整，含 Skill 调用格式
代码安全无恶意代码，依赖来源可信
功能完整--plugin-dir 测试全部通过

提交后等待 Anthropic 审核（通常 1-3 个工作日）。审核通过后，你的 Plugin 就会出现在官方 Marketplace，全球 Claude Code 用户都能一键安装。

7. 故障排查

7.1 安装问题

现象原因解决方法
Plugin not found名称拼写错误或 Marketplace 源未添加先在 Marketplaces 标签页添加源，再到 Discover 搜索
下载超时网络问题设置代理或切换 npm 镜像源
/plugin 命令不存在Claude Code 版本过低升级到 v1.0.33+（运行 claude --version 确认）
▼
bash
复制代码
# 网络问题？换国内镜像源
npm config set registry https://registry.npmmirror.com

# 需要代理？（根据自己的代理端口修改）
export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"

7.2 运行时问题

现象原因解决方法
Skill 调用格式不对忘记命名空间前缀Plugin 内的 Skill 用 /插件名:skill名 格式
Skill 未自动激活SKILL.md 的 description 描述太模糊明确写出触发场景，如 "Use when reviewing code..."
Hook 脚本权限错误脚本缺少执行权限chmod +x hooks/my-hook.sh
配置修改不生效未重启 Claude Code修改 Plugin 内容后需重启

7.3 开发调试

现象原因解决方法
--plugin-dir 加载失败目录结构不正确确认 .claude-plugin/plugin.json 存在于插件根目录
Plugin 中 Skill 找不到skills/ 放错位置skills/ 必须在插件根目录，不能在 .claude-plugin/ 内
plugin.json 解析报错JSON 格式错误用在线 JSON 验证工具检查，确认冒号后有空格、无多余逗号
▼
bash
复制代码
# 启用详细日志排查问题
export CLAUDE_LOG_LEVEL=debug
claude --plugin-dir ./my-plugin

8. 常见问题 FAQ

Q1：Plugin 和 Skill 到底啥区别？

一句话：Skill 是能力本身，Plugin 是把能力打包成可安装、可分享的形式。 Plugin 可以包含 Skill，也可以包含 Commands、Hooks、MCP 配置等。

Q2：Plugin 更新会覆盖我的配置吗？

不会。更新时保留你的 config.json（个人配置），只更新 Plugin 代码文件（skills/、commands/ 等）。

Q3：Plugin 开发需要懂编程吗？

类型需要编程？说明
只有 Commands 的 Plugin❌ 不需要写 Markdown 就行
包含 Skills 的 Plugin❌ 不需要写 Markdown（SKILL.md）
带脚本的 Plugin✅ 需要Python/JavaScript 基础
带 MCP Server 的 Plugin✅ 需要Node.js/Python 开发经验

Q4：Plugin 可以离线使用吗？

安装在本地的 Plugin 可以离线使用。但如果 Plugin 内部调用了外部 API（如 GitHub API），那部分功能需要联网。

Q5：Plugin 支持哪些编程语言？

语言支持度适用场景
JavaScript/TypeScript⭐⭐⭐⭐⭐MCP 集成、CLI 工具
Python⭐⭐⭐⭐⭐数据处理、AI 集成
Shell Script⭐⭐⭐⭐系统操作、自动化
Go / Rust⭐⭐高性能工具，需编译为可执行文件

Q6：如何查看 Plugin 使用了多少 Token？

可以通过 /cost 命令查看整体 Token 消耗。Plugin 本身不单独计费，Token 消耗取决于 Plugin 加载的提示词量和对话内容。

Q7：可以同时安装多个版本的 Plugin 吗？

不可以。同一个 Plugin 只能安装一个版本。如果需要在不同项目使用不同版本，可以用项目级安装（默认）隔离。

Q8：Plugin 报错如何获取帮助？

  1. 查看 Plugin 的 README 和 GitHub Issues
  2. 在 Anthropic Discord 的 #claude-code-plugins 频道提问
  3. 提 GitHub Issue 时包含：系统环境、Claude Code 版本、Plugin 版本、完整错误信息

9. 总结

本章你已掌握：

  1. Plugin 本质：可分享的 Commands + Skills + Hooks + MCP 打包体，一键安装、自动更新
  2. 核心区别：Plugin 是"超集"概念，解决了 Commands/Skills 无法便捷分享的痛点
  3. 生态现状：官方 Marketplace + 社区 200+ Plugin，按需选择
  4. 安装管理：/plugin 界面的 Discover / Installed / Marketplaces 三大标签页，全程图形化操作
  5. 自定义开发：.claude-plugin/plugin.json 清单 + skills/ + commands/ 标准结构，--plugin-dir 秒测试
  6. 发布分享：GitHub Release 发布 + 官方 Marketplace 表单提交，让全世界用上你的 Plugin

10. 参考资料

Plugin 相关资源

  • Claude Code 官方 Plugin 文档
  • 知乎深度讲解：Claude Code Plugin 完整指南
  • 知乎教程：Claude Code Plugin 实战与最佳实践
  • ClaudeCN 中文文档：Plugin 开发与使用

下一步学习

章节主题你将学到
第07章从单兵到团队——企业级协作规范、CI/CD 与安全合规实战团队协作规范、GitHub Actions CI/CD 集成、安全权限配置、成本控制
第08章企业深水区——密钥安全、团队配置与合规审计全攻略团队配置统一化、Git Hooks 自动审查、API Key 分级管理、GDPR/SOC2 合规、安全扫描

作者简介：一名正在实习的Java开发工程师，热爱技术分享，专注于性能优化和系统架构设计。

觉得有用的话可以点点赞 (/ω＼)，支持一下。

如果愿意的话关注一下。会对你有更多的帮助。

每周都会不定时更新哦 >人< 。

版权声明：本文为原创技术文章，转载请注明出处。

AI
人工智能
技术
文档
Java
7
14
分享
操作

相关专栏

ClaudeCode实战指南

ClaudeCode实战指南

ClaudeCode实战指南

评论
相关内容
0个评论
全部评论
点击登录，快来和大家讨论吧～
表情
图片

目录

🔥 热门文章
1
手把手教你设计一个成熟的 Agent Harness
2500
2
我用 REA 逆向了付费颜色 APP，结果很意外！
570
3
离谱，DeepSeek 崩了 5 小时，大家却喊：梁圣恩情还不完？？
420
4
DeepSeek 全新模型发布，性价比最高的一集！
380
5
B 站上 DeepSeek 闹鱼灾了，我发起《大肥鱼清除计划》！
370
6
自己学习ai，直接买cursor 的套餐，还是买gpt 或者claude 的套餐?
360
7
又一个国产版 Codex 神器，也来卷办公了！
330
8
day3-如何写出一个高质量的 Skill（组内分享） 高质量 Skill 不是“一个调得很顺的巨型 Prompt”，而是一个可验证、可回归、可维护的能力包。 先定义“什么算好”，再实现“怎么做好”。评估体系先于 Skill 本身成型。 下面用“故障诊断 Markdown 转 YAML”作为例子，但方法是通用的。 --- 一、先想清楚：Skill 到底是什么 一个 Skill 至少包含四部分： 部分 作用 接口 输入什么、输出什么、边界在哪 流程 分几步做，每步的产物是什么 规则 硬约束、经验规则、失败模式 降级策略 不确定时怎么办，而不是硬编一个看似合理的结果 高质量 Skill 的共同点：职责单一、接口清晰、规则可定位、输出可验证。 反例：把几十条经验全塞进一个主 Prompt，改一条规则要重调整个 Prompt，评估时也不知道是哪条规则退化。 --- 二、核心方法：先建评估，再写 Skill 不要先写转换器再补测试。正确顺序是： 1. 定义输出契约：什么算合法、什么算合格； 2. 建金标准集：一小批人工认可“可放行”的样本； 3. 先写评估 Skill：让它在金标准集上跑出基线； 4. 再迭代生成 Skill：每次修改跑同一套评估，无退化且目标维度提升才算正向。 这就是评估驱动开发：评估是 Skill 的单元测试，金标准集是回归锚点。 --- 三、评估 Skill：三层门禁，逐层递进 前一层不过，后一层不跑。每层留可追溯证据。 第 1 层：确定性硬门禁 用解析器、Schema、校验器完成，不消耗模型成本。 · 输出可解析； · 必填字段齐全，类型/枚举合法； · 引用目标存在，无悬空引用、无不可达节点； · 关键路径至少有一条能到达预期出口。 不通过直接打回。 第 2 层：语义断言 用脚本 + 结构遍历检查“逻辑对不对”，仍然保持确定性。 通用检查项： · 覆盖率：源材料里的关键步骤、分支、条件，输出里是否都有对应？ · 完整性：每个判断节点是否都有明确出口？有没有死胡同？ · 可达性：每条路径是否都能到达预期终点？有没有无出口循环？ · 顺序与依赖：有先后依赖的操作，是否保留了顺序？有没有被拍平成无序列表？ 例子：故障诊断转换中，检查“每个判断项是否有是/否/异常出口”“每条路径是否能到根因”。 第 3 层：LLM-as-Judge 只处理解析器表达不了的维度：忠实度、完整性、可执行性。 但 Judge 会漂移，不能单独放行，必须建立在第 1、2 层之上。Judge 的 Prompt、rubric、模型版本都要版本化，换模型必须用金标准集重新校准。 通用 Judge 维度： 维度 问什么 忠实度 输出是否忠实源材料意图？有没有自行发明内容？ 完整性 关键步骤、条件、证据是否保留？隐式知识有没有被压成空话？ 收敛性 输出是否仍指向原目标，而不是发散？ 可执行性 下游不依赖源材料能否直接使用？ --- 四、金标准集：回归测试的锚点 不需要一开始就标注几百份。用已认可的样本当种子，扩到 15～30 份，覆盖失败模式而非随机抽样： · 完整正例：典型流程； · 边界/异常分支：异常路径、循环、前置失败回退； · 已知易错模式：实际踩过的坑； · 留出集：不参与调优，只用于最终验收，防过拟合。 金标准不需要完美，只需要当前标准下认可可放行。 回归指标：关键路径用 pass^k（k 次全过），稳定性用 pass@k。 --- 五、工程约束：让批量产出可重放 · 幂等：同输入 + 同 Skill 版本 + 同规则 → 输出一致，否则无法判断变好是 Skill 改了还是随机波动； · 隔离不阻断：单份失败进隔离队列，记录失败层和原因，不阻塞其余； · 版本绑定：规则、rubric、金标准集进 Git；每份报告绑定“源版本 + 生成 Skill 版本 + 评估 Skill 版本 + Judge 模型版本”； · 抽样人工复核：Judge 临界样本 + 易错模式，人工抽检结果反过来校准 rubric。 --- 六、Skill 本身怎么写 · SKILL.md 控制篇幅，写清：输入约定、输出契约、分步流程、硬规则、降级策略； · 经验规则放 references/ 或 rules/，按失败模式分类，不要全塞进主 Prompt； · 不确定时标 needs_review: true，不要硬编看似合理的结果； · 迭代由评估报告驱动：报告告诉你哪层挂了、哪类失败模式，你改对应规则文件，而不是漫无目的调 Prompt。 --- 七、落地顺序（不要反过来） 1. 固化输出契约：Schema + 结构约束； 2. 建金标准集：从已认可的 + 最易出错的样本开始； 3. 先写评估 Skill：跑出基线报告； 4. 再迭代生成 Skill：每次修改对比逐项通过率，无退化且目标提升才算正向； 5. 批量运行 + 隔离回放：失败进队列，结束后人工抽检； 6. 评估 Skill 自身版本化：换 Judge 模型必须重新校准。 --- 八、给组员的三条硬要求 1. 不许凭感觉说“变好了”：每次修改必须附评估报告对比，逐项通过率说话。 2. 不许跳过确定性门禁直接看 Judge 分数：前两层挂了，Judge 分数没有意义。 3. 不许把规则堆进主 Prompt：规则按失败模式分文件，评估报告要能定位到具体文件。 --- 一句话收尾 生成 Skill 决定“能不能做”，评估 Skill 决定“敢不敢用”。 先让评估体系站稳，再让生成器迭代。这样交付的不是一堆“看起来还行”的产出，而是一套可证明、可回归、可交接的 Skill 质量体系。
310
9
AI 越强，被它拒绝的代价就越大 我有时候会想：AI 越来越厉害之后，有些事情，会不会反而越来越难做？ 这个想法看起来有点矛盾。AI 明明在降低门槛，让不会写代码的人做出软件，让不会画画的人生成图片，让一个人完成过去需要整支团队才能完成的工作。但今天用 Codex 的时候，AI 拒绝帮我编写 SQL 注入的请求体，而那还是我有源码、在本地跑测试的情况。那么，往后是否只会更难？ 我们假设某一天，AI 说：「这个请求违规，我不能帮助你。」到那个时候，你还有多少能力，能绕过它，把事情做完？ 这里的「违规」需要打个引号。平台的规则、模型的判断、法律的要求，以及一件事实际有没有造成伤害，彼此之间并不总是画得上等号。一个请求可能确实危险，也可能只是缺少上下文被误判，或者恰好落在某家公司的限制范围里。 无论是哪种情况，随着我们越来越依赖 AI，这句拒绝都可能变得越来越贵。 今天，一个程序员让 AI 帮忙写代码，AI 拒绝了，他大概率还有别的办法：查文档、找开源项目、问同行，或者自己写。麻烦一点，慢一点，但路还在。 可如果十年之后，大部分程序都由 AI 完成，情况就不一样了。 很多人从接触编程的第一天起，就习惯了描述需求、等待生成、运行结果、继续迭代。他们能做出相当复杂的产品，却未必经历过独立处理底层问题的训练。平时，这种能力结构完全够用，效率甚至更高。只有 AI 拒绝的时候，他们才会发现：平常被省掉的那段学习过程，恰好是此刻最需要的东西。 到那时，一次拒绝的成本，可能就从「今晚多花两个小时」，变成「先花半年学会这门技术」。 拿 SQL 注入举个稍显极端的例子：往后，连真正理解这类攻击如何发生、能够独立构造测试的人，会不会也越来越少？ 这里也包括那些有正当需求的人。一个开发者想检查自己的旧系统，一个经过授权的安全研究员想复现漏洞，假如 AI 识别到危险模式就拒绝，而使用者又只熟悉「让 AI 帮我检查」，这项原本可以独立完成的工作，就这样卡住了。 但是安全专家不会因此消失，但这类技能可能越来越集中在少数人手里。你仍然可以找专家，只是要付出更多的钱、更多的时间，以及更高的沟通成本。 类似的困境，未必只发生在网络安全领域。 你想从一个停止维护的软件里取回自己的数据，需要解析它的旧文件格式。AI 判断这涉及规避保护措施，拒绝继续。你拥有这些数据，却没有能力把它们读出来。 你买了一台设备，厂商停止提供服务。你想修改程序让它继续运转，过程中需要处理某种访问限制。AI 不愿协助，而你所掌握的维修方式，早已只剩下「把报错发给 AI」。 你想给常用的网站写一个辅助工具，减少重复操作。平台将此归入自动化限制，AI 也据此拒绝。过去会写脚本的人可以自己判断、自己处理；未来的使用者，可能连从哪里开始都不知道。 这些例子有一个共同点：当工具同时承担了「执行工作」和「传授知识」的角色，它的拒绝就不只是挡住了一次任务，也挡住了获得这种能力的机会。 更麻烦的是，这种依赖往往是我们主动选择的，而且每一步都很合理。 既然 AI 几秒钟就能做好，为什么还要花几个月学习？既然公司可以采购成熟的 AI 服务，为什么还要养一支负责基础工作的团队？既然市场上已经很少有人手写这些东西，学校为什么还要花大量时间教？ 对个人、公司和学校来说，这些选择都有现实依据。但叠加起来，整个社会保留的独立能力就可能越来越少。等到某项能力突然受到限制，我们才发现，备用方案早已在追求效率的过程中被一点点削掉了。 所以，「AI 越强，做事越便宜」可能只描述了未来的一半。 另一半是：被允许的事情越来越便宜，被拒绝的事情依然需要人工完成，却要面对更少的人才、更高的报价，以及越来越难获得的知识。两边的成本差距，会越拉越大。 有人会说，可以换一个模型，或者用本地模型。这确实是重要的选项。只要工具之间还有充分竞争，开放模型还足够可用，限制就未必能形成真正的门槛。 但备用方案也需要维护。它需要硬件、知识、软件生态，以及一群仍然理解这些系统的人。如果大多数人已经习惯了最方便的商业服务，那么「理论上还有别的办法」和「普通人实际用得起、用得明白」，之间仍然可能隔着很远。 我担心的，正是这段距离。 我不指望 AI 对任何请求都照单全收。对明显会伤害他人的行为设置限制，有充分的理由。但我们也需要关心：限制由谁定义，误判有没有申诉渠道，用户能不能换工具，以及脱离这个工具之后，还剩下多少独立行动的能力。 保留这些能力，平时看起来甚至有点低效，明明可以自动生成，还要理解原理；明明可以一键完成，还要知道手动怎么做。 但这些看似多余的知识，会在工具拒绝、失效、涨价或改变规则的那一刻，成为真正的选择权。 AI 越强，我们可能越需要留意它说「不」的那一刻。 因为那句话的分量，最终取决于：它拒绝之后，我们还能做什么。
310
10
什么是LLM
300
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
零感AI零感AI
墨得问题墨得问题