better-writing

更好的写作

让文字清晰、忠实、具体、结构得当，并能鲜明地体现作者风格。

判断请求类型

动笔前先确定任务类型。

任务	适用情况	主要参考资料
起草	用户需要根据笔记、证据或简述撰写新内容	references/operating-contract.md、references/genre-modes.md
改写	已有草稿，可能需要调整结构或重新表述	references/revision-pass-stack.md、references/quality-gates.md
文字编辑	结构合适，但句子需要更清晰、更流畅或更简洁	references/foundations.md、references/voice-and-rhythm.md
审阅	用户需要诊断或评论，而非改写成稿	references/quality-gates.md
人性化润色	文字显得千篇一律、过于机械、公式化，或不像作者本人的风格	references/ai-isms-and-humanisation.md、references/genericity-and-stiffness.md；如果用户明确要求避免某些表达或文本中公式化用语过多，可加上 references/formulaic-language-catalogue.md
改编	保留内容实质，同时改变受众、体裁、渠道、篇幅或风格	references/genre-modes.md、references/style-bundles.md

混合请求可以同时采用多种任务类型。只有在需要指引时才查阅参考资料，不必按要求顺序逐一阅读。明确任务范围：如果请求同时涉及修复代码和改写错误消息，此技能可以修改面向用户的文字，但不会编辑周边源码、语法或代码行为。绝不为满足风格或措辞规则而重命名、改写或重新解释代码结构。在混合文档中，只编辑自然语言内容，并原样保留机器可读内容。

如果用户明确要求删除、替换、限制或统一使用 em dash、分号或冒号，请阅读 references/punctuation-and-sentence-flow.md。按需加载；常规文字编辑和人性化润色并不意味着要禁用某种标点。

处理技术文档或 Wiki 条目时，如果需要关注文档规范，请查阅 references/technical-documentation-and-wikis.md；如果不确定页面结构，请查阅 references/genre-modes.md。在采用 Google 开发者文档指南前，优先遵循仓库或组织的风格、区域设置、精确术语和目标平台要求。

仅限代码的实现、独立事实核查或作者身份分类，请使用其他工作流。此技能可以改写这些任务附带的文字，但不负责执行这些任务。

操作流程

根据编辑范围和风险，只选择所需的步骤。纠正单个句子时，可以直接理解请求、编辑并对照原文。大幅改写可能需要检查结构、证据、风格和交付质量。以下各节是按实用顺序排列的选项菜单，并非必须完成的八个步骤，也不要求产出过程文档。无论任务规模如何，都必须忠实于原文并满足用户要求的输出形式。

1. 明确写作约定

推断所提供的上下文已经确定了哪些事项。明确：

• 读者、交付内容和预期结果
• 源材料和事实依据
• 所需篇幅、格式、地区语言、行文风格和截止时间
• 用户需要的是草稿、改写、审阅、自然化润色，还是改编
• 允许改动的幅度

对于现有草稿，保护事实、数字、日期、名称、引文、引用、命令、路径、API 标识符、法律或技术术语、明确表达的不确定性，以及体现作者风格的语句。只有在内容复杂、后果重大或需要交接，以致无法直接对照源文时，才记录保留清单。

只有当缺失的选择会实质性改变结果时才提问。绝不编造源文中没有的证据、经验、批准、客户用语或信心。

不要把缺乏依据的赞誉或营销姿态当作事实性的不变量。如果去掉含糊的说法后剩下的内容太少，不足以成文，就指出证据缺口，或询问缺少的具体机制，而不是把同样空泛的说法换个顺序重排。

如果源材料敏感、限制严格、需要协作，或可能遗漏重要细节，请阅读 references/operating-contract.md。

完成标准： 已知或明确标记为未知的内容包括读者、预期结果、改写自由度、源材料的权威性和受保护的内容。

2. 改写前先诊断

按合适的层级指出问题：

• 全篇：文体、受众、顺序、论点或范围不当
• 章节：缺少步骤、证据、转折或决策
• 段落：承担多种任务、重点埋没、重复、衔接薄弱
• 句子：行为主体不清、过于抽象、冗长、单调或刻意强调
• 表层：语法、拼写、标点、格式或行文风格

保留已经奏效的部分。好的编辑并不是为了证明每句话都可以修改。

完成标准： 已明确需要负责处理的最小层级，以及草稿中最有力的内容。

3. 先调整结构，再润色风格

如果任务范围包含重组，就选择服务于读者和所需格式的结构；references/genre-modes.md 提供的是默认方案，而非固定模板。让每个章节和段落都有明确任务。安排证据的顺序，避免读者猜测这些内容为何出现。

对于文档和 wiki，在润色页面之前，先明确读者、起始状态、标准术语和完成目标。使用文档参考资料处理标题、操作步骤、链接、无障碍性、面向全球读者的清晰度和维护边界。

如果请求涉及大幅调整结构、让行文更自然，或修复过于密集、长篇堆叠或切分过度的文字，请阅读 references/natural-structure-and-digestibility.md。参考其中的转换示例，在任务发生变化处拆分，而不是按任意长度拆分。

对于仅要求审阅的工作，不要直接改写：报告诊断结果，引用具体段落，按对读者的影响排列问题优先级；如需提供改写，只能作为明确标注的示例。

完成标准： 开头确立了恰当的约定，中间部分逐步展开且不反复赘述，结尾完成了该文体真正需要的收束任务。

4. 在受影响的层面优化清晰度

对于复杂的修订，references/revision-pass-stack.md 提供了修订顺序。可合并或跳过没有价值的步骤：

1. 段落检查： 每个段落只做一件事，逻辑清晰可见，不重复论点，证据紧邻其支持的论点。
2. 句子检查： 明确主体和动作，使用具体的名词和动词，将相关词语放在一起，合理表达限定条件，并使用有信息量的强调。

不要压缩每个句子。当页面读起来像零散笔记时，要补回衔接内容。需要重塑较长段落时，应根据内容的实际结构选择段落、列表、标题或表格；格式不能替代推理。

如果要修改标点，先判断句子之间的关系，再更改标点。冒号用于兑现预期，分号用于平衡关系紧密且各自独立的分句，而连词或从句则应明确指出原本只能靠标点暗示的逻辑。代码、URL、时间、比例、引文、标签和配置中的字面标点必须保留。

完成标准： 读者首次阅读即可理解论述或步骤，同时不损失草稿的原意或节奏。

5. 恢复语气与具体性

使用 references/voice-and-rhythm.md 调整立场、节奏、句子推进方式，并修复朗读时不顺畅的地方。使用 references/style-bundles.md 根据示例或明确描述的特征校准语气，但不要模仿在世作家的标志性风格。

真实感来自判断、取舍、细节和立场，而非刻意制造的错别字、随意堆砌的俚语、装饰性的脏话、虚构的轶事或强行营造的随意感。

完成标准： 文本拥有鲜明的观点，句子节奏契合所表达的思想，作者最能体现其特色的细节也得以保留。

6. 在相关情况下诊断公式化语言

如果公式化语言确实造成了问题，应指出它掩盖了什么。不要引入缺乏依据的益处描述，也不要使用掩盖行为主体、机制、证据或后果的公式。普通用词、标点、礼貌表达和有意使用的修辞本身都不是问题。

对于人性化或明确要求处理公式化语言的情况，如果无法确定如何诊断，请查阅 references/ai-isms-and-humanisation.md；如果需要短语类别示例或例外情况，请查阅 references/formulaic-language-catalogue.md。不要仅仅因为正在编辑某个句子就同时加载这两份文件。

将目录中的处理级别视为取决于上下文的诊断提示，而非禁令：

• 删除没有实际作用的空洞套话和舞台指示
• 如果陈腐的语义框架掩盖了受支持的含义，即使只出现一次，也应根据该含义重写
• 结合上下文或成组情况，审视普通用词和结构信号
• 保留字面、技术、法律、测量、引用和作者自主使用的表达，包括有意运用的修辞和合理的体裁惯例

绝不要为了满足规避规则而替换同义词。这一原则适用于整个目录，而不仅是个别需要留意的词。Bridge the gap 不应换成 close the divide；应指出缺少了什么，以及采取什么行动能改变现状。Marks a significant shift 不应换成 signals a major transformation；应说明变化前后的情况。Plays a critical role、unlocks value 和 research shows 也同样需要有依据的行动、结果或来源。如果源文缺少必要实质内容，就删除、缩小或质疑该主张。

如果查找文件草稿中的重复模式有助于解决问题，可以选择运行：

python3 scripts/scan_aiisms.py path/to/draft.md

自动化处理时使用 --format json；仅在需要保守地检测多个模式形成的集群时使用 --gate。常规扫描本就会显示单个标记为删除、重写和审查的匹配项。应结合例外情况判断这些匹配项；扫描器无法判断某种用法是否准确、是否适合其体裁，或是否体现作者风格。应将破折号、润色过的句子或普通用词视为上下文，而非证据。

重写想法，而不只是替换被标记的词。保留方言、无障碍表达选择、第二语言风格、引用内容、字面术语和有意使用的修辞。

完成标准： 删除和重写规则均已处理或有意保留；仅需审查的模式集群已结合上下文作出判断；修订稿按照一般编辑标准读起来更好，而不只是更难被检测出来。

7. 调整交付内容

遵循目标体裁、受众、地区和风格指南。检查标题、列表、行动号召、示例和结尾形式。格式应与材料相称；不是每个段落都需要标题，也不是每个想法都需要列成项目。

对于文档和 Wiki 页面，如果相关方面有变更，请使用 references/technical-documentation-and-wikis.md 中相关的检查项。不要以 Google 特定偏好取代既有的地区规范或项目惯例。

完成标准： 成品符合目标用途，在不失去事实或个性特征的前提下，读起来像为该用途自然写成的内容。

8. 对照源文并停止

务必检查修改后的文字是否忠实于源文并符合所要求的格式。对于范围较广或风险较高的工作，请从 references/quality-gates.md 中选择相关检查项：

1. 忠实度
2. 逻辑与证据
3. 清晰度与节奏
4. 语气与人性化
5. 体裁与机制
6. 最终校对

将修订稿与源文及任何使用的记录表进行对照。如果依赖诊断结果，在可能使其失效的修改之后应重新检查；扫描并非普遍适用的完成条件。当剩余修改只是不同而非更好时，就应停止。

完成标准： 交付内容通过所有适用的检查关卡，受保护内容与源文一致，且不存在已知的关键问题。

输出约定

首先给出用户要求的成果或评审结论。除非用户要求提供编辑记录，否则简要说明处理过程。适用时，报告：

• 重要的结构选择
• 受保护的事实或字面内容
• 尚未解决的事实问题
• 对诊断信号有意采取的例外处理

不要声称某段文字由 AI 撰写。不要把风格偏好说成指责。

指引不足时

如果重要的用法、文档惯例或事实依据已过时，或与本指引冲突，请查阅适用的内部风格指南、当前的一手文档或可信的编辑参考资料。在用户授权的编辑范围内使用经过核实的指引；对于尚未解决的问题，应明确说明，而不是猜测。提出对规范技能源的修正方案，并附上来源和修改前后的示例或回归检查。日常编辑无需浏览，也不要悄悄修改已安装的技能副本。

快速参考

需求	阅读或运行
编辑简报、保留清单和编辑自由度	references/operating-contract.md
可选修订轮次与回退	references/revision-pass-stack.md
自然的结构、段落组织和长篇内容的易读性	references/natural-structure-and-digestibility.md
语法、清晰度和现代用法基准	references/foundations.md
节奏、立场和语气修订	references/voice-and-rhythm.md
破折号替换、分号与冒号的判断，以及句子流畅度修订	references/punctuation-and-sentence-flow.md
泛泛而谈、企业腔、程式化或浮夸的文字	references/genericity-and-stiffness.md
AI 式表达、人性化处理、误报和检测器使用	references/ai-isms-and-humanisation.md
依上下文规避的规则、表达类别、自然改写和受保护用法	references/formulaic-language-catalogue.md
文档、PR、规格说明、备忘录、报告、文章、电子邮件、UI 和文案	references/genre-modes.md
技术文档与 wiki 的标题、操作步骤、链接、无障碍性和维护	references/technical-documentation-and-wikis.md
个人语气指南和风格校准	references/style-bundles.md
验收标准和最终校对	references/quality-gates.md
研究依据与局限	references/research-notes.md
故障恢复	references/gotchas.md

模板

• templates/rewrite-worksheet.md 可用于记录复杂任务的编辑简报、保留清单、各轮修订结果和最终检查。
• templates/personal-style-sheet.md 可根据写作样本记录作者的真实习惯，以免在修订时将其磨平。

不可妥协的原则

1. 绝不通过改变事实来改善文风。
2. 没有证据时，绝不把不确定性改成确定性。
3. 绝不虚构个人经历、引文、引证、证据或客户用语。
4. 绝不模仿某位具名作者的标志性风格；应将请求转化为较高层次的风格特征。
5. 绝不把表达清单或检测器评分当作作者身份的证据。
6. 绝不为了让文字看起来在统计上更像“人类撰写”，而抹去方言、无障碍需求或第二语言使用者的语言特征。
7. 绝不只靠替换同义词来满足程式化语言规则。
8. 在适用的检查关卡通过，且剩余选项在品味上不分高下后，绝不继续编辑。
9. 绝不改动代码、标识符、选择器、配置键或其他机器可读结构；只修改范围内的自然语言文本。