首页 › skills-review › 把写作变成采访:官方协作件首拆

把写作变成采访:官方协作件首拆

概述

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 作为格式层代表入表对照。官方四件同属一个仓库,社区活跃度按仓库整体更新节奏计,不区分单件。

主拆 doc-coauthoring:写作的三个阶段,一个都不许跳

它治的是什么病

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 这类有本地目录的宿主。

参照件速写:brand-guidelines,一件纯数据的光谱另一端

把 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 算清楚了。民间写作件赛道卷文风卷了几十个件,卷流程的至今没几个,这间空办公室,值得抄作业的人排队。

参考来源

  1. anthropics/skills — 官方 Skills 仓库 — doc-coauthoring、brand-guidelines 等十六件的 SKILL.md 原文所在,本文拆解的结构依据
  2. mcpservers.org/agent-skills — Claude Skills & Agent Skills Library — 官方与社区 Skills 的聚合目录,本期生态定位参照
  3. skills.sh — Skills 生态站 — Skills 装机命令与生态热度参照

[!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 等场景全覆盖。

51学通信知识星球海报-扫码加入