关于 plain-language-design
用于撰写和审查易懂内容的技能,面向认知障碍、阅读能力有限或处于压力中的读者。它通过检查清晰度、术语、指令和句长来指导改写。
主要功能
- 01进行五秒理解测试
- 02识别并替换行业术语
- 03明确操作和指令
- 04检查句长与语态
- 05按可读性标准审查文本
适用场景
- 01改写指令以明确后续步骤
- 02审查界面标签和错误消息
- 03让专业或重要内容更易读
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ owl-listener/ inclusive-design-skills --skill plain-language-design安装后在 Claude Code 中输入/plain-language-design确认已加载。
详细介绍
通俗易懂的设计
撰写和评估内容时,要确保认知障碍者、读写能力较弱者、非母语者或承受较大压力的人能读一遍就理解。
通俗易懂的语言不是把内容写得浅显,而是写得清楚。它尊重读者的时间和认知资源。
测试
5 秒测试
有人能在 5 秒内读懂这句话吗? 如果不能,请改写。
行话测试
行业之外的人能理解每个词吗? 如果不能,请替换这个词,或在文中加以解释。
行动测试
对于任何说明或按钮,下一步是否完全明确? “保存并继续”比“下一步”更清楚。“删除此项”比“移除”更清楚。
被动语态测试
被动语态会隐藏执行动作的人。 “您的申请已被拒绝” → “我们无法批准您的申请。以下是您接下来可以采取的措施。”
句子长度测试
- 尽量将每句话控制在 15–20 个词以内
- 每句话只表达一个意思
- 每段只包含一条说明
常见替换
| 不要使用 | 改用 |
|---|---|
| 利用 | 使用 |
| 促成 | 帮助 |
| 实施 | 设置 / 开始 |
| 终止 | 结束 / 停止 |
| 在……之前 | 之前 |
| 为了 | 来 |
| 在此时 | 现在 |
| 如果发生……情况 | 如果 |
| 关于 | 关于 |
| 开始(正式说法) | 开始 |
| 充足 | 足够 |
| 后续 | 下一步 |
| 指示 | 显示 / 告知 |
| 修改 | 更改 |
可读性基准
- 面向大众:阅读难度为 6–8 年级
- 面向专业人士:解释术语,使用短句
- 重要内容(医疗、法律、金融):在完整文本旁附上通俗易懂的摘要
- 按钮、标签、错误消息:始终达到 4–6 年级的阅读难度
如何审核
- 大声朗读每段文字——读起来不顺的地方往往过于复杂
- 检查句子长度(统计词数,标出超过 25 个词的句子)
- 找出行话、缩写和习语
- 确认每条说明都指向清晰、单一的操作
- 检查错误消息是否说明:发生了什么 + 为什么 + 应该怎么做
输出格式
审核时:用表格列出标记出的文本、原文、问题和改写版本。撰写时:提供通俗易懂的内容,并注明达到的目标阅读难度。
评论
支持 Markdown