3.6 dsh-prose-standard：让文字不像机器写的

它是什么

dsh-prose-standard 的官方描述：在撰写、评审、恢复、精简或审计文案时使用。

约 9621 字节，另带一份 examples.md 参考资料（约 9457 字节）。关注的对象不是代码，是文字。

描述里的五个动词值得注意：撰写、评审、恢复、精简、审计。这个技能不只管“写新的”，还管把写坏了的文字救回来、把啰嗦的文字削瘦、对存量文案做定期巡检。文字质量和代码一样，是需要持续维护的资产。

为什么大团队需要文风技能

技术文档最常见的质量问题不是错别字，而是读起来像机器生成的：

  • 每段都是“综上所述，我们可以得出”；
  • 该说人话的地方堆术语；
  • 长短句完全一致，节奏死板；
  • 结论藏在第三段，读者早跑了。

这些问题单看每句都对，合在一起就是“不想读”。dsh 团队专门为文案立标准，说明他们认为文字质量是产品质量的一部分——错误提示、文档、发布说明，都是用户接触到的产品本身，不是产品的包装纸。

人多了以后，文风问题会被放大：十个人十种写法，用户在不同页面间切换像在换产品。技能把标准固化下来，是让“产品口吻”不依赖某个人的文字感觉。

它和另一个技能的分工

这批技能里有个近亲叫 dsh-trim-cot-leakage，描述是“审计或修复读起来像思维链泄露的文案时使用”。两者分工：

技能 针对问题 体量
dsh-prose-standard 整体文风：该怎么说 9621B + examples.md 9457B
dsh-trim-cot-leakage 特定病灶：把推理过程写进了正文 7699B + examples.md 12566B + recall-batteries.md 4980B

后者治的是“首先，我需要分析用户的需求。然后，我应该……”这种把思考过程原样输出的毛病。前者管的是更上层的表达标准。

一个实用的记忆法：看到“首先……然后……综上所述”的流水账，找 dsh-trim-cot-leakage（5.2 节）；看到“每句都对但不想读”，找 dsh-prose-standard。 两个技能都自带大份 examples.md——文风类技能没有正反例是没法用的，这一点两边高度一致。

五个维度

结合技能体量与命名，文风标准通常覆盖五个维度：

维度 常见规定
结构 结论先行还是铺垫先行
句式 长短搭配、避免全篇同构
用词 术语密度、是否堆形容词
语气 对读者说话，而不是对屏幕说话
禁忌 禁用套话、禁用空洞总结

五个维度里最难执行的是语气。结构、句式、用词都能逐条查，语气只能靠对比：把“对屏幕说话”的版本和“对读者说话”的版本摆在一起，差别一目了然。这也是 examples.md 存在的意义。

一个对照改写例子

光说规则太空，给一个真实感的例子。

改写前（对屏幕说话、套话密集）：

综上所述，我们可以发现，这个配置项在大多数的情况下都能够正常地工作。
值得一提的是，值得注意的是，它的性能表现也是相当不错的。
不难发现，如果您想要使用这个功能，您可以先进行相关的设置操作。

改写后（对读者说话、结论先行）：

这个配置项在默认参数下即可正常工作。性能方面，在我们的基准测试里延迟低于 10 毫秒。
要启用它，先在设置里打开开关，再重启服务。

差别不在词汇量，而在三件事：结论放在句首、删掉了“综上所述 / 值得一提的是 / 不难发现”三件套、把“您可以先进行相关的设置操作”翻成了具体动作。文风技能管的正好就是这些——它不教你怎么写长句子，教你怎么不写废句子。

文风技能必须配正反例

examples.md 和 SKILL.md 几乎一样大（9457 字节对 9621 字节），这个比例很说明问题：文风这种东西，给正反例比给规则有效十倍。

原因是规则有无限的符合方式。“避免堆术语”是一条规则，但什么叫堆术语、堆到什么程度算越界，规则说不清，例子一说就清。所以如果你要改造这个技能，最重要的不是改规则条文，而是换例子——把 examples.md 里的案例换成你团队真实写过的句子，标准的约束力会立刻上一个台阶。

同理，自己团队写文风规范时，先攒例子再写规则。例子不够，说明标准还没想清楚。

团队怎么落地

把 dsh-prose-standard 搬回团队，建议分三步，不要一上来就强推：

阶段 做法 目的
攒例 收集团队真实写过的“好句 / 坏句”各十条 让标准有锚点
定规 从例子里抽象出五维度规则 让标准可传播
嵌入流程 在评审清单里加一条“文风是否符合标准” 让标准被使用

最容易失败的做法是反过来：先写一份完美的文风规范文档，再要求所有人遵守。没有例子的规范，没人知道边界在哪，最后变成“大家都觉得自己符合”。

一条自检口诀

写完一段，朗读一遍。出现下面任一情况就改：

□ 读完不知道重点在哪
□ 有三处以上“的的的”
□ 句子长到需要回读
□ 出现了“综上所述”“值得一提的是”“不难发现”

朗读之所以有效，是因为念出来的节奏会暴露眼睛忽略的问题：长句念到断气、套话念起来顺口却无信息——耳朵比眼睛诚实。

你要不要装

你的情况 建议
团队写文档 / 博客 / 文案 建议
常让模型生成对外文字 建议，防 AI 味
只写代码注释 可选

小结

  • dsh-prose-standard 管整体文风，约 9621 字节 + examples.md 约 9457 字节。
  • dsh-trim-cot-leakage 治思维链泄露，两者互补。
  • 文风标准通常覆盖结构、句式、用词、语气、禁忌五个维度。
  • 文风技能必须配正反例，纯规则无效；改造时优先换例子。

延伸阅读