关于 readable-content
面向内容设计者和写作者的可读性设计技能，提供信息排序、分块和易读写作原则，帮助读者快速浏览并理解内容。
主要功能
- 01重要信息优先呈现
- 02按主题和段落拆分内容
- 03使用标题和列表便于浏览
- 04采用简短、具体的句子
- 05为说明、错误和数据内容提供专门建议
适用场景
- 01重组长篇说明内容
- 02为网页内容设计可浏览的结构
- 03撰写清晰的操作步骤和错误提示
- 04让数据说明更易理解
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/readable-content确认已加载。
详细介绍
易读内容设计
组织和撰写内容，让不同阅读能力、注意力跨度和认知风格的人都能找到所需信息并理解内容。
核心原则
人们不会逐字阅读，而是快速浏览。应优先为快速浏览设计内容，再考虑细读。
内容结构
倒金字塔结构
把最重要的信息放在前面。假设读者随时可能停止阅读。
- 第 1 段：核心信息或答案
- 第 2 段：必要的支持细节
- 第 3 段及之后：背景、上下文和细节
分块
- 每个章节只讲一个主题
- 每个段落只讲一个观点
- 每个段落最多 3–4 句话
- 每个章节最多写 5–7 个段落，然后添加新标题
- 每隔 2–3 个段落添加标题，打破大段文字
便于浏览的元素
- 用描述性标题概括章节内容
- 适量使用粗体突出关键词（如果所有内容都加粗，就没有重点了）
- 用项目符号列出 3 项及以上的相关内容（每个列表最多 7 项）
- 用表格呈现对比信息
- 用醒目提示框或标注框突出关键信息
提高易读性
句子层面
- 每句话尽量控制在 15–20 个词
- 每句话只表达一个观点
- 使用主动语态：“我们会寄出您的订单”，而不是“您的订单将被寄出”
- 使用具体表述：“3 个工作日内”，而不是“很快”
- 直接对读者说：“您可以……”，而不是“用户可以……”
词语层面
- 选用含义明确的最简单词语
- 首次使用专业术语时进行定义
- 首次使用缩略词时写出全称：“Web 内容无障碍指南 (WCAG)”
- 避免习语、隐喻和特定文化背景的说法
- 避免双重否定：“您可以继续”，而不是“您不能不继续”
段落层面
- 首句先说明要点（把重点放在开头）
- 后续句子用于补充说明或提供依据
- 每个段落都应能独立理解，不要求读者先读上一段
- 使用过渡词让行文更流畅：“不过”“例如”“这意味着”
有特定要求的内容类型
操作说明和教程
- 按顺序执行的任务使用编号步骤
- 每个步骤只包含一个操作
- 每个步骤都以动词开头：“点击”“输入”“选择”
- 说明每个步骤完成后用户应看到的内容
政策、条款和法律内容
- 在开头提供通俗易懂的摘要
- 在下方提供完整内容，供有需要的读者查看
- 在上下文中解释所有法律术语
- 用示例说明抽象概念
错误和警告内容
- 具体说明发生了什么
- 说明这对用户意味着什么
- 说明接下来该怎么做（只给出一个明确操作）
- 始终将阅读难度控制在小学四至六年级水平
数据和数字
- 无需精确时对数字取整（例如“约 200 万”，而不是“1,987,453”）
- 补充背景说明：“40%——将近一半”
- 复杂数据应使用图表，并附上文字摘要
- 不要假设读者擅长理解数字，要解释数字的含义
评估问题
- 最重要的信息是否放在最前面？
- 只浏览标题和粗体文字的人能否了解核心信息？
- 句子平均长度是否少于 20 个词？
- 每个段落是否都少于 4 句话？
- 阅读水平为八年级的人能否理解内容？
评论
支持 Markdown