mcpField
V
voice-builder

voice-builder

github.com/social-media-skills营销与增长214889 次安装2 周前更新
代码仓库

关于 voice-builder

voice-builder 是一项技能,可从写作样本中提炼有证据支撑、可复现的个人文风指南。它面向内容创作者和代笔者,提供验证流程,并明确处理不确定性及多种文风。

主要功能

  1. 01按六个写作层面分析样本
  2. 02依据引用证据提炼文风特征
  3. 03在 voice.md 中编写可执行规则
  4. 04将生成文本与原始样本对照验证
  5. 05处理样本不足、不一致或多语言情况

适用场景

  1. 01根据作者现有文章创建文风指南
  2. 02支持大规模一致性代笔
  3. 03区分创始人与公司的文风

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/social-media-skills/skills --skill voice-builder

安装后在 Claude Code 中输入/voice-builder确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
analysis-framework.md
examples.md
samples-guide.md
validation.md
voice-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 中的框架:

  1. 词汇——用词、标志性短语、缩略形式、语域、习惯性避用的词。
  2. 句法——句子长度及变化、句首表达、片段句、主动/被动语态、节奏。
  3. 修辞——提问、直接称呼、重复、类比、对比、幽默、转折。
  4. 结构——开篇、展开和收尾方式;段落安排;格式。
  5. 立场——与读者的距离、权威姿态、自信程度、情感语域。
  6. 留白——那些显而易见地从不采用的做法。通常这是最能定义风格的层面。

每当指出一种模式时,都要引用证据——摘录样本文字。建立在断言上的风格指南会逐渐偏离;建立在引文上的则能保持准确。

第 3 步——提炼风格指纹

从分析中提取5–7 个最鲜明、最可复现的特征——只要把这些特征做好,写作就会让人认出是出自本人之手。这是 voice.md 的核心。还要补充留白(明确的“绝不”规则)。即便只准确抓住了指纹,读者也应该已经相信这就是本人写的。

第 4 步——编写 voice.md

使用 references/voice-template.md。内容要能直接指导写作,而不是写成个性介绍:提供写作者可以遵循的规则、说明风格如何随语境变化的语气图谱,以及 3–5 组改写示例(通用句子 → 用这种风格表达同一内容)。保留真实样本片段作为校准锚点。

第 5 步 — 用声音测试进行验证(不要跳过)

未经测试的 voice.md 只是假设。请按照 references/validation.md 中的流程操作:

  1. 仅使用 voice.md,围绕一个新主题生成一篇新文章。
  2. 将它与一篇真实样本放在一起。用户能分辨出哪篇是哪篇吗?
  3. 根据风格指纹特征评分——命中了哪些,漏掉了哪些?
  4. 修正遗漏,完善 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 — 两个风格对比鲜明的完整示例。

评论

支持 Markdown