把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)

把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)

上个月我帮一个四人小团队收拾 Claude Code 的定制。事情是这样的:有人写了三条提交命令,有人攒了五个 skills,还有人配了一套钩子,拦 rm -rf、拦没跑测试就提交。东西都不错,问题是它们散在三个人的 ~/.claude 里,谁也没有一份完整的清单。新人入职那天,我眼睁睁看着他花了半天复制文件、改路径、对版本号,最后还是漏了一个钩子------第二天他就把没跑测试的代码推上去了。

那一刻我明白,缺的不是某一个 skill,而是一个装东西的箱子。

这篇就拆这个箱子:Anthropic 的官方插件仓库 anthropics/claude-plugins-official。它的核心机制简单到一句话:一个插件就是一个文件夹,文件夹里放清单和组件,一次安装整包进会话。简单归简单,里面有几处设计值得抠------插件名为什么改不了、市场目录正在为什么收窄、mods 和 hooks 到底差在哪。我今天(2026-11-16)把仓库浅克隆下来,钉住 commit b5b01ac4,一个个文件读过去,还写了个校验脚本把 57 份清单全跑了一遍。下面看到的数字和代码,都是这次实测的原样。行李箱这个类比会贯穿全文:清单是行李牌,文件夹是格子,市场是目录牌------读到后面你会发现,插件机制里几乎每个设计都能对上这三件东西。

三段日子,别混成一段

插件这套机制不是一天长成的,三个日期各管一段,混写就错。

2025-10-09,插件机制公开 beta。 Anthropic 当时的口径是 "the standard way to bundle and share Claude Code customizations"------把散落的 slash commands、subagents、MCP 服务器和 hooks 打包成标准件。这一天是机制的生日。

2025-11-20,这个仓库创建。 也就是今天拆的主角。它不是插件机制本身,而是 Anthropic 自家插件的目录和仓库。GitHub API 今天(2026-11-16)返回的数字:Star 47,413、Fork 4,925,创建于 2025-11-20T18:36:20Z,Apache-2.0 协议。最后一次推送就在今天,2026-11-16T07:42:22Z------这个仓库现在每天都在动,不是归档的展品。

2026-09-25,同一套插件格式开放给第三方提交。 Anthropic 把插件目录(claude.ai/directory)向付费用户开放,提交入口在 claude.ai/directory/manage。注意:这不是又发明了一种新格式,目录里的插件和 Claude Code 插件是同一种东西,只是分发面从命令行扩到了网页。

2026-10-01,mods 追加。 TypeScript/JavaScript 写的 hooks 模块,Claude Code CLI v2.1.287 起默认开启。mods 是插件里新长出来的能力,后面单拆。

还有一件事得先交代,免得你按旧印象读下去:这个仓库正在收窄。README(commit b5b01ac4,第 10 行)原文写着:

.claude-plugin/marketplace.json is being phased out for third-party plugins. It will be reduced over time to Anthropic's own plugins.

第三方提交已经搬去 claude.ai/directory/manage,这个仓库不再收 PR。/external_plugins 是搬走之前加进来的第三方插件,加上 Anthropic 自家的频道插件(Discord、iMessage、Telegram 这些)。所以这篇文章的口径是:claude-plugins-official 正在从"全行业的插件注册表"过渡为"Anthropic 自家插件的目录"。如果你手里还存着 2025 年底的旧教程,写着"给这个仓库提 PR 就能上架",那条路已经没了------这是本文最重要的一处纠偏,后面还会展开讲它对你的实际影响。

按惯例我扫了 2026-11-16 当天的 GitHub Trending Python 日榜(2026-11-16 08:01 UTC 抓取,前 17 名)。这个仓库不在榜上。昨天(11-15)它曾经在 18:22 出现在第 6 名,但当晚 21:23 再查就已经不见了------榜单一天内波动就是这么大。所以这篇文章不写 Trending 名次,只写仓库本身的实测数据:Star、Fork、推送时间和文件结构,这些是钉得住的。

顺带一提,11 月 10 日那篇拆过 anthropics/skills 的渐进式披露(SKILL.md 三级加载),那篇讲的是"内容怎么被按需加载",这篇讲的是"整套定制怎么被打包、分发、安装",两篇是上下游关系。SKILL.md 的加载机制这里只当背景提一句,不重拆。

打包的类比:行李箱,不是文件夹

整篇文章我只用一个类比:插件就是一只行李箱。

你出差前把衣服、洗漱包、充电器一件件摆在床上,这就是散装的 skills、commands、hooks。行李箱做的事情只有三件:给你一个固定的格子(清单定好每件东西放哪)、一把提手(一次拎走,不用一件件数)、一张行李牌(别人拿到就知道这箱子是谁的、装了什么)。插件机制的三件套正好对应:plugin.json 是行李牌,文件夹结构是格子,marketplace 是行李寄存处的目录牌。

类比的好处是能帮你快速判断取舍:行李箱适合"整套东西要一起走"的场景;你只带一把伞出门,没必要拖个箱子。什么时候该打包、什么时候散装就行,后面的决策表会回到这个判断上。

拆解一:plugin.json,整只箱子的行李牌

先看一个最简单的真实例子。仓库里 plugins/commit-commands/.claude-plugin/plugin.json,全文如下(commit b5b01ac4 原样):

json 复制代码
{
  "name": "commit-commands",
  "description": "Streamline your git workflow with simple commands for committing, pushing, and creating pull requests",
  "version": "1.0.1",
  "author": {
    "name": "Anthropic",
    "email": "support@anthropic.com"
  }
}

五六行,没了。没有依赖声明,没有入口函数,没有构建配置。清单只干一件事:给这只箱子定名。官方文档的说法也一样:清单给插件命名,还可以加版本、描述和其他元数据。字段逐个过一遍:

字段 意思 不写会怎样
name 插件的 slug,安装和引用都靠它 没有它,文件夹就不算插件
description 一句话说清用途,装插件时给人看 能省,但别人装的时候只能猜
version 语义化版本号 能省,但团队分发时没法对版本
author 作者名和邮箱 能省,出问题找不到人

name 是最值得停下来的一行。它不是个显示名,是不可变 slug 。README 里"Plugin names are immutable"一节写得很直白:一旦发布,name 就不能改------用户已经按这个 slug 装上了,改名会让他们的安装直接报 plugin-not-found。想改界面上显示的名字?改 displayName,别动 name。这条规则听起来死板,换个角度想:行李牌上的名字一旦写上去,全世界的行李员都按它找箱子,你半路改名,箱子就找不回来了。

那万一非改不可呢?有后门,但后门长在市场目录那一层,不在插件自己手里------后面拆 marketplace 时讲 renames。

再看一个稍大的清单,plugins/hookify/.claude-plugin/plugin.json(0.1.1 版):

json 复制代码
{
  "name": "hookify",
  "description": "Easily create hooks to prevent unwanted behaviors by analyzing conversation patterns",
  "version": "0.1.1",
  "author": {
    "name": "Anthropic",
    "email": "support@anthropic.com"
  }
}

结构一模一样。清单不关心插件里装了什么------那是文件夹里其他文件的活。清单只回答"这箱子叫什么、谁的、第几版"。这种克制是故意的:清单越薄,别人读它、校验它、搬运它的成本越低。

我今天跑的校验脚本(verify-plugins.py,Python 3.12.3)把仓库里全部 57 份 plugin.json(plugins/ 43 个目录加 external_plugins/ 14 个目录)逐个解析了一遍:JSON 合法、有 name、name 里没有空格和斜杠的,57 个全过。结果在后面的终端图里。

拆解二:文件夹里都装了什么?七个格子,各归其位

README 给出的标准结构是这样的:

复制代码
plugin-name/
├── .claude-plugin/
│   └── plugin.json      # 清单(必需)
├── .mcp.json            # MCP 服务器配置(可选)
├── commands/            # 斜杠命令(可选)
├── agents/              # 子代理定义(可选)
├── skills/              # skill 定义(可选)
└── README.md            # 文档

hooks 没出现在这个简表里,但它是真实存在的第六个格子(hooks/hooks.json)。七个格子,我拿仓库里的三个真插件对照着讲,你就知道每个格子装完之后,在会话里会变成什么。

图 1:一个插件包的文件夹结构与加载关系。左边的 marketplace.json 只负责"列出插件与来源",中间七个格子是一只箱子的全部家当,右边是会话启动时整包加载。注意 mods(红色)那一行:它是唯一一个在 Claude Code 进程内跑代码的格子。

commit-commands:只有命令的轻箱子

plugins/commit-commands/ 里只有三条命令,没有 skills、没有 agents、没有 hooks:

复制代码
plugins/commit-commands/
├── .claude-plugin/plugin.json
├── commands/
│   ├── commit.md
│   ├── commit-push-pr.md
│   └── clean_gone.md
├── README.md
└── LICENSE

看 commands/commit.md 的开头(原文):

markdown 复制代码
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

一份命令文件就是一段 Markdown 加 frontmatter。allowed-tools 是白名单:这条命令只准跑 git add/status/commit,别的工具碰都不让碰。! 开头的行是执行时现场取数------打开命令那一刻,git status 和 git diff 的结果会被填进来当上下文。装上这个插件,会话里就多了 /commit、/commit-push-pr、/clean_gone 三条命令。别的什么都没有。

这种"只有命令"的插件是最常见的轻量形态:它不教 Claude 新知识(那是 skill 的活),只把"先看状态、再看 diff、只做一次提交"这个固定流程钉死成一条命令。团队里最值得打包的往往就是这种东西------流程比知识更容易散。

hookify:钩子最多的重箱子

plugins/hookify/ 是反面:命令只有四条,钩子配了四个事件,底下还有一整套 Python 规则引擎。

复制代码
plugins/hookify/
├── .claude-plugin/plugin.json
├── agents/conversation-analyzer.md
├── commands/            # hookify.md、configure.md、help.md、list.md
├── core/                # rule_engine.py、config_loader.py
├── hooks/
│   ├── hooks.json
│   ├── pretooluse.py
│   ├── posttooluse.py
│   ├── stop.py
│   └── userpromptsubmit.py
├── matchers/
├── skills/writing-rules/SKILL.md
└── examples/            # *.local.md 规则示例

它的 hooks/hooks.json(原文节选结构)长这样:

json 复制代码
{
  "description": "Hookify plugin - User-configurable hooks from .local.md files",
  "hooks": {
    "PreToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.py\"",
            "timeout": 10
          }
        ]
      }
    ],
    "PostToolUse": [ "..." ],
    "Stop": [ "..." ],
    "UserPromptSubmit": [ "..." ]
  }
}

四个事件全配了同一个模式:事件一到,就调一个 Python 脚本,10 秒超时。${CLAUDE_PLUGIN_ROOT} 是关键------它是插件安装目录的环境变量,钩子脚本用它定位自己,不用写死绝对路径。这就是"箱子"的价值:你把 hookify 装到哪台机器上,脚本都能找到自己的家,不用改路径。

hookify 的用法也值得说一句:它让用户用 .local.md 文件写规则(examples/ 里有 dangerous-rm.local.md、require-tests-stop.local.md 这种现成的例子),规则引擎读这些文件,在工具调用前拦一道。也就是说,这个插件装进会话的不只是一条命令,而是一套"先审后做"的工作方式------命令、钩子、skill、子代理四个格子全用上了。

frontend-design:只有一个 skill 的极简箱子

plugins/frontend-design/ 更极端:

复制代码
plugins/frontend-design/
├── .claude-plugin/plugin.json   # version 1.1.1
├── skills/frontend-design/SKILL.md
├── README.md
└── LICENSE

整个插件就一个 skill。装上之后,会话里多了一个叫 frontend-design:frontend-design 的 skill(注册名是 <插件名>:<skill 名>),Claude 在写前端时按需加载它的 SKILL.md。你看,箱子可以很轻,轻到只装一件东西------只要这件东西值得被"一次安装、到处使用",打包就有意义。

这三个插件拼在一起,七个格子的分工就清楚了:

文件夹/文件 装进会话后变成什么 什么时候加载
.claude-plugin/plugin.json 插件的名字和版本 安装时读一次
commands/*.md /命令名 斜杠命令 会话启动时注册
skills/*/SKILL.md <插件>:<skill>,可当命令跑 按需加载全文,平时只占名字+描述
agents/*.md 可委派的子代理 按需委派
hooks/hooks.json 事件触发时跑的 shell 命令 事件到达时执行
hooks/register.js mod:进程内改写事件、画 UI 加载时执行一次
.mcp.json 随插件带来的 MCP 服务器 会话期间常驻运行

官方文档还补了一句容易忽略的话:启用的插件是每个会话的一部分,不只是你用它的那些会话。每个 skill、agent、命令的名字和描述,每一轮对话都在 Claude 的上下文里占着位置,哪怕这轮根本没用到它。skill 全文是按需加载的,但名字和描述不是免费的。这个账后面算到"坑"那一节。

七个格子还剩两个没细说:agents/ 和 .mcp.json,补上。

agents/ 里放的是子代理定义------一段 Markdown,写清这个代理负责什么、用什么工具、做到什么程度算完。hookify 里就有一个 agents/conversation-analyzer.md,专门用来分析对话模式、判断该生成什么样的钩子规则。子代理和 skill 的区别很实际:skill 是"教 Claude 怎么做一件事",子代理是"派另一个 Claude 去做一件事"。前者是知识,后者是分工。插件把子代理一起打包的意思是:你分出去的那份工作,连同"谁来干、干到什么标准"一起发走,接收方不用重新教一遍。

.mcp.json 是随插件带来的 MCP 服务器。仓库里的 plugins/example-plugin/.mcp.json 是最简形态(原文):

json 复制代码
{
  "example-server": {
    "type": "http",
    "url": "https://mcp.example.com/api"
  }
}

装上 example-plugin,会话里就多了一个叫 example-server 的 MCP 服务器------注意 URL 是 mcp.example.com,这是占位示例,不是真实服务。真实插件里,.mcp.json 指向的是它自己要连的服务:external_plugins/serena/、external_plugins/telegram/、external_plugins/terraform/ 都有自己的 .mcp.json。这一格的价值在于:MCP 服务器的配置(连哪个地址、用什么命令启动)本来也要人肉配,插件把它和命令、skill 绑在同一个箱子里,装一个就全有了。反过来,风险也在这里:.mcp.json 里写着连到哪台服务器,装插件之前值得看一眼------装一个插件,等于同时信任了它要连的服务。

还有一个值得单独提的插件:plugins/plugin-dev/。它是 Anthropic 给插件作者准备的"元插件"------里面装的不是给业务用的 skill,而是写插件用的 skill:skill-development、plugin-structure,连同 manifest-reference.md 这种清单参考和 minimal-plugin.md、standard-plugin.md、advanced-plugin.md 三档示例。意思是,写插件这件事本身也被打包成了一个插件。你要是想动手,先装它,再写你的第一个插件,相当于请了个随身教练。

拆解三:marketplace,目录牌怎么管 317 个插件

箱子有了,谁来告诉你"这里有哪些箱子、每个箱子在哪"?答案是 marketplac------一份 .claude-plugin/marketplace.json。官方文档先给它定了性:marketplace 是目录,不是商店。它不托管代码、不收钱、不审核运行效果,只列一张表:插件叫什么、从哪取。

这份表今天长这样(实测数,2026-11-16):317 个条目,11 条改名映射,14 个 strict: false 条目。顶层字段只有几个:$schema、name、description、owner、renames、plugins。owner 是 Anthropic(support@anthropic.com)。

一条典型的条目,commit-commands 在表里的登记(原文):

json 复制代码
{
  "name": "commit-commands",
  "description": "Commands for git commit workflows including commit, push, and PR creation",
  "author": { "name": "Anthropic", "email": "support@anthropic.com" },
  "source": "./plugins/commit-commands",
  "category": "productivity",
  "homepage": "https://github.com/anthropics/claude-plugins-public/tree/main/plugins/commit-commands"
}

注意 source 字段:"./plugins/commit-commands",一个相对路径。这就是"目录牌"的全部工作------把名字映射到仓库里的一个文件夹。安装时 Claude Code 按这个路径把文件夹取下来,放到你机器的 ~/.claude/plugins/ 里。条目里没有版本号、没有校验和、没有下载地址以外的任何东西,薄得和 plugin.json 一个风格。

不过 317 个条目并不都是这种本地路径。我数了一遍构成:只有 55 条的 source 是指向本仓库文件夹的相对路径,剩下 262 条的 source 是一个对象,指向别的仓库(仓库地址 + 子目录 + 分支 + 锁定的提交号,跟前面 amd-skills 那个写法一样)。也就是说,这张目录牌上超过八成的条目,箱子本身并不在这个仓库里------目录只负责指路,代码住在各自的原仓库。这也解释了为什么"逐步取消"对 Anthropic 来说是可行的:目录退化成自家 55 个插件的花名册时,剩下那 262 个外来条目本来就不归这个仓库管,搬去目录产品是顺水推舟。分类上,development 123 个、productivity 70 个、database 39 个占了大头,monitoring 22 个、security 18 个跟在后面------开发提效是这个市场的绝对主流,14 个条目连分类都没填,目录的维护也没你想象的那么严整。

从目录到会话:一共四步

#mermaid-svg-zJRuNav8AzDSzeoT{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-zJRuNav8AzDSzeoT .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-zJRuNav8AzDSzeoT .error-icon{fill:#552222;}#mermaid-svg-zJRuNav8AzDSzeoT .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-zJRuNav8AzDSzeoT .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-zJRuNav8AzDSzeoT .marker{fill:#333333;stroke:#333333;}#mermaid-svg-zJRuNav8AzDSzeoT .marker.cross{stroke:#333333;}#mermaid-svg-zJRuNav8AzDSzeoT svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-zJRuNav8AzDSzeoT p{margin:0;}#mermaid-svg-zJRuNav8AzDSzeoT .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-zJRuNav8AzDSzeoT .cluster-label text{fill:#333;}#mermaid-svg-zJRuNav8AzDSzeoT .cluster-label span{color:#333;}#mermaid-svg-zJRuNav8AzDSzeoT .cluster-label span p{background-color:transparent;}#mermaid-svg-zJRuNav8AzDSzeoT .label text,#mermaid-svg-zJRuNav8AzDSzeoT span{fill:#333;color:#333;}#mermaid-svg-zJRuNav8AzDSzeoT .node rect,#mermaid-svg-zJRuNav8AzDSzeoT .node circle,#mermaid-svg-zJRuNav8AzDSzeoT .node ellipse,#mermaid-svg-zJRuNav8AzDSzeoT .node polygon,#mermaid-svg-zJRuNav8AzDSzeoT .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-zJRuNav8AzDSzeoT .rough-node .label text,#mermaid-svg-zJRuNav8AzDSzeoT .node .label text,#mermaid-svg-zJRuNav8AzDSzeoT .image-shape .label,#mermaid-svg-zJRuNav8AzDSzeoT .icon-shape .label{text-anchor:middle;}#mermaid-svg-zJRuNav8AzDSzeoT .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-zJRuNav8AzDSzeoT .rough-node .label,#mermaid-svg-zJRuNav8AzDSzeoT .node .label,#mermaid-svg-zJRuNav8AzDSzeoT .image-shape .label,#mermaid-svg-zJRuNav8AzDSzeoT .icon-shape .label{text-align:center;}#mermaid-svg-zJRuNav8AzDSzeoT .node.clickable{cursor:pointer;}#mermaid-svg-zJRuNav8AzDSzeoT .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-zJRuNav8AzDSzeoT .arrowheadPath{fill:#333333;}#mermaid-svg-zJRuNav8AzDSzeoT .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-zJRuNav8AzDSzeoT .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-zJRuNav8AzDSzeoT .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-zJRuNav8AzDSzeoT .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-zJRuNav8AzDSzeoT .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-zJRuNav8AzDSzeoT .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-zJRuNav8AzDSzeoT .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-zJRuNav8AzDSzeoT .cluster text{fill:#333;}#mermaid-svg-zJRuNav8AzDSzeoT .cluster span{color:#333;}#mermaid-svg-zJRuNav8AzDSzeoT div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-zJRuNav8AzDSzeoT .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-zJRuNav8AzDSzeoT rect.text{fill:none;stroke-width:0;}#mermaid-svg-zJRuNav8AzDSzeoT .icon-shape,#mermaid-svg-zJRuNav8AzDSzeoT .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-zJRuNav8AzDSzeoT .icon-shape p,#mermaid-svg-zJRuNav8AzDSzeoT .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-zJRuNav8AzDSzeoT .icon-shape .label rect,#mermaid-svg-zJRuNav8AzDSzeoT .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-zJRuNav8AzDSzeoT .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-zJRuNav8AzDSzeoT .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-zJRuNav8AzDSzeoT :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 首次打开交互会话

官方市场自动添加
plugin 打开 Discover

浏览 marketplace.json 的 317 个条目
plugin install commit-commands@claude-plugins-official

按 source 取文件夹
落盘 ~/.claude/plugins/

会话启动时整包加载
命令 / skill / hook / MCP

全部就位

四步里最值得说的是第一步:官方市场是自动加的 。你第一次打开交互式终端会话,Claude Code 就会把 claude-plugins-official 加进你的市场列表,不用你敲任何命令。社区市场(claude-community)不会自动加,得自己跑 /plugin marketplace add。这个不对称是故意的:自动加的只能是 Anthropic 自己背书的目录。

安装时还要选一个作用域,官方文档给了三个档:用户级(这台机器上所有项目都启用)、项目级(写进仓库的 .claude/settings.json,协作者各装各的机器)、本地级(只在这个仓库、只对你生效)。团队分发插件,项目级是最常用的姿势:把"启用哪个插件"提交进仓库,把"装没装"留给每个人自己的机器。

项目级启用写出来是这样的(.claude/settings.json 片段,按官方文档写法):

json 复制代码
{
  "enabledPlugins": {
    "review-guard@team-marketplace": true
  }
}

这行配置进仓库之后,团队里每个人打开这个仓库,review-guard 就在启用列表里------但注意,启用不等于安装:插件本身还得每个人在自己机器上装一遍(/plugin install review-guard@team-marketplace),配置只解决"启用",不解决"有没有"。这个区分很关键:配置管意愿,安装管事实。官方文档把加载分成三层------设置层(启用了哪些)、磁盘层(~/.claude/plugins/ 里实际装了哪些)、会话层(这次会话加载了哪些)------三层对不上,插件就不会出现在你面前。出问题先按这三层查:设置里有没有启用、磁盘上有没有文件、会话启动时有没有加载,比漫无目的地重装管用得多。

改名为什么能自动迁移?renames 只有 11 条,但每条都是一次事故

前面说插件名改不得。现在看后门长什么样。marketplace.json 顶层的 renames 今天有 11 条(实测),比如:

json 复制代码
"renames": {
  "sap-fiori-mcp-server": "sap-ux-fiori-tools",
  "adlc": "agentforce-adlc",
  "convex-backend": "convex",
  "vals": "valtown"
}

第一条就是今天 HEAD commit(b5b01ac4,2026-11-14)刚改的:sap-fiori-mcp-server 改名 sap-ux-fiori-tools,同时把来源指向了另一个仓库的 plugins-coding-agents/fiori。README 的解释是:Claude Code 的插件加载器读这张映射表,用户下次同步时自动把旧 slug 重写成新 slug,装了旧名字的用户不用手动重装。

这个设计有两层意思。第一层是技术:改名映射必须放在市场目录这一层,因为只有目录同时认识旧名字和新名字,插件自己认识不了自己的旧名。第二层是治理:11 条映射对应 317 个插件,说明改名是例外不是常态------Anthropic 宁可维护一张手工映射表,也不肯把改名做成插件作者随手能点的操作。你要是自己建市场、管自己团队的插件,照这个比例想一想:你的插件名最好第一天就定死,改名是全员同步的成本,别当成日常操作。

skill-bundle:没有清单的插件怎么进目录?

317 个条目里有 14 个是 strict: false 的特殊条目。什么意思?有些仓库只放了一堆 SKILL.md,根本没有 .claude-plugin/plugin.json------比如 AMD 的 skills 仓库。目录要收它,不能要求它先补一份清单,于是条目自己把 skills 列出来:

json 复制代码
{
  "name": "amd-skills",
  "description": "AMD's verified Agent Skills in one plugin...",
  "author": { "name": "AMD" },
  "category": "development",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/amd/skills.git",
    "path": "skills",
    "ref": "main",
    "sha": "6916fb371d1cba40757b223cf16b4cd4912b202f"
  },
  "strict": false,
  "skills": [
    "./local-ai-use",
    "./local-ai-app-integration",
    "./serving-llms-on-instinct",
    "./tracelens-analysis-orchestrator",
    "./hyperloom-workload-optimizer"
  ],
  "homepage": "https://developer.amd.com/"
}

三个细节值得记。第一,source 从一个相对路径变成了一个对象:仓库地址、子目录、ref 分支、锁定的 sha------目录直接从别人的仓库里按提交号取一个子目录,不用对方配合。第二,skills 数组里的路径是相对于 source.path 的,每个路径指向一个装着 SKILL.md 的目录,装进来之后注册成 <插件名>:<skill 名>。第三,strict: false 的意思是"别按有清单的标准卡我",代价是目录方要手工维护这份 skills 清单,仓库里加了新 skill,目录不更新就看不见。

这是个很务实的折中:推广期的生态里,大量好内容是以"一堆 SKILL.md"的形态存在的,等它们一个个补清单太慢了。但你也能看出来,这种条目维护成本高------14 个已经是全部 317 条里的少数派,Anthropic 显然不想让它变成主流。

目录正在收窄:这对你是好消息还是坏消息?

回到开头那句 README 原文。marketplace.json 对第三方"正在逐步取消",最终只留 Anthropic 自家的插件。第三方提交改走 claude.ai/directory/manage,通过之后分发到各个 Claude 产品里。

先说这对普通用户意味着什么:你装插件的姿势不用变 。/plugin install xxx@claude-plugins-official 照常工作,官方市场自动添加也不变。变的是插件作者的投稿路径:以前是给这个仓库提 PR、等合并进 marketplace.json;现在是去目录提交、过审后上架。仓库里的 external_plugins/ 就是旧路径的遗迹------14 个目录,搬家之前加进来的第三方插件,和 Anthropic 自家的频道插件(Discord、fakechat、iMessage、Telegram)混放在一起。

再说对你写教程、做团队分发的影响。如果你照着 2025 年底的旧文章,给团队写"把插件提交到官方市场"的手册,那一节可以直接删了。团队自己的插件根本不用走官方市场:自己建一个市场仓库,放一份自己的 marketplace.json,团队成员跑一次 /plugin marketplace add 就行。官方市场收窄,恰恰说明 Anthropic 想把"官方目录"和"第三方分发"拆成两条线------官方目录只对自己家负责,第三方的事交给目录产品和自建市场。这个拆分其实更干净:你不用再猜一个 PR 会不会被合、什么时候合。

一句话总结这一节:marketplace.json 是一张薄薄的映射表,317 个名字对 317 个文件夹;它正在退化成 Anthropic 的自家花名册,而第三方的路已经搬去了别处。读旧教程的时候,先看一眼日期。

拆解四:mods 和 hooks,差的不是语言,是位置

插件机制里最容易混淆的一对就是 hooks 和 mods。名字像,文件像(都住在 hooks/ 里),但它们住在不同的位置,做的事情也完全不同。

settings hooks(就是 hookify 用的那种)住在进程外面。 事件到了,Claude Code 起一个子进程跑你的 shell 命令(hookify 跑的是 python3 .../pretooluse.py),脚本读 stdin 里的事件 JSON,返回一个 verdict:放行、拦下、或者改一改再放行。脚本跑完进程就退出,和 Claude Code 之间只通过 stdin/stdout 说话。它能做的事受限于这个接口:跑命令、给 verdict,仅此而已。

mods 住在进程里面。 一个 mod 还是一个插件,但它多了一个"hooks 模块":一段 JavaScript 或 TypeScript 代码,在 Claude Code 自己的进程里运行。2026-10-01 发布,CLI v2.1.287 起默认开启。三件套长这样:

复制代码
first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

hooks.json 里只有一行关键内容:

json 复制代码
{
  "modules": ["./register.js"]
}

modules 这个键就是"这是个 mod"的开关。register.js 导出一个 register 函数,Claude Code 在 mod 加载时调它一次,传进来一个 on 函数,你用 on 去订阅事件:

js 复制代码
// hooks/register.js(按官方文档写法手写,未在 Claude Code 内实测加载)
export function register(on) {
  // 工具调用前:改写、放行或拦下
  on('tool.call', { tool: 'Bash' }, async ($, event, next) => {
    return next(event);
  });
  // 界面绘制时:画自己的 UI
  on('ui.render', { component: 'AbovePrompt' }, async ($, event, next) => {
    return next(event);
  });
}

不需要 Node,不需要打包,.js 和 .ts 直接加载。官方文档那句分水岭的话是:"hooks can't rewrite events, draw new UI, or replace features. Mods can."------hooks 只能在事件外面给个 verdict,mods 能在事件里面改写它、画出新界面、替换掉一部分功能。

具体说,mods 能做的事分五类,都是 settings hooks 碰不到的:改写或拦截工具调用(调用之前改参数、调用之后改结果、直接拦下);在界面上画自己的东西(状态栏、提示区、自定义面板);注册即时生效的斜杠命令;替换掉某个内置行为;以及监听会话、提示提交这些生命周期事件。官方文档里的第一个示例 mod 只有二十来行 JavaScript:数一数 token 用量,画在界面上------这件事用 settings hooks 做不到,因为 hooks 画不了界面。反过来也要想清楚:mods 的能力边界就是"Claude Code 自己的进程里能做的事",它不是给你开了一个新世界的门,是把你放进了司机座位。

settings hooks mods
写在哪 任何脚本语言(hookify 用 Python) JavaScript / TypeScript
跑在哪 子进程,跑完退出 Claude Code 进程内,常驻
能干什么 跑命令,给 verdict(放行/拦下) 改写事件、画 UI、注册即时命令、替换功能
三件套 hooks.json(事件 → 命令) plugin.json + hooks.json(modules 键)+ register.js
最低版本 插件机制就有 CLI v2.1.287+(2026-10-01 起默认开启)
风险 子进程权限,相对可控 不沙箱化,以你的全部权限运行

这里要诚实地说一句:这个仓库的 HEAD(b5b01ac4)里一个 mod 都没有 。我 grep 了整个 plugins/ 和 external_plugins/,没有一份 register.js。这不奇怪------mods 才发布一个半月,官方仓库的插件大多是 2025 年的旧形态,mods 的示例目前在 Claude Code 自己的仓库和官方文档里,不在这里。上面那段 register.js 是按官方文档手写的结构示例,不是仓库里的真实文件。等你看到某个插件带 register.js,先看它的 hooks.json 里有没有 modules 键------有,就是 mod;没有,就还是 settings hooks。

安全那句必须单独拎出来说。官方文档和 2026-10-01 的公告口径一致:mods 不沙箱化,以安装者(就是你)的全部权限运行 ,能读写你的文件、发网络请求、看到每一句提示词和每一次工具调用。settings hooks 好歹还隔着一层子进程,mods 是直接住进来的。所以安装原则只有一条:只装你信得过的来源。官方市场、你自己写的、团队内部评审过的,这三类之外,先读一遍 register.js 再装------它就一个文件,读起来不费事,装完再读就晚了。

本地实测:57 份清单全跑一遍,外加一只手写的小插件

先说实测的边界,免得你误会。这台机器上没有装 claude CLI (which claude 无结果),所以我没有在 Claude Code 里实测安装、没有跑 /plugin install、没有在真实会话里看插件加载。下面的实测止于清单解析和本地结构校验,这个口径我全文都认------没做过的事,不写成做过。

第一步:把仓库整个校验一遍

我把仓库浅克隆到本地(git clone --depth 1,HEAD b5b01ac4,2026-11-14),写了个校验脚本 verify-plugins.py,干了四件事:逐个解析 57 份 plugin.json、数 marketplace.json 的条目和 renames、检查有没有重名插件、检查本地 source 路径是不是真实存在。输出如下(Python 3.12.3,2026-11-16 实测):

图 2:校验脚本的真实输出。57 份清单零错误,317 个市场条目无重名、本地路径无缺失,14 个 strict:false 条目。最小插件的钩子脚本在读不到输入时放行(退出码 0),遇到 git commit 时才提醒------钩子写错了会拦路,放行逻辑要先写对。

结果没有意外,但"没有意外"本身就是结论:一个 47,413 Star 的官方仓库,清单层是干净的------57 份全合法、317 个条目零重名、所有本地路径都真实存在。这说明清单和目录这两层薄薄的约定,在 300 多个插件的规模下是守得住的。薄,不等于糙。

第二步:手写一只最小插件,验证它能不能被装起来

光读别人的插件不够,我按最小形态手写了一只,名字叫 review-guard------就是开篇那个团队故事里缺的东西:提交之前先拦一道,提醒人看一遍 diff。

复制代码
review-guard/
├── .claude-plugin/
│   └── plugin.json
├── commands/
│   └── review-first.md
└── hooks/
    ├── hooks.json
    └── guard.py

清单只有四行:

json 复制代码
{
  "name": "review-guard",
  "description": "提交前拦一道:工作区有未提交改动时提醒先 review 再提交",
  "version": "0.1.0",
  "author": { "name": "Albert", "email": "2406189359@qq.com" }
}

命令文件 commands/review-first.md 用了 commit-commands 同款写法------frontmatter 限死工具白名单,正文里用 ! 现场取数:

markdown 复制代码
---
description: 提交前先看一遍 diff 再决定
allowed-tools: Bash(git status:*), Bash(git diff:*)
---

## Context

- 当前状态:!`git status --short`
- 未提交 diff:!`git diff --stat`

## Your task

先把上面两份输出读一遍,挑出最值得人工看的三处改动,逐条说清风险,再问我是否继续提交。不要直接提交。

钩子是这只插件里最值得说的部分。hooks/hooks.json 把 PreToolUse 事件(限定 Bash)指向 guard.py:

json 复制代码
{
  "description": "review-guard hooks",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/guard.py\"",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

guard.py 只有二十来行,逻辑就一条:读 stdin 里的事件,如果工具调用里有 git commit,往 stderr 写一句提醒;读不到输入就放行,绝不因为钩子自己出错而拦住正常工作:

python 复制代码
"""PreToolUse 钩子:拦截 git commit,改动超过 20 个文件时要求先 review。"""
import json, sys

def main() -> int:
    try:
        payload = json.load(sys.stdin)
    except Exception:
        return 0  # 读不到输入就放行,别把钩子写成拦路虎
    cmd = ""
    try:
        cmd = payload["tool_input"].get("command", "")
    except Exception:
        pass
    if "git commit" in cmd:
        print("review-guard: 检测到 git commit,先跑 /review-first 看一遍 diff 再提交", file=sys.stderr)
    return 0

if __name__ == "__main__":
    raise SystemExit(main())

校验结果:py_compile 通过;喂非法输入,退出码 0(放行);喂 {"tool_input": {"command": "git commit -m x"}},stderr 准时出现提醒。结构校验(清单 + 命令 + 钩子)全部通过。没装进 Claude Code 里跑是这篇实测唯一的缺口------等你有 CLI 的机器上,加载姿势是 claude --plugin-dir ./review-guard,不用经过市场就能单会话试装,改完保存即热重载。

写这只插件花的时间不到一小时,其中一半花在想清楚"它到底拦什么"上。这个比例很正常:插件的难度从来不在文件格式,而在你想打包的那个流程本身够不够清楚。流程不清楚,箱子装得再漂亮也是空的。

进阶实战:把 review-guard 发给全团队

一只插件在自己机器上跑通只是半成品,后半段是分发。团队分发有三步,每一步都有个容易踩的点。

第一步:建一个团队自己的市场。 不用等官方收录,自己建个仓库,放一份 marketplace.json,条目指向插件文件夹就行:

json 复制代码
{
  "name": "team-marketplace",
  "description": "团队内部插件市场",
  "owner": { "name": "Your Team" },
  "plugins": [
    {
      "name": "review-guard",
      "description": "提交前拦一道:先 review 再提交",
      "author": { "name": "Albert" },
      "source": "./plugins/review-guard",
      "category": "productivity"
    }
  ]
}

团队成员只要跑一次 /plugin marketplace add <你们的市场仓库>,再跑 /plugin install review-guard@team-marketplace。市场是"目录不是商店"的另一面:你不需要任何审批流程、不需要等谁合并 PR,一份 JSON 就是一个市场。

第二步:定作用域,别让插件在不该出现的地方出现。 团队规范类的插件(比如 review-guard)适合项目级:把启用写进仓库的 .claude/settings.json,这样每个人进这个仓库就自动启用,出了这个仓库就不打扰。个人效率类的插件(比如你自己的 commit-commands 变体)放用户级。作用域选错的症状很典型:有人抱怨"每个项目都被 review-guard 拦",八成是装成了用户级。

第三步:定更新规矩。 插件装完不是一劳永逸------清单里的 version 就是干这个的。团队市场更新插件的做法是推新版本、让成员同步更新;别的做法是直接改文件不改版本,那样没人知道自己装的是第几版,出问题也对不上号。版本号这东西,写的时候觉得多余,查问题的时候才知道它值多少钱。

还有一个团队场景值得提:频道插件 。仓库 external_plugins/ 里有 Discord、Telegram、iMessage、fakechat 这几个 Anthropic 自家的频道插件,它们做的事情是把 Claude 接到聊天软件里。这个方向和"给团队发插件"是同一条线:插件机制分发的不是代码,是"一套现成的工作方式"。你团队里那套"提交前必须 review、发版前必须跑测试"的规矩,过去靠口头传,现在可以装进一只箱子发下去------规矩本身变成了可安装的东西。

分发出去之后还有半件事:更新和停用。插件不是发出去就完事的,流程改了、钩子修了 bug,团队成员怎么拿到新版?做法是推新版本到市场,成员在 /plugin 里更新------版本号这时就派上了用场:你问一句"你装的是第几版",对方报出 0.1.0 还是 0.2.0,问题定位立刻少一半。反过来,某个插件出了问题要紧急停用,也不用卸载:官方文档给了停用(disable)的路子,/plugin 里关掉,或者命令行 claude plugin disable,关掉就停在那里,文件还在,想恢复再打开。卸载是删文件,停用是关开关------团队出问题时先关开关,别急着删文件,留着现场才好查。

横向对比:插件、散装 skill、mods,怎么选

三样东西都能扩展 Claude Code,但它们的适用面完全不同。先看总表,再看决策表。

维度 只用 skills(散装) 打包成插件 写 mods
上手成本 最低:一个 SKILL.md 丢进 ~/.claude/skills/ 就能用 中等:多写一份清单,考虑分发 较高:要写 JS/TS,要懂事件模型
分发 靠复制文件,人肉同步 一次安装,整包走,市场可更新 随插件分发,和插件同一个包
能做的事 教 Claude 知识和流程,按需加载 打包命令+skill+agent+hook+MCP 一整套 改写事件、画 UI、替换功能
上下文成本 只占自己名字+描述 整包里每个组件的名字+描述都占 同插件,另加常驻代码
风险 只读的 Markdown,风险最低 组件里有什么就跑什么,要审 不沙箱化,以你的全部权限运行
适用规模 一个人、一两个 skill 团队、一整套流程、要版本管理 需要改行为、画界面才用得上

决策表(按你的情况对号入座):

你的情况 选什么 为什么
只有一个 skill,自己用 散装 skill,别打包 行李箱装一把伞,纯属添乱
三五个 skill 加两条命令,想发给三五个人 打包成插件,自建市场 一次安装解决同步问题,值回清单的成本
一套流程要进版本管理、要全员统一 打包成插件,项目级启用 版本号和市场就是为这个生的
要在工具调用前改写参数、拦下危险操作 settings hooks(可打包进插件) verdict 机制够用,别动 mods
要改界面、画状态栏、替换某个内置行为 写 mods 只有 mods 能碰 UI 和事件内部
不确定要不要插件 先散装,东西够三件再打包 插件是整理的结果,不是整理的起点

速查表(装插件之前过一遍,30 秒):

检查项 去哪看 不合格就别装
清单有没有 name 和 version .claude-plugin/plugin.json 没有版本,分发后没法对账
钩子跑什么命令 hooks/hooks.json 的 command 字段 看不懂的命令先别装
有没有 register.js(mod) hooks/ 目录 有 mod,先读代码再装
MCP 服务器连到哪 .mcp.json 的 url/command 连到陌生地址的先别装
市场来源 /plugin 里的市场名 非官方市场先核对仓库地址

局限与坑:四处真实会踩到的地方

坑一:照着旧教程走,会走到一条已经搬走的路。 这是今天最实在的坑。2025 年底的大量文章写着"给 claude-plugins-official 提 PR 投稿",这条路现在不通了------README 明确写着 PR 不再被监控,第三方投稿改走 claude.ai/directory/manage。绕法:投稿去目录提交;团队分发自建市场;读任何一篇讲插件分发的文章,先看日期,2026 年 9 月之前的分发章节默认按过期处理。

坑二:插件名改不得,改了就是一次全员事故。 name 是不可变 slug,改名会让已安装的用户报 plugin-not-found。绕法有两条:显示层面的改动用 displayName;非改不可时,在 marketplace.json 顶层加一条 renames 映射(旧名 → 新名),加载器会在用户下次同步时自动迁移------今天仓库里 11 条映射就是这么来的。给自己的插件起名之前多想五分钟,比事后写映射便宜得多。起名建议:短、通用、别带版本号和人名。

坑三:装得越多,每个会话越挤。 官方文档说得很实在:启用的插件是每个会话的一部分,每个组件的名字和描述每一轮都在上下文里占位置。装十个插件和装一个插件,上下文账完全不一样。症状是:没用什么插件,会话却越来越贵、可用窗口越来越小。绕法:定期打开 /plugin 的 Installed 标签,看"Not used recently"那一组------官方直接给你列出了最近没用过的插件,关掉就行。别把插件当收藏品攒。

坑四:mods 没有沙箱,装错一个等于交出钥匙。 settings hooks 好歹隔着子进程,mods 直接在 Claude Code 进程里以你的身份跑。绕法:只装三类 mod------官方市场的、自己写的、团队评审过的;装之前读一遍 register.js,它通常就几十行;团队分发含 mod 的插件时,在市场说明里写清楚"这个插件含 mod",让安装的人知情。

什么情况不该用插件? 三种。第一,东西只有一件、只给自己用------散装 skill 更轻。第二,流程还没定型、每周都在改------打包的成本(清单、版本、市场同步)会拖慢你改流程的速度,先散装跑顺了再打包。第三,你要的只是改一次设置(比如改模型、改权限)------那是 settings 的事,别为了一次配置拖一只箱子。

决策与下一步

写到这里,判断应该已经清楚了。收个尾,给你一张能直接用的清单:

  1. 先数数你手里的散件。 skills、命令、hooks、MCP 加起来不到三件,别打包;三件以上、且要发给第二个人,打包。
  2. 起名一次到位。 插件名是 slug,改名要全员迁移,第一天就定死。
  3. 分发走自建市场,别等官方。 一份 marketplace.json 就是一个市场,团队内部分发不需要任何人批准。
  4. 装插件前读三处: plugin.json(叫什么、第几版)、hooks/hooks.json(跑什么命令)、有没有 register.js(是不是 mod)。
  5. 每月清一次。 打开 /plugin 的 Installed 标签,把"Not used recently"里的插件关掉,上下文窗口是花钱买的。
  6. 含 mod 的插件单独记一笔。 团队市场里哪个插件带 register.js,在市场说明里写清楚,让装的人装之前就知道它要进进程里跑------信任这件事,宁可写在前面,不可事后解释。

学习路径也不长:先读官方插件文档(code.claude.com/docs/en/plugins),把 commit-commands 和 hookify 两个插件的源码各读一遍------一个轻、一个重,对照着看七个格子是怎么用的;然后按本文的 review-guard 手写一只自己的插件,用 claude --plugin-dir 单会话试装;最后再决定要不要读 mods 文档(code.claude.com/docs/en/plugins/mods)。读完这三步,你对插件机制的理解就超过大多数只装过插件的人了。

最后回到开篇那个团队。新人入职那天的问题,不是他不够仔细,是"整套定制"没有一个可安装的形态。插件机制解决的正是这个问题:把散在各处的文件装进一只箱子,贴上行李牌,放进目录,别人一条命令就能拎走。箱子本身没有魔法------魔法在箱子里的流程写得够不够清楚。

讨论钩子: 你的团队里有没有一套"人人都该这么干、但每次都要口头传"的流程(提交规范、review 清单、上线检查)?如果把它装进一只插件,你会先装哪三件东西------一条命令、一个 skill,还是一道钩子?

参考资料

  • anthropics/claude-plugins-official,GitHub 仓库,https://github.com/anthropics/claude-plugins-official ------ 创建 2025-11-20;本文核验 2026-11-16:Star 47,413、Fork 4,925,最后推送 2026-11-16T07:42:22Z;浅克隆 HEAD commit b5b01ac4(2026-11-14)。
  • Anthropic,Claude Code 官方插件文档,https://code.claude.com/docs/en/plugins ------ 插件定义、市场机制、安装作用域、上下文成本;页面更新于 2026-11-13,本文查阅于 2026-11-16。
  • Anthropic,Claude Code 插件市场文档,https://code.claude.com/docs/en/plugin-marketplaces ------ marketplace.json 结构、strict 模式与 skill-bundle 写法;本文查阅于 2026-11-16。
  • Anthropic,Mods 文档,https://code.claude.com/docs/en/plugins/mods ------ mods 三件套、modules 键、不沙箱化的安全说明;本文查阅于 2026-11-16。
  • Anthropic,"Customize Claude Code with mods in TypeScript",2026-10-01,https://claude.com/blog/claude-code-mods ------ mods 发布公告,CLI v2.1.287 起默认开启。
  • Anthropic,Claude 插件目录提交入口,https://claude.ai/directory/manage ------ 第三方插件现行提交入口(仓库 README 指引);目录开放提交见 2026-09-25 相关公告,本文查阅于 2026-11-16。
  • Anthropic,Claude Code 插件公开 beta 公告,2025-10-09 ------ "the standard way to bundle and share Claude Code customizations";本文通过官方文档与多家二手报道交叉核对。
  • GitHub Trending Python 日榜,https://github.com/trending/python?since=daily ------ 2026-11-16 08:01 UTC 抓取,前 17 名无 claude-plugins-official;11-15 曾列第 6 名(18:22 出现一次,21:23 未复现)。
相关推荐
少司府20 分钟前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
wflynn23 分钟前
GitHub 日榜趋势速报 | 2026-11-20
开源·github
程序员张富华28 分钟前
一次发布拦住12个破坏性变更:我们给Agent工作流加了Schema门禁
人工智能·agent
伞伞悦读1 小时前
【第90期】KNN分类回归流水线与K值对照的实验与排查
大数据·人工智能·python·深度学习·机器学习
xrlfreedom2 小时前
MCP 面试高频考点:给 MCP Server 加日志、指标与分布式追踪,面试追问你能答到第几层?
结构化输出·mcp·mcp server
console.log('npc')2 小时前
Python 学习教程 · 第4课:数据结构
数据结构·python·学习
honker_X2 小时前
Python字符串全攻略:从入门到精通
开发语言·python
贾公子2 小时前
异步检测的轮询与超时——别把「还没好」当成「失败了」
后端·python
吃我一窝jio2 小时前
Docker+Jenkins+K8s全流程部署
java·开发语言·笔记·python