关于 voice-builder
voice-builder 是一项技能,可从写作样本中提炼有证据支撑、可复现的个人文风指南。它面向内容创作者和代笔者,提供验证流程,并明确处理不确定性及多种文风。
主要功能
- 01按六个写作层面分析样本
- 02依据引用证据提炼文风特征
- 03在 voice.md 中编写可执行规则
- 04将生成文本与原始样本对照验证
- 05处理样本不足、不一致或多语言情况
适用场景
- 01根据作者现有文章创建文风指南
- 02支持大规模一致性代笔
- 03区分创始人与公司的文风
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ social-media-skills/ skills --skill voice-builder安装后在 Claude Code 中输入/voice-builder确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/analysis-framework.mdexamples.mdsamples-guide.mdvalidation.mdvoice-template.md详细介绍
Voice Builder
这项技能可以将真实写作转化为可复现的风格——一份 voice.md,任何下游技能(或人)都能据此写作,产出的文章与原文难以区分。
核心原则:从证据中提炼风格,而不是用形容词描述。 “有力且真实”无法指导写作——它没有告诉写作者任何具体做法。“以一句挑衅性的话开篇,使用短句,并穿插一个长句形成对比,使用破折号,从不使用感叹号,以问句收尾”则是可复现的。你的工作是把某人的写作转化为足够具体的规则。
何时使用
- 在使用
brand-profile后,如果用户有写作样本,可进一步深入分析风格。 - 内容总是显得泛泛、生硬,或“听起来不像我”时。
- 用于规模化代笔——一次捕捉风格,之后一直照此写作。
**何时不要使用:**如果没有可用样本,就不要凭空编造风格。转到 brand-profile 的风格访谈(维度 + 词汇表 + “我们的表达听起来 ___,绝不会 ___”这句话),等有了样本再继续。虚构风格不如诚实地访谈。
第 0 步——先阅读 brand-profile
加载 brand-profile.md,了解身份、受众和边界要求。voice-builder 会生成与之并列的 voice.md。如果 voice.md 已存在且内容仍适用,就加载并向用户总结,然后跳到用户的实际需求。
第 1 步——收集合适的样本
质量胜过数量。最好的样本是一看就知道出自本人之手——是他们引以为傲、采用自然表达方式且确实由他们写成的作品(不是多人编辑的,不是他人代笔的,也不是 AI 生成的)。目标是收集5–10 篇有一定篇幅的样本;最低要求是 3 篇。口语转录稿尤其宝贵——它们能捕捉自然节奏,避免自我编辑将其磨平。关于该收集什么、排除什么,请参阅 references/samples-guide.md。
如果样本不足或风格不一致,请坦诚说明,并以较低置信度继续,不要夸大结论。坦诚说明置信度也是交付内容的一部分。
第 2 步——结合证据分析六个层面
不要对“语气”随意联想。请逐层使用 references/analysis-framework.md 中的框架:
- 词汇——用词、标志性短语、缩略形式、语域、习惯性避用的词。
- 句法——句子长度及变化、句首表达、片段句、主动/被动语态、节奏。
- 修辞——提问、直接称呼、重复、类比、对比、幽默、转折。
- 结构——开篇、展开和收尾方式;段落安排;格式。
- 立场——与读者的距离、权威姿态、自信程度、情感语域。
- 留白——那些显而易见地从不采用的做法。通常这是最能定义风格的层面。
每当指出一种模式时,都要引用证据——摘录样本文字。建立在断言上的风格指南会逐渐偏离;建立在引文上的则能保持准确。
第 3 步——提炼风格指纹
从分析中提取5–7 个最鲜明、最可复现的特征——只要把这些特征做好,写作就会让人认出是出自本人之手。这是 voice.md 的核心。还要补充留白(明确的“绝不”规则)。即便只准确抓住了指纹,读者也应该已经相信这就是本人写的。
第 4 步——编写 voice.md
使用 references/voice-template.md。内容要能直接指导写作,而不是写成个性介绍:提供写作者可以遵循的规则、说明风格如何随语境变化的语气图谱,以及 3–5 组改写示例(通用句子 → 用这种风格表达同一内容)。保留真实样本片段作为校准锚点。
第 5 步 — 用声音测试进行验证(不要跳过)
未经测试的 voice.md 只是假设。请按照
references/validation.md 中的流程操作:
- 仅使用
voice.md,围绕一个新主题生成一篇新文章。 - 将它与一篇真实样本放在一起。用户能分辨出哪篇是哪篇吗?
- 根据风格指纹特征评分——命中了哪些,漏掉了哪些?
- 修正遗漏,完善
voice.md,然后再重复一两次。
向用户展示测试文章和结果。通过测试后,声音指南才算完成。
“优秀”的标准(完成前自检)
- 一个从未见过此人的写作者,仅凭
voice.md就能写出符合其风格的文章。 - 每项判断都有样本佐证——没有无依据的形容词。
- 风格指纹足够具体,能够被证伪(你可以指着一篇文章说:“这不是他/她,因为……”)。
- 不仅记录了正向特征,也记录了刻意避免的内容。
- 它通过了声音测试,而且你展示了证明。
缺少任何一项,就说明还没完成。
边缘情况——明确处理
- 样本稀少(1–2 篇短文): 记录可观察到的特征,将指南标为低置信度,说明哪些层面无法判断,并通过
brand-profile访谈补充。不要假装确定。 - 样本不一致(风格漂移): 不要把它们平均成一团。指出不一致之处,并询问哪些样本代表目标风格;以这些样本为准。
- 理想风格(他们想要的风格与当前风格不同):区分当前风格与目标风格。收集他们希望模仿的样本并标注为理想风格,透明地融合,让用户知道借鉴了哪些内容。
- 多种声音(公司与创始人;多位创作者):每种声音各创建一份
voice.md,并命名。绝不融合不同声音——否则就会创造出一个不存在的人。 - 经过大量编辑、代笔或 AI 生成的样本: 排除它们;它们不能代表此人的声音。说明排除原因。
- 口语与书面语: 录音转写能呈现自然节奏,但需要清理规则(填充词、说话中断)。记录节奏,并注明清理方式。
- 多语言: 按语言分别分析;不同语言中的声音很少能一一对应。
相关技能
brand-profile— 请先阅读;它会提供身份、受众和边界。writing-style-and-tone— 针对每篇内容和每个时刻应用voice.md(语气映射、编辑流程、AI 特征检查)。此技能编写章程;另一项技能依照章程执行。- 每项内容技能(
caption-writer、reels-script、thread-writer、linkedin-post-writer,等等)都会读取生成的voice.md。 audience-research、content-pillars— 相辅相成的基础技能。
参考资料
references/samples-guide.md— 如何寻找并筛选合适的写作样本。references/analysis-framework.md— 用于拆解声音的六层框架。references/voice-template.md— 要生成的voice.md的确切结构。references/validation.md— 声音测试:生成、比较、评分、完善。references/examples.md— 两个风格对比鲜明的完整示例。