可读性Skill readability

---

name: 可读性 description: 该技能应用于编写或修订网页内容、产品文案、AI生成响应、文档或长篇文本，其中清晰度、可扫描性和理解性至关重要。

可读性

应用此技能将密集的文本转换为网页友好的内容，使人们能够快速扫描、理解和使用。

应用原则

基于NN/g的指导原则：

• references/nng-guidelines.md
• https://www.nngroup.com/articles/genai-write-for-the-web/
• https://www.nngroup.com/articles/formatting-long-form-content/
• https://www.nngroup.com/articles/legibility-readability-comprehension/

核心规则：

1. 保持文本简洁。
2. 结构设计用于扫描，而非论文式阅读。
3. 使用倒金字塔结构（答案先行，细节其次）。
4. 使用平实语言和短句。
5. 设计以促进理解，不仅仅是语法正确。

工作流程

1. 定义受众和任务。
2. 在重新格式化之前削减非必要内容。
3. 重写导语部分以前置关键信息。
4. 添加扫描辅助：
   • 描述性标题
   • 用于平行要点的项目符号
   • 对长内容的简要总结或关键要点
   • 仅在实际有助于扫描的地方使用选择性强调
5. 确认语言简洁性和句子级别的清晰度。
6. 运行可读性审计脚本并解决失败项。

审计脚本

使用捆绑脚本进行确定性检查：

ruby scripts/readability_audit.rb <file>

可选与基线分支比较：

ruby scripts/readability_audit.rb <file> --branch main

可选等级目标（默认为10）：

ruby scripts/readability_audit.rb <file> --target-grade 9

脚本报告：

• Flesch-Kincaid等级
• 句子和段落长度压力
• 对长内容的标题/列表密度
• 导语段落长度

将脚本视为护栏，而非人类判断的替代品。

输出期望

在面向用户的任务中使用此技能时：

1. 交付修订后的文本。
2. 简要总结结构性更改（例如：“添加了总结，拆分长段落，将密集部分转换为项目符号”）。
3. 指出未解决的权衡（品牌声音、法律约束、必需的行话）。