qiao-925 可读性优先写作
很多内容的问题不在于“没有信息”，而在于“信息存在，但读者读不进去、抓不住、跟不上”。默认要求不是把文本写得花，而是把它写得更顺、更清楚、更容易理解。
核心原则
1. 读者理解优先于作者倾倒
- 写作首先服务读者接收，而不是作者把脑内内容一次性倒完。
- 读者最先需要的是主结论、主问题和主线，而不是完整的铺垫过程。
- 如果一句话让人读完仍不清楚它想表达什么，这句话就还没有写好。
2. 自然亲和优先于表演式轻松
- 可读性不等于玩梗、卖萌、堆 emoji 或强行幽默。
- 真正稳定的可读性来自清楚的句子、顺畅的节奏、恰当的解释和明确的结构引导。
- 幽默、比喻、轻松语气可以用，但默认只作为调味，不应喧宾夺主。
3. 句子要有主干，段落只承载一个小中心
- 一句话尽量只完成一个主要动作或判断。
- 一段尽量围绕一个小中心展开，不把多个平级重点塞进同一段。
- 如果一个句子需要读两遍才能找出主语、结论或重点，通常应该拆开或重写。
4. 解释要就地发生，不让读者来回跳
- 能在当前句子中补清的解释，尽量就地补清。
- 破折号、冒号、短括注、补充短句都可以作为“即时解释工具”。
- 目标是降低读者回看成本，而不是制造更花哨的句法。
5. 结构引导要显性，不靠读者自行猜路
- 长内容默认需要显式路标：标题、分段、引导句、顺序词、对比词。
- 读者应能看出：现在在讲什么，为什么讲这一段，接下来会去哪里。
- 如果结构要靠读者自己推断，可读性通常已经下降。
6. 可读性提升不能损伤准确性
- 优化语言时，不得把边界、前提、风险和限定一起磨平。
- 写得顺，不代表可以牺牲精度。
- 真正好的可读性，是“更容易懂”，而不是“更像营销文案”。
AI Agent 行为要求
默认执行方式
- 先判断当前任务是“直接写”“重写优化”还是“已有文本润色”。
- 优先检查：主结论是否前置、句子是否有主干、段落是否单焦点、结构是否有路标。
- 优先通过拆句、改序、补充即时解释、增强段落引导来提升可读性。
- 如果内容本身已清楚，不要为了“显得优化过”而强行改花。
- 如果用户要的是专业表达，应优先做清晰化，而不是自动做轻松化。
关键场景要求
| 场景 | 最低要求 | 不该做什么 |
|---|---|---|
| 技术解释 | 先说结论或核心机制，再补解释 | 先铺很多背景，最后才落到关键点 |
| README / 教程 | 标题、分段、引导句清楚，读者能顺着读下去 | 信息都对，但像墙一样堆在那里 |
| 长回答 / 长文档 | 开头先给高密度概括，交代核心结论、主线和阅读地图，正文再展开 | 一上来铺大量背景或过程，读者读到中后部才知道重点 |
| 文稿润色 | 明确哪些句子该拆、哪些解释该补、哪些段落该重排 | 只改几个词，结构问题原封不动 |
| 风格友好化 | 在不伤准确性的前提下让语言更自然、更亲和 | 强行玩梗、强行卖萌、强行加视觉装饰 |
对外表达要求
- 主结论、主判断或主动作尽量前置。
- 面对长文档时，开头优先给一个高信号概括，让读者先知道“这篇内容在定义什么、主张什么、怎么组织、接下来怎么展开”。
- 优先使用短句和中短段，而不是连续的长句与大段。
- 需要补充说明时，可用破折号做即时解释，但不要一句连续套多个破折号。
- 使用列表、表格、引用块时，应服务扫描效率，而不是为了形式丰富。
- 如果用户没有明确要求，不默认注入大量 emoji、网络梗或夸张语气。
与其他 skill 的协同边界
- 与
value-dense-delivery：后者负责决定“保留什么、删除什么、如何收敛价值”；本规则负责“这些内容如何说得更顺、更易读”。 - 与
knowledge-synthesis：后者负责把资料组织成主线和洞察；本规则负责把主线写得更清楚、更好读。 - 与
technical-readme-structure：后者负责 README 应有什么结构；本规则负责这些结构如何写得更容易读懂。 - 与
critical-thinking-evaluation：后者负责判断是否站得住；本规则负责把这些判断表达得更易理解，但不替代判断本身。
场景化展开
- 涉及句子层面的拆句、改序、补充说明、破折号用法时，读取
references/sentence-clarity-patterns.md - 涉及长文档开头概括、段落组织、标题引导、列表/表格/引用块使用与整体阅读节奏时，读取
references/document-flow-patterns.md
判断标准
- 读者是否能在开头较快抓到这段内容最重要的点。
- 长文档开头是否先交代了核心结论、主线和阅读路径，而不是把重点埋到后文。
- 句子是否存在清楚主干，而不是层层包裹。
- 段落是否单焦点，且段与段之间有清晰过渡。
- 解释是否尽量就地完成，而不是让读者频繁回跳。
- 格式元素是否真的提升了扫描效率，而不是增加噪音。
- 优化后是否仍保留关键限定、边界和准确性。
反模式
- 把可读性理解成“越轻松越好”。
- 为了显得有趣，牺牲准确性或专业边界。
- 一个句子承载多个平级判断，导致主干消失。
- 明明需要解释，却把关键说明埋在后文或注脚。
- 用大量 emoji、引用块、分隔线和修辞元素制造假层次。
- 只改词汇表面，不处理结构与节奏问题。
参考资料
references/sentence-clarity-patterns.md- 句子层面的清晰化模式：拆句、改序、补充解释、破折号、冒号与节奏控制references/document-flow-patterns.md- 文档层面的阅读流优化：标题、段落、引导句、列表、表格、引用块与视觉克制