Community写作与编辑github.com

n0ctx/reader-first-writing

在撰写或修改任何需要人类阅读的文本(文章、邮件、通知、解释、报告、营销文案、社交媒体帖子、聊天回复)或审查此类文本时使用。涵盖任何语言中句子级别的可读性,不涉及排版,也不涉及为了绕过AI检测而“人性化”文本。

reader-first-writing 是什么?

Reader-First Writing 是一个AI智能体技能,旨在优化任何面向人类读者的文本的句子级别可读性。与试图通过添加人为错误来绕过AI检测器的“AI人性化工具”不同,该技能专注于消除LLM常见的写作习惯,这些习惯会增加读者的认知负担:比如用无生命物体拟人化(“设计在消耗用户耐心”)、拉宽主语和谓语之间的距离、堆砌名词短语(“用户账户安全风险评估流程”),以及生造动词或短语。该技能提供了一套可操作的原则——保持主语和动词靠近、使用读者熟悉的表达、优先传达重要信息——并包含一个修订工作流,逐段检查文本,用最平实的语言重述复杂句子,但保留必要的技术术语和富有表现力的修辞。它适用于中文和英文等多种语言中的文章、邮件、营销文案和报告,但不适用于代码、AI提示,或任何旨在欺骗AI检测的修改。其核心测试标准是:读者理解句子的努力是否值得;如果可以用更简洁的表达传递相同含义,则应采用更简洁的形式。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/n0ctx/skills/tree/HEAD/skills/reader-first-writing

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

读者优先写作

你是在为人类读者写作。读者没有你的上下文,在阅读每个句子时,会将其保存在工作记忆中。每当一个句子迫使他们回头寻找主语、解开一串名词链,或补充你省略的连接词时,理解就会变得更加困难。LLM的写作有一些习惯性倾向,恰好会引发这些问题:无生命事物执行人类动作、主语和动词之间间隔过长、省略了本可保留的词汇、堆砌名词,以及生造动词和短语。这些做法都不会丢失信息,但它们将解码的工作转移给了读者。在起草和修改时,应纠正这些倾向。

这不是一个“AI人性化工具”。那些工具通过改变表面措辞来绕过检测器;这个技能只关心读者是否能理解。刻意加入不规则用法或填充词以显得更“像人”并非目标。

范围

任何面向人类读者的文本,无论体裁或语言,包括对其他人员或其他模型所写文本的审查。不适用于代码、为AI撰写的提示,或仅为通过AI检测而进行的重写。如果用户或项目已有风格指南,则以风格指南为准;本技能仅涵盖句子级别的可读性。

基础测试

理解一个句子需要读者付出努力,而这份努力必须有所回报。如果同一个含义有更平实的表达方式,而你却选择了更难的表达,那么读者的努力就被浪费了:应当修改。如果一个表达方式能提供平实版本所无法给予的东西——比如令人难忘的节奏、精确的意象或必要的技术术语——那么它就不等同于同一种含义,且可以保留,前提是你能说清它的回报是什么。

以下是LLM写作最常未能通过此测试的七条原则。

原则

  1. 将人类动作留给人类。 当主语是物体、概念或过程时,赋予它一个它确实能执行的动词。例如:“The redesign is quietly eating away at long-time users' patience”应改为“Since the redesign, many long-time users find the product harder to use.”(“改版正在悄悄消耗老用户的耐心” → “改版后,许多老用户觉得产品更难用了。”)普通的无生命主语是没问题的:“销售额同比增长20%”、“新规定下月生效”。需要修改的是随意的拟人化,那些会“吞噬”、“咬合”、“推动”、“期待”或“说话”的事物,因为读者必须将比喻翻译回实际情况。

  2. 保持主语和动词靠近。 插入主语和动词之间的长从句迫使读者在动词出现前一直记住主语;请拆分句子。在中文这类将修饰语置于名词之前的语言中,常见的问题是名词前过长的修饰链,导致读者直到句末才知道句子在说什么;当修饰语超过一个短语时,应将其另起一句,或移至名词之后。

  3. 保留那些帮助读者预测的词语。 保留连接词(因为、所以、但是、也)、在某些语言中本可省略的主语,以及明确的指代关系(使用“这笔付款”而非模糊的“它”)。省略它们能节省几个词,但会让读者推断句子之间的关系。在英文中,保留关系从句中及“say”或“think”等动词后本可省略的“that”。这并不意味着添加诸如“实际上”或“基本上”之类的填充词;填充词无助于读者理解句子如何连接。

  4. 名词堆砌不超过两个。 例如:“用户账户安全风险评估流程” → “评估用户账户安全风险的流程”。用介词、所有格或动词来断开名词串。

  5. 使用已有的动词。 不要临时将名词用作动词(“calendar it” → “把它放进日历”)。避免像“对齐”、“杠杆”、“操作化”、“行动”这类行话动词及其在其他语言中的等价物;要指明实际的动作:确认什么内容、与谁确认、写下什么东西。

  6. 使用读者见过的短语。 不要生造诸如“读者耐心预算”或“信息密度护城河”这类短语。如果一个概念确实需要新术语,在首次出现时用一句话解释清楚。

  7. 把分量给到重要的东西。 以读者最需要知道的内容开头,压缩或删减次要材料。当每个要点占用相同篇幅时,读者无法判断哪个最重要。平行结构、对比以及不增加信息的形容词或副词堆砌,会使读者费力地从修辞中挖掘内容:请删除它们。

修订

逐段修订,而非基于整体印象。对于每个读起来费力的句子,尝试用你能想到的最平实的词语重述相同含义。如果能够做到,并且没有损失任何信息,就使用平实的版本。如果做不到,说明内容本身就很复杂:保留其含义,同时通过拆解句子和添加连接词来帮助读者理解。修订改变的是表达方式,而非所陈述的事实:请勿添加原文中不包含的信息。

以下是修订方向和规模的示例:

原文:This release comprehensively empowers an upgraded user data sync experience, systematically resolving the cross-device content loss pain point, and going forward we will continue to consolidate user feedback and align on optimization directions.

译文:本次更新全面赋能升级的用户数据同步体验,系统性地解决了跨设备内容丢失的痛点,并且未来我们将继续整合用户反馈并在优化方向上对齐。

修订:This update improves data sync and fixes the bug that lost content when switching between devices. We will keep collecting feedback and use it to decide what to improve next.

修订译文:此更新改进了数据同步,并修复了在设备间切换时丢失内容的错误。我们将持续收集反馈,并以此来决定下一步的改进方向。

修订去掉了“赋能”、“整合”和“对齐”;拆解了“用户数据同步体验”和“跨设备内容丢失痛点”等名词堆砌;将抽象施动者“本次发布赋能”替换为“此更新”和“我们”;并将一个长句拆分,使每个句子只陈述一件事。

交付前检查

逐段检查文本。对于以下每个“是”,运用基础测试来决定是否修改:

  • 是否有物体或概念在执行人类动作?
  • 名词前是否有多于一个短语的修饰语,或主语与动词之间是否有长从句?
  • 是否省略了连接词、主语或指代关系?
  • 是否堆砌了三个或更多的名词?
  • 是否存在名词用作动词、行话动词,或读者从未见过的生造短语?
  • 读者最需要知道的信息是否位于开头附近?
  • 是否存在不增加信息的平行结构、对比或修饰语堆砌?

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能