配套资源
源码仓库 · github.com/diguike/book-claude-plugins
在线阅读 · inferloop.dev/claude-plugins
本书简介
这本书拆解 anthropics/claude-plugins-official 仓库里的每一个插件——35 个 Anthropic 官方插件和 15 个驻仓库的第三方外部插件,本书重点讲透其中的 52 个。
目的很简单:你装了一个插件,想知道它到底干了什么、怎么干的、有什么坑,翻到对应章节就行。如果你正在写自己的插件,这些现成的实现就是最好的参考。
这本书的源码(含本书所有 Markdown 章节、配套示例)开源在 https://github.com/diguike/book-claude-plugins,欢迎提 issue / PR 纠错或补充。
仓库里有什么
anthropics/claude-plugins-official 是 Claude Code 插件的官方 marketplace 仓库,组织成三层:
/plugins—— Anthropic 自研的 35 个核心插件/external_plugins—— 跟 Anthropic 合作、源码托管在本仓库的 15 个第三方插件.claude-plugin/marketplace.json—— 通过 SHA pin 或 URL 接入的 150+ 个远程第三方插件(来自 AWS、Azure、Cloudflare、Vercel、MongoDB、Datadog、Sentry、Stripe、Shopify、Notion、Slack 等厂商)
本书把前两层(共 50 个)逐个拆开讲清楚,加上 3 个最近新增的官方插件(code-modernization、cwc-makers、mcp-tunnels),合计 52 章。150+ 个远程第三方插件不展开(生命周期太短,半年后可能就大改),但在附录·插件速查索引里做了一份按领域分类的目录,需要时直接查。
按功能给前 50 个插件分组大致是这样:
开发流程类:feature-dev(功能开发工作流)、commit-commands(Git 提交流程)、code-review / pr-review-toolkit(代码审查)、code-simplifier(代码精简)、code-modernization(遗留系统现代化)。这类插件把日常开发里反复做的事串成了自动化流程。
语言服务器类:typescript-lsp、pyright-lsp、rust-analyzer-lsp、gopls-lsp、clangd-lsp、ruby-lsp、swift-lsp、kotlin-lsp、jdtls-lsp、csharp-lsp、lua-lsp、php-lsp。一口气 12 个 LSP(Language Server Protocol,语言服务器协议)插件,给 Claude Code 接上了各语言的类型检查和智能补全能力。
插件开发类:plugin-dev(插件开发工具箱)、skill-creator(技能创建器)、example-plugin(示例插件)、mcp-server-dev(MCP 服务器开发)、hookify(Hook 生成器)、mcp-tunnels(私网 MCP 暴露)。想写自己的插件,这几个是入口。
项目管理与协作类:claude-code-setup(项目初始化配置)、claude-md-management(CLAUDE.md 维护)、session-report(会话报告)、ralph-loop(迭代循环开发)。
输出风格类:explanatory-output-style(解释型输出)、learning-output-style(学习型输出)。这两个比较特别,不提供工具能力,而是改变 Claude 的回答风格。
外部服务集成类:GitHub、GitLab、Linear、Asana(项目管理),Supabase、Firebase(后端即服务/BaaS),Playwright(浏览器自动化),Terraform(IaC,基础设施即代码),以及 Discord、Telegram、iMessage、fakechat(消息通道)等。这些插件通过 MCP(Model Context Protocol,模型上下文协议)把外部服务的 API 接进 Claude Code。
专业领域类:math-olympiad(竞赛数学)、security-guidance(安全指导)、frontend-design(前端设计)、agent-sdk-dev(Agent SDK 开发)、playground(交互式 HTML 沙盒)、cwc-makers(M5Stack Cardputer 硬件套件 onboarding)。
本书的组织
全书按功能分 6 章加附录,每章覆盖一个领域的所有插件:
| 章 | 主题 | 包含的插件 |
|---|---|---|
| 第 1 章 | 开发工具与工作流 | example-plugin, claude-code-setup, claude-md-management, commit-commands, feature-dev, plugin-dev, skill-creator, mcp-server-dev, agent-sdk-dev, hookify, playground, ralph-loop, session-report, code-modernization, cwc-makers, mcp-tunnels |
| 第 2 章 | 代码质量与审查 | code-review, pr-review-toolkit, code-simplifier, security-guidance |
| 第 3 章 | 输出风格定制 | explanatory-output-style, learning-output-style |
| 第 4 章 | 专业领域插件 | frontend-design, math-olympiad |
| 第 5 章 | LSP 语言服务器集成 | 12 个 *-lsp 插件(含通用原理概述) |
| 第 6 章 | 外部服务集成 | GitHub, GitLab, Linear, Asana, Supabase, Firebase, Terraform, Playwright, Discord, Telegram, iMessage, Greptile, Laravel Boost, Context7, Serena, fakechat |
| 附录 | 插件开发进阶 + 常见问题 + 插件速查索引(含 150+ 远程第三方插件分类目录) |
每个插件的讲解遵循同一结构:它解决什么问题、目录结构与组件构成、核心实现拆解、使用示例、已知限制和注意事项。
这本书适合谁
你应该已经用过 Claude Code,知道怎么跟它对话、怎么让它改代码。你可能用 / 斜杠命令执行过一些操作,也许装过一两个插件。但对插件体系的整体架构——skills、agents、hooks、commands、MCP servers 这五种扩展点分别是什么、怎么配合——还没有系统的认识。
如果你完全没用过 Claude Code,建议先跑通官方文档的入门流程再来。这本书不会从零教你 Claude Code 的基础操作。
如果你已经是插件开发老手,这本书对你的价值在于:快速了解官方仓库里每个插件的实现细节,看看别人怎么处理你遇到过的同类问题。
术语约定
全书统一使用以下术语:
| 术语 | 含义 |
|---|---|
| Claude Code | Anthropic 官方 CLI(命令行)形态的编程助手,详见 https://claude.com/claude-code |
| slash command | 斜杠命令,用户在 Claude Code 中输入 /xxx 触发的命令 |
| skill | 技能,Claude 根据上下文自动激活或用户手动调用的能力模块 |
| agent / subagent | 代理/子代理,独立运行的子进程,有自己的上下文和工具集 |
| hook | 钩子,挂载到特定事件上的自动化脚本或 prompt |
| frontmatter | Markdown 文件顶部的 YAML 元数据块(--- 包裹的部分) |
| MCP | Model Context Protocol,模型上下文协议,Claude 调用外部工具的协议,详见 https://modelcontextprotocol.io |
| LSP | Language Server Protocol,语言服务器协议,IDE 与语言后端之间的通信标准,详见 https://microsoft.github.io/language-server-protocol |
| prompt | 提示词/指令,给 Claude 的输入文本 |
| marketplace | 插件市场,对应仓库 anthropics/claude-plugins-official |
本章来自《Claude 插件官方指南》开源版 · 作者「递归客」
在线阅读完整书系:inferloop.dev
源码仓库:github.com/diguike/book-claude-plugins
本书资源
- 源码仓库 · github.com/diguike/book-claude-plugins
- 在线阅读 · inferloop.dev/claude-plugins
- 所有书目 · inferloop.dev
继续阅读 · 同作者其他书
- 《Transformer 工程实战》从注意力机制到生产部署
- 《自己动手写 AI Agent》从 Claude Code 开源架构到你的第一个编程助手
- 《AI 时代的 CLI 工具开发实战》用 TypeScript 构建现代 CLI 工具
- 《LLM Infra 工程实战》从入门到实践
- 《Hermes Agent 实战》构建会成长的个人 AI Agent
- 《OpenClaw 源码解析》现代 Agent 系统的架构设计与工程实践
- 《Agent Memory 工程实战》从 claude-mem 源码到企业级记忆平台
- 《AI Token 中转站实战》从 0 搭建企业级 LLM 网关
- 《LangChain.js Agent 开发权威指南》从 1.x 抽象到生产级 Agent
- 《百万级 AI Agent 平台架构》智能客服 SaaS 实战
- 《AI Agent 评测工程实战》从 0 用 TypeScript 构建你的评测平台
- 《Agent Harness 评测工程》用评测建设并守护一个 agent harness
- 《源码精读》每章一个开源仓库 · 从架构到品味
- 《Claude Code Skill 指南》