乐于分享
好东西不私藏

我看了 Anthropic 的插件仓库,最值得抄的是这个结构

我看了 Anthropic 的插件仓库,最值得抄的是这个结构

如果你想给 Claude 做自己的工作流插件,别先想功能。

先看目录结构。

Anthropic 这次开源的 knowledge-work-plugins 仓库,最有用的地方不是“它有 11 个插件”。真正有用的是:它把一个 Claude 插件该怎么组织,直接摆出来了。

一个典型插件长这样:

plugin-name/
├── .claude-plugin/plugin.json
├── .mcp.json
├── commands/
└── skills/

看起来很普通。

但这里面分工很清楚。

.claude-plugin/plugin.json 是插件说明。告诉 Claude 这个插件是谁、做什么、有哪些能力。

.mcp.json 是工具连接。比如 Slack、Notion、Jira、Figma、BigQuery。你要换成自己的工具栈,主要就是改这里。

commands/ 放显式命令。用户主动调用,比如产品管理插件里的 brainstorm,或者 README 里举的 /data:write-query。

skills/ 放自动触发的能力。Claude 判断当前任务相关时,会自己用这些说明。

这个区分很关键。

很多人做 agent,所有东西都往一个 system prompt 里塞。最后 prompt 越来越长,模型也越来越难判断什么时候该做什么。

Anthropic 的做法更像拆模块。

高频动作,放 commands。

领域判断,放 skills。

外部数据,放 connectors。

比如工程插件。

它的 skills/ 下面有 code-review、debug、architecture、incident-response、testing-strategy 等。code-review 不是只说“请认真审代码”。它明确写了要看安全、性能、正确性、可维护性,还给了输出格式。

debug 也一样。

它不是让 Claude “分析一下问题”。

它把流程拆成 reproduce、isolate、diagnose、fix。先复现,再缩小范围,再给假设,再修。

这就是技能文件的价值。

它不是知识库。

它是工作习惯。

产品管理插件也很典型。

write-spec 不是直接生成 PRD。它先要求理解功能,再收集用户问题、目标用户、成功指标、约束、历史方案。然后才写 Problem Statement、Goals、Non-Goals、User Stories、Requirements、Metrics、Open Questions。

这说明一个事:

好的插件,不是让 Claude 输出更长。

是让 Claude 少走错流程。

如果我要给自己的日常工作做插件,我会这么拆。

第一层,插件名叫 content-operator。

它不做泛内容写作,只做“从素材到发布”的内容流水线。

第二层,commands:

/content:topic-audit
/content:rewrite
/content:ai-check
/content:platform-adapt
/content:wechat-draft

这些是我明确要执行的动作。

第三层,skills:

skills/topic-diagnosis/SKILL.md
skills/style-money/SKILL.md
skills/style-tech/SKILL.md
skills/ai-fingerprint-check/SKILL.md
skills/xhs-compliance/SKILL.md
skills/wechat-formatting/SKILL.md

这些是判断规则。

比如什么是好选题,什么叫 AI 味,什么词小红书容易出问题,公众号排版要怎么处理。

第四层,connectors:

{
"notion": "选题库和历史文章",
"wechat": "公众号草稿箱",
"github": "技术项目上下文",
"gmail": "读者反馈和合作邮件"
}

注意,连接器不是越多越好。

只接会影响输出质量的工具。

如果一个工具只是“看起来很酷”,但不会改变决策,就别接。

做这种插件时,我会先写一个最小版本。

只保留 3 个东西:

一个 /content:rewrite 命令。

一个 style-money 技能。

一个 ai-fingerprint-check 技能。

先让它稳定产出一篇能发的文章。

等这个跑顺了,再加小红书适配、公众号草稿箱、封面图。

不要一上来就做全套。

插件的坑也在这里。

结构太容易抄,所以很多人会误以为“建目录 = 做插件”。

不是。

真正难的是把你的判断写清楚。

比如 code review 技能,难点不是列安全、性能、正确性这几个词。难点是告诉 Claude:遇到 PR 时,先看什么,哪些问题必须拦,哪些只是建议,输出该怎么排优先级。

写 spec 也一样。

难点不是 PRD 模板。

难点是让 Claude 先问清楚用户问题,不要一上来编需求。

所以我看这个仓库,最大的收获是:

别把插件当 prompt 包。

把它当你的工作流源码。

你平时怎么判断、怎么检查、怎么交付,都可以拆成 markdown 和 JSON。

这套东西没有代码,也不用构建。

但它会逼你回答一个更难的问题:

你自己的工作,到底有没有一套稳定方法?

相关学习资料