anthropics/skills 官方仓库一共十六件,这个栏目拆了大半年:格式四件套 docx、xlsx、pptx、pdf 各有专拆,测试件 webapp-testing、造件机 mcp-builder、模具 skill-creator 也都开过盖。但仓库里一直有一间没人进过的办公室——doc-coauthoring,官方唯一的“写作流程件”。它不管你产出什么格式,只管一件事:怎么让 Claude 写长文档时不一口气吐完、改稿时不失忆。本期首拆这间办公室,顺带捎上光谱另一端的 brand-guidelines 作参照,把官方十六件的“流程—规范—格式”三层楼理清楚。本文引用的 SKILL.md 内容为公开仓库文本的结构化梳理,个别措辞为大意转述,原文以仓库为准。
把官方仓库的十六件按“它到底管什么”重新码一遍,会发现一个清晰的三层结构:
mindmap
root((anthropics/skills))
格式层
docx
xlsx
pptx
pdf
流程层
doc-coauthoring
webapp-testing
规范层
brand-guidelines
internal-comms
视觉层
canvas-design
theme-factory
algorithmic-art
frontend-design
工程层
skill-creator
mcp-builder
web-artifacts-builder
slack-gif-creator
格式层管“产出什么文件”,本栏目拆得最透:docx 走 XML 改造不重建、xlsx 让公式自己算、pdf 门后还有一道门。工程层管“造件和测试”。而夹在中间的流程层和规范层,拆得最少——它们不产出文件,也不提供工具,只约束过程和口音。doc-coauthoring 是流程层的写作代表,brand-guidelines 和 internal-comms 是规范层的两件。这三件共同回答一个更软的问题:Claude 写字的时候,怎么让它像个有章法的同事,而不是个按一下就喷三千字的生成器。
| 维度(权重) | doc-coauthoring | brand-guidelines | internal-comms | docx(参照) |
|---|---|---|---|---|
| 功能完整度 25% | ★★★★ | ★★★ | ★★★ | ★★★★★ |
| 设计质量 25% | ★★★★★ | ★★★★ | ★★★★ | ★★★★ |
| 实战效果 20% | ★★★★ | ★★★ | ★★★ | ★★★★★ |
| 上手难度 15%(5星最易) | ★★★★★ | ★★★★★ | ★★★★★ | ★★★★ |
| 社区活跃度 15% | ★★★★ | ★★★★ | ★★★★ | ★★★★ |
| 加权总分 | 4.4 | 3.7 | 3.7 | 4.45 |
说明:internal-comms 此前已有专拆(“公文件首拆”一期),本期只进表不重拆;docx 作为格式层代表入表对照。官方四件同属一个仓库,社区活跃度按仓库整体更新节奏计,不区分单件。
Claude 写长文档有两个公开的痼疾。第一是“一喷到底”:你给一句“帮我写份产品方案”,它直接吐三千字,方向错了也得整篇重来。第二是“改稿失忆”:改到第五轮,它忘了第一轮你定下的受众定位,把你圈掉的内容又悄悄加回来。这两个病的根源相同——模型把写作当成一次性生成任务,而不是带状态的多轮协作。
doc-coauthoring 的 SKILL.md 开宗明义就是冲这个去的:它的核心约定是先问后写、落盘推进。整个文件没有一个字讲怎么“写得好”,全部篇幅都在讲流程怎么走、状态存在哪。
第一段:门牌(frontmatter)。 它的触发描述不绑定任何文档格式,绑定的是动作语义——用户说“帮我写”“起草”“改这份文档”“一起打磨”时命中。这是个值得注意的取舍:格式层件的门牌都写死文件类型(docx、xlsx),流程件如果也写死类型就废了,所以它的门牌锚的是“协作写作”这个动词域,格式的活留给 docx 这些件在执行阶段接力。两件可以串成一条线:coauthoring 管过程,最后落格式时调用 docx。
第二段:采访制开场。 SKILL.md 要求动笔前必须先弄清四件事:文档给谁看、要达成什么目的、手上已有什么材料、篇幅和形式有没有硬约束。用户没说的就问,不许自己脑补。这是整个件最“反直觉”的设计——大多数写作用户的预期是“我说一句你给我货”,而这个件把第一次交互变成了采访。代价是慢一轮,收益是方向锁死。
第三段:草稿落盘。 所有中间产物不留在对话里,而是写进工作区的文档目录:大纲是一个文件,逐节草稿各自成文,修订记录可追溯。这一段和 skill-creator 的理念同源——状态外置到文件系统,不依赖对话记忆。对话可以被压缩、被截断,文件不会。改到第十轮,模型忘了你第二轮的原话,但文件里留着。
第四段:分段推进与强制反馈环。 大纲要先给用户过目,认可了才准动笔;正文按节推进,每节交出去收反馈,带着意见改完再交下一节。流程上不存在“沉默整篇输出”这条路径。
整条流水线画出来是这样的:
flowchart TD
A["用户说要写文档"] --> B["采访:受众与目标"]
B --> C["大纲落盘"]
C --> D{"用户认可大纲?"}
D -->|不认可| B
D -->|认可| E["逐节起草"]
E --> F["收集逐节反馈"]
F --> G{"还有意见?"}
G -->|有| E
G -->|无| H["统稿定稿"]
两个回路是这张图的灵魂:大纲不过关退回采访,正文不满意退回起草。SKILL.md 用流程约定把这 defends 两个回路焊死,靠的不是模型自觉,而是文字规程。
一,把写作从生成问题改成了管理问题。 同行做写作件,几乎都在提示词里堆文风要求——不许用哪些词、要什么语气。doc-coauthoring 一条文风规则都没写,它管的全是过程秩序。事实证明秩序比文风值钱:方向对的中等稿子,永远好过方向错的漂亮稿子。
二,验收标准写进了流程本身。 每个阶段有明确的“过关条件”(大纲获批、逐节确认),用户不需要在最后算总账,错误在最早的环节被拦截。改大纲改十个字,比重写三千字便宜一百倍。
三,零依赖。 没有 scripts 目录、没有外部工具、没有任何环境要求,一个 SKILL.md 就是全部家当。官方仓库里最重的件(pptx 带 html2pptx 脚本链)和最轻的件(这个)放在一起,说明官方对“件”的定义很宽:能解决问题的最小说明书就是合格的件。
一,交互税。 四个采访问题加两道确认闸,写一条朋友圈用它是大炮打蚊子。它只对多轮迭代的长文档划算——需求文档、方案书、长文,短内容用户反而会觉得它啰嗦。
二,不解决“写得好”。 流程保证了不跑偏,但文字质量完全吃模型本身的水准。想要稳定输出某种文风,你得给它叠一层规范件——这正是要看第二件的原因。
三,文件约定的落盘位置依赖工作区。 在没有文件系统权限的网页端环境里,它的“状态外置”设计要打折,这套流程最适合的还是 Claude Code 这类有本地目录的宿主。
把 doc-coauthoring 拆完再看 brand-guidelines,会发现官方故意把两种极端都做出来了。
doc-coauthoring 是纯流程件:SKILL.md 里九成篇幅是“怎么做事”的规程,几乎不含任何事实数据。brand-guidelines 恰好相反,它是纯数据件:里面装的是 Anthropic 自家的品牌规范——色值、字体、logo 使用规则、文案语调的边界,一节一节码得像本小型 style guide。它几乎没有流程指令,做的事是“当 Claude 的输出需要符合我们家品牌时,把这份规范灌进上下文”。
这两件摆在同一个仓库里,等于官方在示范 SKILL.md 的光谱两端:一端是全是逻辑没有数据,一端是全是数据没有逻辑。大多数第三方件卡在中间,两头不靠——既没有清晰的流程规程,也没有独家数据,只有一段“你是一个专业助手”式的空话。之前拆过的“空货架审计”一期骂的就是这种中间态。
brand-guidelines 对普通用户的实用价值有限(里面是 Anthropic 的家规),但作为写法模板价值很高:任何公司想让自己的规范被 Claude 遵守,照它的分节法把自己家的色值、语调、禁则填进去就行。这是“企业知识进 Skill”的最小可行样例。
# 官方仓库整体克隆,按需拷贝(最可靠路径)
git clone https://github.com/anthropics/skills.git
cp -r skills/doc-coauthoring ~/.claude/skills/
cp -r skills/brand-guidelines ~/.claude/skills/
# 社区装机器方式(skills.sh 生态通行,参数以 skills.sh 首页说明为准)
npx skills add anthropics/skills --skill doc-coauthoring
两件都是零依赖件,拷进去即用,无环境要求。宿主端 Claude Code、Claude 网页版均可用,但 doc-coauthoring 的落盘流程在有本地文件系统的端上才完整生效。
设计质量榜(学写 Skill 看谁) 1. doc-coauthoring——流程件教科书,两个反馈回路是全场最值得抄的设计 2. brand-guidelines——数据件极简形态,分节法可直接套用 3. internal-comms——规范层合格线,场景更窄
开箱即用榜(今天装今天有产出) 1. docx——格式层老牌王者,4.45 分仍是官方件总分第一 2. internal-comms——命题作文型任务直接命中 3. doc-coauthoring——第一次采访会劝退急性子,第二轮开始回本
可抄模式榜(给想写自己第一件的读者) 1. 采访式开场:动笔前把受众、目标、材料、硬约束四问问满,模糊需求是烂稿的第一成因 2. 状态外置:在 SKILL.md 里明确写清“每个阶段的产物落进哪个文件”,跨轮次记忆不靠对话 3. 光谱定位:写件之前先想清楚你做的是纯流程、纯数据还是纯工具,别写中间态的空话件
官方十六件拆到最后这一间办公室,反而拆出了这个仓库最值得学的东西:格式层证明 Claude 能干活,工程层证明件能规模化生产,而 doc-coauthoring 证明的、是最不性感也最值钱的一条——好的 Skill 不是让模型更会写,是让它按得住、别抢跑。写作这件货,慢一轮采访,省十轮返工,这笔账官方用四十多行 SKILL.md 算清楚了。民间写作件赛道卷文风卷了几十个件,卷流程的至今没几个,这间空办公室,值得抄作业的人排队。
[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
