plain-language

Name: plain-language
Author: mgifford

github.com/mgifford设计与 UI57174 次安装6 周前更新

代码仓库

关于 plain-language

plain-language 是用于编写、编辑和审查网页内容的无障碍技能，面向内容创作者及审校者。它提供结构、措辞、可读性和辅助技术检查方面的指导。

主要功能

01按读者需求组织页面结构
02缩短句子并使用主动语态
03优先使用常见词语并解释术语
04检查标题、列表和缩写
05提供可读性与辅助技术测试清单

适用场景

01改写面向公众的网页文案
02审查内容是否易于理解
03检查页面是否适合屏幕阅读器和朗读工具

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mgifford/accessibility-skills --skill plain-language

安装后在 Claude Code 中输入/plain-language确认已加载。

附带文件README.mdSYNC.md

详细介绍

简明语言无障碍技能

权威来源：mgifford/ACCESSIBILITY.md 中的 examples/PLAIN_LANGUAGE_ACCESSIBILITY_BEST_PRACTICES.md 此技能源自该文件。如有疑问，以示例为准。

撰写、编辑或审核网页内容时，请遵循以下规则。 仅当项目涉及内容创作或编辑时，才加载此技能。

此技能与 content-design/SKILL.md 相辅相成——处理内容工作时，请同时加载两者。简明语言是更深入的实现方式；内容设计则是结构模式。

核心要求

简明语言意味着以这样的方式写作：让人们首次阅读时就能找到所需内容、理解内容并采取行动。它不是把内容写得浅显——而是尊重读者的时间，消除不必要的障碍。

简明语言是以下用户的首要无障碍策略：

有认知障碍、学习障碍和智力障碍的用户
读写能力较弱或页面语言不是其第一语言的用户
承受压力、疲惫或处于危机中的用户
通过屏幕阅读器访问内容的用户，因为重新收听会很慢
使用阅读模式或文本转语音访问内容的用户，因为复杂句式会难以理解

WCAG 3.1.5 阅读水平（AAA）建议面向一般受众的内容达到 8 年级或以下的阅读水平。简明语言也是 Opquast 的要求（规则 5、7），并符合《Web 可持续性指南》——精简的内容可以减少数据传输量和阅读时间。

严重程度分级（本技能）

级别	含义
严重	目标受众完全无法理解内容；无法遵循必要的说明
较高	密集的行话或复杂的句子结构，为有认知障碍的用户造成了显著障碍
中等	阅读水平高于 8 年级；缩写未展开；以被动语态为主
较低	可以缩短或澄清内容，但不会造成障碍

辅助技术背景

简明语言对不同辅助技术（AT）的作用各不相同：

AT	简明语言的帮助
屏幕阅读器（NVDA、JAWS、VoiceOver）	短句可降低重复收听时的认知负担；标题层级有助于导航
阅读模式（Firefox/Edge/Safari）	会移除视觉层级——简明的语言结构必须单独承载含义
Edge 朗读 / TalkBack TTS	含多个从句的长句，在听取时更难理解
语音控制	清晰、简短的标题和标签更容易作为导航目标说出
屏幕放大	用户一次只能看到一小部分内容——将关键信息前置可减少滚动
认知无障碍工具（如 Helperbird、Recite Me）	这些工具会重新排版内容；简单结构比复杂结构更容易重新排版

首要原则：先组织结构，再写正文

简明语言始于结构。结构良好但文笔一般的页面，比文笔优美但结构不佳的页面更具无障碍性。

每页一个主题；每段一个观点

✗ This page covers our history, our services, our pricing, and how to contact us.

✓ Separate pages for: About us / Services / Pricing / Contact

将关键信息前置

先给出结论，再提供证据。读者不应该必须读到段落末尾，才能明白段落的主题。

✗ After reviewing several options and consulting with our legal team, we have
  decided that applications submitted after 31 March will not be accepted.

✓ Applications close 31 March. We will not accept late submissions.

倒金字塔结构：最重要的信息 → 补充细节 → 背景信息

这种结构适用于通过标题导航的屏幕阅读器用户、搜索引擎用户，以及需要立即获得答案的危机中的用户。

严重：句子和段落长度

对于有认知障碍、阅读障碍或读写能力较弱的用户来说，长句和长段落是严重的障碍。

句子：

大多数句子尽量不超过 15–20 个词
每个句子只包含一个主句；将从句单独成句
尽可能删去保留或限定性表述：“需要指出的是” → 删除

段落：

一般网页内容的每个段落最多 3–5 个句子
每个段落只表达一个主要观点
段落之间使用空行（不要只用缩进）

✗ Due to the fact that the application process requires a significant amount
  of documentation to be submitted in advance of the deadline, which is
  31 March for this financial year, applicants who have not yet gathered
  their supporting materials should begin doing so immediately.

✓ The application deadline is 31 March.
  Gather your supporting documents now — the process takes time.
  See the checklist below for what you need.

严重：主动语态

被动语态会隐藏动作执行者，增加认知负担。 除非有意为之，否则请使用主动语态。

✗ Decisions will be made by the committee.
✗ Applications must be submitted before the deadline.
✗ Your account may be suspended if payment is not received.

✓ The committee will decide.
✓ Submit your application before the deadline.
✓ We will suspend your account if we do not receive payment.

有意使用被动语态的情况：

确实不知道动作执行者：“三人受伤。”
动作执行者无关紧要：“该表单于 2019 年设计。”
想弱化负面表述：“有人犯了错误。”（少用，并谨慎使用）

严重：朴素用词

使用读者已经熟悉的词语。面向专家时可以使用专业术语；面向普通受众时，应使用通俗易懂的说法。

不要用	改用
utilise	use
commence	start
endeavour	try
prior to	before
in the event that	if
at this point in time	now
facilitate	help
demonstrate	show
subsequently	then / after
approximately	about

特定领域术语（法律、医疗、技术）：首次出现时在正文中解释；除非受众是专家，否则不要另设术语表。


<p>Your <abbr title="General Data Protection Regulation">GDPR</abbr> rights
   allow you to request a copy of your personal data.</p>


<p>To exercise your GDPR rights, contact our data protection team.</p>

中度：阅读水平

面向公众的内容应以八年级或以下（Flesch-Kincaid）为目标。高于十年级属于中度问题；面向公众的内容高于十二年级则属于严重问题。

用于检查阅读水平的工具：

Hemingway Editor — 标出复杂句、被动语态和年级水平
retext-readability — 可集成到 CI 的可读性检查工具
Microsoft Word 内置的 Flesch-Kincaid 评分（审阅 → 检查辅助功能）

年级水平只是参考，并非绝对标准。法律或法规文本可能需要精确表述，因此阅读水平会更高；请说明这一点，并在正式文本旁提供通俗易懂的摘要。

中度：缩写和首字母缩略词

未展开说明的缩写是中度障碍——屏幕阅读器可能会误读；新读者也可能不认识它们。

**规则：**每个页面首次出现时都要展开说明（不只是整个网站的第一页）。

<p>The <abbr title="Web Content Accessibility Guidelines">WCAG</abbr> are
   published by the W3C. WCAG version 2.2 is the current standard.</p>

<abbr title="..."> 可向辅助技术（AT）和使用鼠标悬停的视力正常用户提供展开说明。屏幕阅读器对 <abbr> 的支持并不一致——有些辅助技术会读出 title 属性中的展开说明，但有些不会。无论是否使用 <abbr>，首次出现时都要在正文中写出完整展开说明。

中度：列表与行文

有三个或更多并列项目时，请使用列表。在行文中嵌入列表会掩盖结构，增加认知负担。

✗ You will need to provide your full name, date of birth, current address,
  email address, and a copy of your identification document.

✓ You will need:
  • Full name
  • Date of birth
  • Current address
  • Email address
  • A copy of your identification document

无序列表使用 <ul>；有顺序要求的步骤或序列使用 <ol>。

中度：说明和步骤

为步骤编号。先写操作，再写背景信息（不要反过来）。

✗ After logging in, which you can do from the homepage, click the Settings
  icon in the top-right corner of the screen, then select Account.

✓ To update your account:
  1. Log in at [homepage link].
  2. Click Settings (top-right corner).
  3. Select Account.

轻度：语气和包容性语言

称呼读者时使用“你”；称呼自己的组织时使用“我们”
始终使用性别中立的语言：“他们”可作单数，语法上受到认可且广泛接受；避免使用“他或她”
避免使用歧视残障人士的表达：不要把残障当作比喻（如“视而不见”“对他们的关切充耳不闻”“孤立无援”）
避免使用可能难以翻译的文化特定习语：“大概的数字”“做不可能完成的事”“一上来就全力以赴”

次要事项：页面标题和标题

页面 <title> 必须标明页面和网站：“关于我们 | Acme Corp”
每个页面只能有一个 <h1>；内容必须与 <title> 相同或高度相关
标题必须清晰具体——单独写“简介”不够具体；“浅白语言原则简介”则足够具体
不要用标题来实现视觉样式；应改用 CSS 类

测试清单

发布前请运行以下检查：

可读性评分： 面向一般读者的内容，Flesch-Kincaid 年级为 8 级或以下
句子检查： 除非有充分理由，否则句子不得超过 25 个词
被动语态检查： Hemingway Editor 会用绿色标出被动语态
缩写检查： 每个缩写都必须在首次出现时展开说明
浅白用词检查： 将上方“不要使用”表格中的所有词语替换掉
阅读模式测试： 在 Firefox 或 Safari 的阅读模式中打开——没有 CSS 时内容是否仍有意义？标题是否正确？内容顺序是否合理？
朗读测试： 使用 Edge 朗读或 macOS VoiceOver——令人困惑的句子读出来时会明显不通顺

完成标准清单

WCAG 关键标准

3.1.1 页面语言（A）——在 <html> 上设置 lang 属性
3.1.2 部分内容的语言（AA）——在使用其他语言的元素上设置 lang
3.1.5 阅读水平（AAA）——面向一般读者的目标为 8 年级或以下
1.3.1 信息和关系（A）——标题层级、列表标记
2.4.2 页面标题（A）——描述性页面标题

参考资料

标准展望： WCAG 3.0 正在制定中。浅白语言要求预计会增加，而非减少，尤其是在认知无障碍方面。请关注：https://www.w3.org/TR/wcag-3.0/

支持 Markdown

登录后评论