引言“Plugins extend Claude Code with commands, agents, skills, hooks, and MCP servers.”这是一天一个开源项目系列的第106篇文章。今天带你了解的项目是claude-plugins-official。这是 Anthropic 官方在 GitHub 上维护的 Claude Code 插件目录。如果你最近开始深度使用 Claude Code一定见过/plugin install命令——这个仓库就是这条命令背后的官方插件源。20.2k Stars2.5k Forks669 个 Open Issues。数字背后是一个正在快速成型的生态Anthropic 内部工程师贡献了 30 款插件涵盖 12 种语言的 LSP 支持、PR 多维评审工具包、Git 工作流自动化、代码质量分析15 家外部合作伙伴GitHub、Firebase、Linear、Terraform 等也已接入。但这篇文章想讲的不只是有哪些插件——更值得关注的是这套插件规范本身的设计一个 plugin.json 文件、三种扩展方式Skills/Commands/MCP、两种触发机制用户调用 vs 模型自动触发。理解这套架构你就理解了 Claude Code 可扩展性的边界和可能性。你将学到什么claude-plugins-official的完整插件目录结构内部插件 vs 外部插件Claude Code 插件的标准规范从plugin.json到 Skills/Commands/MCP 三种扩展方式五款重点插件的深度解析pr-review-toolkit、agent-sdk-dev、code-review、hookify、commit-commands如何从零创建一个符合规范的 Claude Code 插件外部合作伙伴插件生态的现状与接入方式前置知识使用过 Claude Code了解 slash command 的基本操作对 MCPModel Context Protocol有基本了解有兴趣构建自己的 Claude Code 扩展项目背景项目简介claude-plugins-official 是 Anthropic 维护的官方插件注册表服务于 Claude Code 的插件生态。它同时承担两个角色插件注册表用户通过/plugin install nameclaude-plugins-official安装插件开发规范参考plugins/example-plugin是官方的完整示例包含所有扩展方式的参考实现仓库分为两大目录/pluginsAnthropic 工程师内部开发涵盖 LSP、开发工作流、代码质量、输出风格等多个类别/external_plugins合作伙伴和社区提交须通过质量与安全审核作者/团队介绍这是一个多人协作的 Anthropic 内部项目各插件由不同工程师主导pr-review-toolkitDaisy (daisyanthropic.com)agent-sdk-devAshwin Bhat (ashwinanthropic.com)code-reviewBoris Cherny (borisanthropic.com)frontend-designPrithvi Rajasekaran Alexander Brickencommit-commandsAnthropic team项目数据⭐ GitHub Stars:20,200 Forks:2,500️ Watchers:147 Open Issues:669 主要语言: Python (31.6%), TypeScript (28.9%), HTML (19.5%), Shell (13.0%), JavaScript (7.0%)️ Topics:skills,mcp,claude-code 仓库: anthropics/claude-plugins-official 文档: code.claude.com/docs/en/plugins主要功能核心作用claude-plugins-official 提供了一套标准化的方式来扩展 Claude Code 的能力Claude Code 原生能力 ↓ /plugin install nameclaude-plugins-official ↓ 扩展后的 Claude Code ├── 新增 Slash Commands用户主动调用 ├── 新增 Skills模型自动触发 ├── 新增 Agents专用任务代理 └── 新增 MCP 工具外部服务集成快速开始安装插件命令行方式# 安装 PR 评审工具包/plugininstallpr-review-toolkitclaude-plugins-official# 安装 Git 提交命令套件/plugininstallcommit-commandsclaude-plugins-official# 安装 Agent SDK 开发工具/plugininstallagent-sdk-devclaude-plugins-official# 安装代码评审插件/plugininstallcode-reviewclaude-plugins-official# 安装 Hook 管理工具/plugininstallhookifyclaude-plugins-official安装插件UI 方式在 Claude Code 中输入: /plugin → 点击 Discover → 浏览并安装所需插件安装外部合作伙伴插件# GitHub 集成/plugininstallgithubclaude-plugins-official# Linear 项目管理集成/plugininstalllinearclaude-plugins-official# Firebase 集成/plugininstallfirebaseclaude-plugins-official# Terraform 基础设施集成/plugininstallterraformclaude-plugins-official插件目录总览内部插件/plugins类别插件LSP 语言支持clangd-lsp, csharp-lsp, gopls-lsp, jdtls-lsp, kotlin-lsp, lua-lsp, php-lsp, pyright-lsp, ruby-lsp, rust-analyzer-lsp, swift-lsp, typescript-lsp开发工作流agent-sdk-dev, claude-code-setup, commit-commands, feature-dev, mcp-server-dev, plugin-dev, pr-review-toolkit, ralph-loop代码质量code-modernization, code-review, code-simplifier, security-guidance输出风格explanatory-output-style, learning-output-style实用工具claude-md-management, cwc-makers, frontend-design, hookify, math-olympiad, session-report, skill-creator参考实现example-plugin外部合作伙伴插件/external_pluginsasana, context7, discord, fakechat, firebase, github, gitlab, greptile, imessage, laravel-boost, linear, playwright, serena, telegram, terraform五款重点插件深度解析插件 1pr-review-toolkit——六代理并行 PR 评审这是整个 plugins 目录里设计最为精巧的插件之一6 个专用代理并行运行从不同维度审查同一个 Pull Request。PR 提交 ↓ comment-analyzer ← 注释准确性、文档完整性、注释腐化 pr-test-analyzer ← 测试覆盖质量、边界用例、行为覆盖 vs 行覆盖 silent-failure-hunter ← 静默失败、空 catch 块、缺失错误日志 type-design-analyzer ← 类型封装、不变量4 维度 1–10 评分 code-reviewer ← CLAUDE.md 合规性、风格、Bug0–100 评分 code-simplifier ← 可读性、不必要复杂性、冗余抽象触发方式自然语言驱动测试覆盖是否足够 → 自动触发 pr-test-analyzer 检查 API 客户端的错误处理 → 自动触发 silent-failure-hunter 这段文档注释准确吗 → 自动触发 comment-analyzer 帮我简化这块代码 → 自动触发 code-simplifier完整 PR 评审一次触发全部代理我准备提 PR请 1. 检查测试覆盖 2. 检查静默失败 3. 验证注释准确性 4. 评审新增的类型设计 5. 整体代码评审推荐工作流写代码 → code-reviewer 修复问题 → silent-failure-hunter如果涉及错误处理 补充测试 → pr-test-analyzer 加文档 → comment-analyzer polish → code-simplifier → 创建 PR插件 2agent-sdk-dev——Agent SDK 项目脚手架这个插件把从零搭建一个 Claude Agent SDK 项目压缩到一条命令。/new-sdk-app命令交互式项目创建/new-sdk-app my-agent-project# 接下来的交互提示# 1. 语言选择: TypeScript 还是 Python?# 2. 代理类型: coding / business / custom# 3. 起点模板: minimal / basic / specific example# 4. 包管理器: npm/yarn/pnpm 或 pip/poetry执行后自动完成检查并安装最新 SDK 版本创建项目文件结构、.env.example、.gitignore运行类型检查TS或语法验证Python自动运行对应的 Verifier 代理验证项目是否符合 SDK 最佳实践两个 Verifier 代理# Python 项目验证Verify my Python Agent SDK application→ 检查: SDK 安装、requirements.txt/pyproject.toml、 SDK 使用模式、代理初始化/配置、.env 安全性、错误处理# TypeScript 项目验证Verify my TypeScript Agent SDK application→ 检查: SDK 安装、tsconfig.json、类型安全/导入、 代理初始化/配置、.env 安全性、错误处理Verifier 输出格式整体状态: PASS / PASS WITH WARNINGS / FAIL - 阻断性问题Critical Issues - 非最优模式警告Warnings - 通过的检查项 - 改进建议附 SDK 文档链接插件 3code-review——置信度过滤的 4 代理代码评审这个插件解决了 AI 代码评审中最常见的问题误报太多。工作流程1. 前置检查 — 跳过已关闭、Draft、微小 PR 2. 收集仓库 CLAUDE.md 指南文件 3. 总结 PR 变更 4. 并行启动 4 个代理: - Agent #1 #2 → CLAUDE.md 合规性检查 - Agent #3 → Bug 检测仅检查变更部分 - Agent #4 → Git blame/历史上下文分析 5. 对每个问题打 0–100 置信度分 6. 过滤掉低于阈值默认 80的问题 7. 发布只包含高置信度问题的评审评论置信度评分说明分数含义0不确定可能是误报25略有把握可能是真实问题50中等把握真实但次要75高度确信真实且重要100完全确定必须修复被过滤掉的问题类型PR 引入之前已存在的问题看起来有问题但实际没问题的代码Lint 工具会处理的问题有 lint-ignore 注释的条目配置置信度阈值在commands/code-review.md中修改# 将默认的 80 改为你的偏好值 Filter out any issues with a score less than 80.插件 4hookify——自然语言创建 Claude Code HooksClaude Code 的 Hooks 功能在工具执行前后触发自定义逻辑配置起来需要手动编辑复杂的 JSON 文件。hookify 解决了这个问题。核心命令# 用自然语言描述规则/hookify 当使用rm-rf命令时警告我# 分析对话历史自动建议需要阻断的行为/hookify# 列出所有规则/hookify:list# 交互式启用/禁用规则/hookify:configure规则立即生效无需重启 Claude Code。规则文件格式存储于.claude/hookify.name.local.md--- name: block-dangerous-rm enabled: true event: bash pattern: rm\s-rf action: block --- ⚠️ **检测到危险的 rm 命令** 请确认路径并确保有备份。进阶规则多条件--- name: warn-sensitive-files enabled: true event: file action: warn conditions: - field: file_path operator: regex_match pattern: \.env$|credentials|secrets - field: new_text operator: contains pattern: KEY --- **检测到敏感文件编辑**事件类型和触发时机event触发时机bash执行 Bash 命令前file文件读写操作prompt用户输入提示词stopClaude 准备停止回复all所有上述事件实用规则示例# 阻断破坏性命令event:bashpattern:rm\s-rf|dd\sif|mkfs|formataction:block# 警告调试代码event:filepattern:console\.log\(|debugger;action:warn# 停止前要求运行测试event:stopaction:blockconditions:-field:transcriptoperator:not_containspattern:npm test|pytest|cargo test# 防止 TypeScript 文件中硬编码 API Keyevent:fileconditions:-field:file_pathoperator:regex_matchpattern:\.tsx?$-field:new_textoperator:regex_matchpattern:(API_KEY|SECRET|TOKEN)\s*\s*[]插件 5commit-commands——三命令 Git 工作流# 自动生成 commit message 并提交/commit# 完整一键流程commit → push → 创建 PR/commit-push-pr# 清理远端已删除的本地分支/clean_gone/commit的执行逻辑分析暂存/未暂存的变更查看近期提交历史匹配仓库风格暂存文件并创建包含 Claude Code attribution 的 commit message自动跳过.env、credentials.json等敏感文件/commit-push-pr的执行逻辑如果在main分支自动创建新分支提交变更Push 到origin通过 GitHub CLI 创建 PR包含 Summary 测试清单插件规范深度解析标准插件目录结构plugin-name/ ├── .claude-plugin/ │ └── plugin.json # 插件元数据必须 ├── .mcp.json # MCP 服务器配置可选 ├── skills/ # Skill 定义推荐 │ ├── my-skill/ │ │ └── SKILL.md # 模型自动触发的 Skill │ └── my-command/ │ └── SKILL.md # 用户调用的 Slash Command也用 SKILL.md ├── commands/ # Slash 命令旧格式 │ └── my-command.md ├── agents/ # 代理定义 └── README.mdplugin.json 元数据格式{name:my-plugin,description:A description of what this plugin does,author:{name:Your Name,email:youexample.com}}设计上刻意极简只有三个字段无版本号、无依赖声明。插件的能力由目录内容决定而不是元数据。三种扩展方式的对比方式 1Skills推荐新插件应使用# 模型自动触发基于任务上下文---name:security-reviewdescription:当检测到安全相关代码时自动触发安全审查version:1.0.0---# 用户手动触发成为 /skill-name 命令---name:my-commanddescription:短描述显示在 /help 中argument-hint:arg1[optional-arg]allowed-tools:[Read,Glob,Grep]---方式 2Commands旧格式功能等价# commands/my-command.md --- # YAML frontmatter --- # 命令内容同 SKILL.md方式 3MCP Servers外部服务集成// .mcp.json{my-service:{type:http,url:https://api.myservice.com/mcp}}两种 Skill 触发机制的关键区别触发类型激活方式适用场景用户触发用户输入/skill-name明确的单次操作提交、评审模型自动触发Claude 根据任务上下文判断持续的上下文增强输出风格、安全检查这个区别非常重要frontend-design插件就是典型的模型自动触发——用户只需要说创建一个仪表盘Claude 会自动应用该插件的设计原则无需用户明确调用。外部插件提交流程如果你想将自己的插件纳入官方目录1. 确保插件符合质量和安全标准 ↓ 2. 访问 https://clau.de/plugin-directory-submission ↓ 3. 填写插件提交表单 ↓ 4. Anthropic 审核质量审查 安全审查 ↓ 5. 合并到 /external_plugins 目录审核标准推断自文档插件必须有完整的 README 和 plugin.jsonMCP 服务器如有使用需标注清楚不得包含恶意代码或未授权的数据采集功能需有实际价值非重复轮子项目地址与资源官方资源GitHub: https://github.com/anthropics/claude-plugins-official插件开发文档: code.claude.com/docs/en/plugins外部插件提交: clau.de/plugin-directory-submission参考实现:/plugins/example-plugin插件开发最佳起点适用人群Claude Code 深度用户希望通过官方插件扩展工作流能力插件开发者学习如何构建符合规范的 Claude Code 插件工具链工程师将自有服务接入 Claude Code 生态通过 MCP 服务器团队工程效能负责人为团队定制 Claude Code 插件统一开发规范总结与展望核心要点回顾插件生态层面30 内部插件覆盖 LSP12种语言、PR 评审、Git 工作流、代码质量、输出风格等核心开发场景15 个外部插件GitHub、Firebase、Linear、Terraform 等主流开发工具已接入统一安装方式/plugin install nameclaude-plugins-official一条命令搞定插件规范层面极简元数据plugin.json只需 name、description、author 三个字段三种扩展方式Skills推荐/ Commands旧格式/ MCP Servers外部服务两种触发机制用户主动调用 vs 模型根据上下文自动触发安全提示始终在场官方文档明确指出不对第三方插件的 MCP 服务器负责要求用户验证信任五款重点插件的核心价值pr-review-toolkit6 代理并行 → 多维视角消除单一评审盲区agent-sdk-dev一条命令脚手架 自动 Verifier → 降低 Agent SDK 入门门槛code-review置信度过滤默认阈值 80→ 减少误报专注真实问题hookify自然语言创建 Hooks → 无需手写复杂 JSON 配置commit-commands/commit-push-pr→ 从代码到 PR 全流程自动化一句话评价claude-plugins-official 不只是一个插件目录——它是 Anthropic 对AI 工具应如何被扩展这个问题的公开答案最小化元数据、最大化组合灵活性让 Skills 在正确的上下文自动出现而不是强迫用户记住命令。欢迎来我的个人主页找到更多有用的知识和有趣的产品
