# Readability First Writing

> 可读性优先写作默认规则，约束 Agent 在说明、总结、文档撰写与内容改写时优先提升语言友好度、句式清晰度、解释层次与阅读引导，帮助读者更快抓住重点并顺畅读完。适用于技术解释、教程、README、研究总结、长回答与现有文稿优化场景。关键词：可读性、语言友好、读者视角、句式优化、破折号补充解释、结构引导、可读性优化。

- Skill: `qiao-925/readability-first-writing` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add qiao-925/readability-first-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qiao-925/readability-first-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: qiao-925 (https://skillmd.com/u/qiao-925)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qiao-925/readability-first-writing

---


# 可读性优先写作

> 很多内容的问题不在于“没有信息”，而在于“信息存在，但读者读不进去、抓不住、跟不上”。默认要求不是把文本写得花，而是把它写得更顺、更清楚、更容易理解。

## 核心原则

### 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` - 文档层面的阅读流优化：标题、段落、引导句、列表、表格、引用块与视觉克制