mcpField
P
plain-language-design

plain-language-design

github.com/owl-listener设计与 UI10898 次安装20 周前更新
代码仓库

关于 plain-language-design

用于撰写和审查易懂内容的技能,面向认知障碍、阅读能力有限或处于压力中的读者。它通过检查清晰度、术语、指令和句长来指导改写。

主要功能

  1. 01进行五秒理解测试
  2. 02识别并替换行业术语
  3. 03明确操作和指令
  4. 04检查句长与语态
  5. 05按可读性标准审查文本

适用场景

  1. 01改写指令以明确后续步骤
  2. 02审查界面标签和错误消息
  3. 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 年级的阅读难度

如何审核

  1. 大声朗读每段文字——读起来不顺的地方往往过于复杂
  2. 检查句子长度(统计词数,标出超过 25 个词的句子)
  3. 找出行话、缩写和习语
  4. 确认每条说明都指向清晰、单一的操作
  5. 检查错误消息是否说明:发生了什么 + 为什么 + 应该怎么做

输出格式

审核时:用表格列出标记出的文本、原文、问题和改写版本。撰写时:提供通俗易懂的内容,并注明达到的目标阅读难度。

评论

支持 Markdown