乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > Claude Code 插件生态全景:13 个官方扩展一文读懂

Claude Code 插件生态全景:13 个官方扩展一文读懂

当前时间： 2026-04-05 23:57:50 更新时间： 2026-04-05 分类：软件教程 评论(0)

Claude Code 插件生态全景:13 个官方扩展一文读懂

一、插件是什么？

Claude Code 不是单体工具。

它是一个可扩展的平台。

想加新命令？写个 Command。

想特化某个 Agent？写个 Agent。

想注入专业知识？写个 Skill。

想拦截危险操作？写个 Hook。

四种扩展类型，覆盖全生命周期。

类型
功能
激活方式
Commands
Slash 命令
 /command-name
Agents
特化子代理
自动路由或显式调用
Skills
知识注入
自动匹配触发
Hooks
事件拦截
生命周期事件触发

插件 = 可组合的能力单元。

变化的东西，不应该在核心里。

二、13 个官方插件速览

Anthropic 官方维护了 13 个插件。

不是示例代码。是生产可用的工具。

按功能分类

开发类（4 个）

插件
功能
核心组件
agent-sdk-dev
Agent SDK 开发套件
 /new-sdk-app

 + 2 验证 Agents
feature-dev
功能开发 7 阶段工作流
 /feature-dev

 + 3 Agents
plugin-dev
插件开发工具包
 /plugin-dev:create-plugin

 + 3 Agents + 7 Skills
commit-commands
Git 工作流自动化
 /commit

、/commit-push-pr、/clean_gone

审查类（2 个）

插件
功能
核心组件
code-review
PR 审查 + 置信度评分
 /code-review

 + 5 并行 Agents
pr-review-toolkit
PR 审查工具集
 /pr-review-toolkit:review-pr

 + 6 Agents

安全类（1 个）

插件
功能
核心组件
security-guidance
9 种安全模式监控
PreToolUse Hook

学习类（2 个）

插件
功能
核心组件
explanatory-output-style
教育性输出风格
SessionStart Hook
learning-output-style
互动学习模式
SessionStart Hook

迁移类（1 个）

插件
功能
核心组件
claude-opus-4-5-migration
Opus 4.5 迁移工具
Skill

设计类（1 个）

插件
功能
核心组件
frontend-design
前端设计指导
Skill

自动化类（2 个）

插件
功能
核心组件
hookify
Hook 自动创建
4 Commands + 1 Agent + 1 Skill
ralph-wiggum
自迭代循环
 /ralph-loop

 + Stop Hook

一句话定位

开发：

  • feature-dev
     — 从需求到 PR，7 阶段引导开发
  • plugin-dev
     — 从零到发布，8 阶段创建插件
  • agent-sdk-dev
     — Agent SDK 项目快速搭建

审查：

  • code-review
     — 5 个 Agent 并行审查，置信度过滤假阳性
  • pr-review-toolkit
     — 6 个专业审查 Agent（注释/测试/错误/类型/质量/简化）

自动化：

  • hookify
     — 对话分析，自动创建 Hook 规则
  • ralph-wiggum
     — 一个 loop，让 AI 自己迭代到完成

安全/学习/设计：

  • security-guidance
     — 写代码时实时提醒 9 种安全风险
  • learning-output-style
     — 关键决策点邀请你写 5-10 行代码
  • frontend-design
     — 避免 AI 通用美学，创造独特界面

三、plugin-dev：插件开发工具包

这是 Anthropic 官方的插件开发 SOP。

如果你想写一个 Claude Code 插件，用这个工具包就够了。

7 个专业 Skills

Skill
触发词
资源
Hook Development
“create a hook”
3 示例 + 3 参考 + 3 工具脚本
MCP Integration
“add MCP server”
3 示例 + 3 参考
Plugin Structure
“plugin structure”
目录结构指导
Plugin Settings
“plugin settings”
配置模式
Command Development
“create command”
命令开发指导
Agent Development
“create agent”
Agent 生成指导
Skill Development
“create skill”
渐进式披露设计

每个 Skill 都有：

  • 核心指令（~1,600 words）
  • 参考文档（按需加载）
  • 工作示例
  • 工具脚本

8 阶段开发流程

运行 /plugin-dev:create-plugin，进入引导流程：

阶段1: Discovery       — 理解插件目的和需求阶段2: Component Planning — 确定需要的组件（skills/commands/agents/hooks/MCP）阶段3: Detailed Design  — 详细设计每个组件阶段4: Structure Creation — 创建目录和 plugin.json阶段5: Component Implementation — AI 辅助生成组件阶段6: Validation       — 运行验证工具阶段7: Testing          — 在 Claude Code 中实际测试阶段8: Documentation    — 完成 README，准备分发

全程 AI 辅助：

  • agent-creator
     — 自动生成 Agent 配置
  • plugin-validator
     — 验证插件结构
  • skill-reviewer
     — 检查 Skill 质量

从零到发布，一条命令走完。

agent-creator：AI 生成 Agent

这个 Agent 的职责是：帮你写 Agent。

使用方式：

"Create an agent that reviews code for quality issues"

agent-creator 会：

  1. 提取核心意图
     — 识别你需要什么
  2. 设计专家人格
     — 创建领域专家身份
  3. 架构指令
     — 生成完整的 Agent 配置
  4. 优化性能
     — 添加决策框架 + 质量控制

输出一个 .md 文件，放到 agents/ 目录，立即可用。

四、MCP 集成详解

MCP（Model Context Protocol）让插件连接外部世界。

数据库、API、文件系统、OAuth 服务…

四种服务器类型

类型
传输方式
适用场景
stdio
标准输入输出
本地工具、自定义服务器
SSE
Server-Sent Events
托管服务、OAuth 认证
HTTP
REST API
远程 API 服务
WebSocket
双向实时通信
实时数据流

配置方式

方式一：独立 .mcp.json（推荐）

{  "database-tools": {    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],    "env": {      "DB_URL": "${DB_URL}"    }  }}

方式二：内联到 plugin.json

{  "name": "my-plugin",  "mcpServers": {    "plugin-api": {      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server"    }  }}

${CLAUDE_PLUGIN_ROOT} 便携路径

这是 Claude Code 的设计巧思。

问题：插件在不同机器上，路径不一样。

解决：用 ${CLAUDE_PLUGIN_ROOT} 替代硬编码路径。

// ❌ 硬编码"command": "/Users/sky/.claude/plugins/my-plugin/server"// ✅ 便携路径"command": "${CLAUDE_PLUGIN_ROOT}/server"

插件搬家、团队共享、CI/CD 部署，都能正常工作。

五、Skill 渐进式披露设计

Skill 不是一本书。

它是分层加载的知识包。

三级加载系统

级别
内容
加载时机
Level 1
SKILL.md 核心
基础匹配时
Level 2
references/ 文档
Claude 判断需要时
Level 3
scripts/ 脚本
执行具体任务时

为什么这样设计？

Token 效率。

一个完整的 Skill 可能有 10,000 words。

如果每次都全部加载，token 消耗爆炸。

渐进式披露：

  • 核心
    （~1,600 words）— 基础指令，必加载
  • 参考
    （~8,000 words）— 详细文档，按需加载
  • 脚本
    — 确定性执行，不占 token

Skill 标准结构

skill-name/├── SKILL.md           # 核心指令（~1,600 words）│   ├── YAML frontmatter（name + description）│   └── Markdown 指令├── scripts/           # 可执行脚本│   └── validate.sh├── references/        # 参考文档（按需加载）│   ├── patterns.md    # ~3,200 words│   └── advanced.md    # ~2,800 words└── assets/            # 输出资源（不加载到 context）    └── template.json

设计原则：

  • SKILL.md 保持精简
  • 详细内容放 references
  • 脚本放 scripts
  • 资源放 assets

渐进式披露 = Token 效率 + 灵活性。

六、Agent Skills 开放标准

一个有意思的发现：

三家 Harness 都遵循同一标准。

Harness
Skills 目录
标准
Claude Code .claude-plugin/
Agent Skills
OpenClaw ~/.openclaw/skills/
Agent Skills
Codex agents/
Agent Skills

这意味着什么？

一次开发，多平台可用。

你在 Claude Code 写的 Skill：

  • 目录结构一样
  • YAML 格式一样
  • 加载机制一样

可以直接拷到 OpenClaw 或 Codex 使用。

标准 = 社区生态。

三家的差异

维度
Claude Code
OpenClaw
Codex
官方插件
13 个
ClawHub 社区
无
Hook 系统
✓ 成熟（4 事件）
✓ 基础
✗
开发工具包
✓ plugin-dev
✓ skill-creator
✗
社区分享
✓ Marketplaces
✓ ClawHub
✗

Claude Code 独有：

  • plugin-dev — 8 阶段开发 SOP
  • hookify — 对话分析自动创建 Hook
  • ralph-wiggum — 自迭代循环
  • 13 个官方维护插件

OpenClaw 独有：

  • ClawHub — 社区 Skill 分享平台
  • ClawFlow — AI-native Workflow 格式
  • 跨平台 Skills — 可加载 Claude Code / Codex Skills

七、典型插件案例

案例1：code-review — 多 Agent 协作审查

结构：

  • 1 个 /code-review 命令
  • 5 个并行 Sonnet Agents
Agent
职责
CLAUDE.md 合规检查
检查是否符合项目约定
Bug 检测
发现潜在 bug
历史上下文
分析代码演进历史
PR 历史
参考 PR 评论模式
代码注释
检查注释质量

特点：

  • 置信度评分
     — 低置信度的警告会被过滤
  • 并行执行
     — 5 个 Agent 同时工作
  • 专业分工
     — 每个 Agent 只做一件事

单一职责 Agent 比一个大 Agent 更可靠。

案例2：hookify — 自动创建 Hook

你已经读过专门的文章。

这里只说一点：hookify 是插件生态的入口。

它让普通人也能创建 Hook 规则。

不需要写代码。

只需要描述你想阻止什么行为。

案例3：ralph-wiggum — 自迭代循环

你也读过专门的文章。

核心机制：Stop Hook 拦截退出。

未完成 → 继续迭代。

完成 → 检测 <promise>COMPLETE</promise>，允许退出。

一个 Bash loop + 文件系统 + 完成承诺 = Agent 自迭代。

案例4：security-guidance — 安全提醒

触发：PreToolUse Hook。

监控：9 种安全模式。

  • Command injection
  • XSS
  • eval() usage
  • Dangerous HTML
  • Pickle deserialization
  • os.system calls
  • …

工作方式：

每次你写代码，Hook 会扫描。

发现风险 → 显示警告。

你可以选择忽略或修改。

安全不是功能，是架构。

Hook 是最后一道防线。

八、如何使用这些插件？

安装方式

内置插件：

Claude Code 仓库自带，无需安装。

git clone https://github.com/anthropics/claude-code.gitcd claude-codeclaude  # 插件自动可用

社区插件：

通过 Marketplaces 安装。

/plugin install marketplace-name/plugin-name

项目级配置

在你的项目中启用插件：

# 创建 .claude 目录mkdir .claude# 配置 settings.jsoncat > .claude/settings.json << 'EOF'{  "plugins": [    "feature-dev",    "code-review",    "hookify"  ]}EOF

使用示例

# 功能开发/feature-dev "Add user authentication with JWT"# PR 审查/code-review# 创建 Hook/hookify Don't use console.log in TypeScript files# 自迭代循环/ralph-loop "Fix all failing tests. Output <promise>DONE</promise> when done."

九、设计启示

启示1：插件化是 Harness 的必然演进

从单体到插件化：

  • 变化的东西不应该在核心里
  • 插件 = 可组合的能力单元
  • 标准 = 跨平台兼容

Claude Code 不是工具，是平台。

启示2：Agent Skills 标准的胜利

三家都遵循同一标准。

这意味着：

  • 用户可以跨平台使用 Skills
  • 开发者一次开发多平台可用
  • 社区贡献更容易

标准比功能更重要。

启示3：渐进式披露是 Skill 设计精髓

三级加载：

  • 核心 → 按需 → 执行

Token 效率 + 灵活性。

不是把所有内容塞进一个文件。

而是分层，让 Claude 自己判断需要什么。

启示4：单一职责 Agent 更可靠

5 个并行 Agent 比 1 个大 Agent 更好。

因为：

  • 专业分工
  • 可组合
  • 易维护

Agent 不是越大越好，是越专注越好。

十、与前三篇的关系

这是 Claude Code 系列的第四篇。

系列回顾：

篇
标题
核心
一
Claude Code 架构解析：Anthropic 的官方 Agent Harness
整体架构 + 四大系统
二
hookify：Claude Code 的 Hook 自动化之道
Hook 系统 + 自动创建
三
Agent Loop：Claude Code 的自迭代之道
Ralph Wiggum + Stop Hook
四

Claude Code 插件生态全景：13 个官方扩展一文读懂（本文）
13 官方插件 + 四大类型

读完四篇，你对 Claude Code 的理解会形成闭环：

  • 整体架构是什么？
  • Hook 怎么工作？
  • Agent 如何自迭代？
  • 插件怎么扩展？

参考资源

  • GitHub: anthropics/claude-code
  • Claude Code Plugin 文档
  • Agent SDK 文档
  • plugin-dev 源码

标签

#ClaudeCode #Plugin #MCP #Skills #Agent #Anthropic #插件生态

— 完 —