关于 accessibility-rules
accessibility-rules 是面向文档无障碍检查的规则参考,覆盖 Word、Excel、PowerPoint、PDF 和 ePub。它按规则类型整理问题,并将文档规则对应到 WCAG 2.2 标准。
主要功能
- 01按文件格式与严重程度分类规则
- 02映射 WCAG 2.2 A 和 AA 标准
- 03说明错误、警告和提示级别
- 04提供置信度等级
- 05列出 Section 508 与 EN 301 549 对应关系
适用场景
- 01查找特定文档格式的无障碍规则
- 02将检查结果关联到 WCAG 条款
- 03区分需修复的问题与改进建议
- 04核对 PDF/UA 合规相关规则
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ community-access/ accessibility-agents --skill accessibility-rules安装后在 Claude Code 中输入/accessibility-rules确认已加载。
详细介绍
文档无障碍规则参考
规则 ID 前缀
| 前缀 | 格式 | 子 Agent | 数量 |
|---|---|---|---|
| DOCX-E* | Word 错误 | word-accessibility | 9 条规则 |
| DOCX-W* | Word 警告 | word-accessibility | 6 条规则 |
| DOCX-T* | Word 提示 | word-accessibility | 3 条规则 |
| XLSX-E* | Excel 错误 | excel-accessibility | 8 条规则 |
| XLSX-W* | Excel 警告 | excel-accessibility | 5 条规则 |
| XLSX-T* | Excel 提示 | excel-accessibility | 3 条规则 |
| PPTX-E* | PowerPoint 错误 | powerpoint-accessibility | 7 条规则 |
| PPTX-W* | PowerPoint 警告 | powerpoint-accessibility | 6 条规则 |
| PPTX-T* | PowerPoint 提示 | powerpoint-accessibility | 4 条规则 |
| PDFUA.* | PDF/UA 一致性 | pdf-accessibility | 30 条规则 |
| PDFBP.* | PDF 最佳实践 | pdf-accessibility | 22 条规则 |
| PDFQ.* | PDF 质量/处理流程 | pdf-accessibility | 4 条规则 |
| EPUB-E* | ePub 错误 | epub-accessibility | 7 条规则 |
| EPUB-W* | ePub 警告 | epub-accessibility | 6 条规则 |
| EPUB-T* | ePub 提示 | epub-accessibility | 3 条规则 |
WCAG 2.2 成功标准映射
完整跟踪 WCAG 2.2 A 级和 AA 级的所有成功标准。具有文档专属规则的标准会列出规则 ID。需要人工判断的标准标注为“人工审核”。仅适用于 Web/应用场景的标准以破折号表示。有关各项标准的完整说明,请参阅 wcag-guide Agent。
注意: WCAG 2.2 移除了 4.1.1 解析(在现代用户代理中该标准“始终满足”,因此不再测试)。
A 级(必须修复)
| WCAG | 标准 | 相关规则 |
|---|---|---|
| 1.1.1 | 非文本内容 | DOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005 |
| 1.2.1 | 纯音频和纯视频(预录制) | 人工审核(嵌入式媒体) |
| 1.2.2 | 字幕(预录制) | 人工审核(嵌入式视频) |
| 1.2.3 | 音频描述或媒体替代内容(预录制) | 人工审核(嵌入式视频) |
| 1.3.1 | 信息和关系 | DOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS |
| 1.3.2 | 有意义的顺序 | PPTX-E006, PDFUA.READING_ORDER, EPUB-E006 |
| 1.3.3 | 感官特征 | 人工审核(所有格式) |
| 1.4.1 | 颜色的使用 | XLSX-E007,人工审核(其他格式) |
| 1.4.2 | 音频控制 | 人工审核(嵌入式音频) |
| 2.1.1 | 键盘 | PDFUA.FORMS(交互式 PDF) |
| 2.1.2 | 无键盘陷阱 | PDFUA.FORMS(交互式 PDF) |
| 2.1.4 | 字符键快捷键 | ---(仅适用于 Web/应用) |
| 2.2.1 | 可调整时间 | ---(仅适用于 Web/应用) |
| 2.2.2 | 暂停、停止、隐藏 | 人工审核(文档中的动画内容) |
| 2.3.1 | 三次闪烁或低于阈值 | 人工审核(动画内容) |
| 2.4.1 | 绕过区块 | PDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004 |
| 2.4.2 | 页面标题 | DOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001 |
| 2.4.3 | 焦点顺序 | PDFUA.FORMS(交互式 PDF) |
| 2.4.4 | 链接目的(在上下文中) | DOCX-E006, XLSX-E005, PPTX-E005 |
| 2.5.1 | 指针手势 | ---(仅适用于 Web/应用) |
| 2.5.2 | 指针取消 | ---(仅适用于 Web/应用) |
| 2.5.3 | 名称中的标签 | PDFUA.FORMS(交互式 PDF) |
| 2.5.4 | 动作触发 | ---(仅适用于 Web/应用) |
| 3.1.1 | 页面语言 | DOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003 |
| 3.2.1 | 获得焦点时 | ---(仅适用于 Web/应用) |
| 3.2.2 | 输入时 | ---(仅适用于 Web/应用) |
| 3.2.6 | 一致的帮助 | ---(仅适用于 Web/应用) |
| 3.3.1 | 错误识别 | PDFUA.FORMS(交互式 PDF) |
| 3.3.2 | 标签或说明 | PDFUA.FORMS(交互式 PDF) |
| 3.3.7 | 重复输入 | ---(仅适用于 Web/应用) |
| 4.1.2 | 名称、角色、值 | DOCX-E009, PDFUA.FORMS, PDFUA.TAGS |
AA 级(应修复)
| WCAG | 准则 | 相关规则 |
|---|---|---|
| 1.2.4 | 字幕(实时) | ---(仅适用于 Web/应用) |
| 1.2.5 | 音频描述(预录制) | 人工审查(嵌入式视频) |
| 1.3.4 | 屏幕方向 | ---(仅适用于 Web/移动设备) |
| 1.3.5 | 识别输入目的 | PDFUA.FORMS(交互式 PDF) |
| 1.4.3 | 对比度(最低) | 人工审查(Office 格式)、PDFBP.Contrast |
| 1.4.4 | 调整文本大小 | 人工审查(PDF 重排) |
| 1.4.5 | 文本图像 | PDFBP.IMG_TEXT |
| 1.4.10 | 重排 | 人工审查(PDF 重排) |
| 1.4.11 | 非文本对比度 | 人工审查(所有格式) |
| 1.4.12 | 文本间距 | 人工审查(PDF 文本间距) |
| 1.4.13 | 悬停或聚焦时显示的内容 | ---(仅适用于 Web/应用) |
| 2.4.5 | 多种方式 | 人工审查(多页文档) |
| 2.4.6 | 标题和标签 | DOCX-E003、DOCX-E007、PDFUA.HEADINGS |
| 2.4.7 | 焦点可见 | PDFUA.FORMS(交互式 PDF) |
| 2.4.11 | 焦点未被遮挡(最低) | ---(仅适用于 Web/应用) |
| 2.5.7 | 拖动操作 | ---(仅适用于 Web/应用) |
| 2.5.8 | 目标尺寸(最低) | 人工审查(交互式 PDF) |
| 3.1.2 | 部分内容的语言 | 人工审查(Office 格式)、PDFUA.LANG_PARTS |
| 3.2.3 | 一致的导航 | ---(仅适用于 Web/应用) |
| 3.2.4 | 一致的识别 | ---(仅适用于 Web/应用) |
| 3.3.3 | 错误建议 | PDFUA.FORMS(交互式 PDF) |
| 3.3.4 | 错误预防(法律、财务、数据) | PDFUA.FORMS(交互式 PDF) |
| 3.3.8 | 无障碍身份验证(最低) | ---(仅适用于 Web/应用) |
| 4.1.3 | 状态消息 | ---(仅适用于 Web/应用) |
严重程度定义
| 严重程度 | 含义 | 对辅助技术用户的影响 |
|---|---|---|
| 错误 | 阻碍访问 | 使用辅助技术无法访问或使用内容 |
| 警告 | 降低体验 | 内容可以访问,但体验不佳或令人困惑 |
| 提示 | 最佳实践 | 内容可以正常使用,但可以改进,以提升辅助技术体验 |
置信度等级
| 等级 | 权重 | 含义 |
|---|---|---|
| 高 | 1.0 | 子 Agent 确定这是一个真实问题 |
| 中 | 0.7 | 可能存在问题,但需要人工判断 |
| 低 | 0.3 | 可能存在问题,已标记以供审查 |
合规标准
| 标准 | 适用范围 | 主要规则 |
|---|---|---|
| WCAG 2.2 A 级 | 国际 | 所有错误级规则 |
| WCAG 2.2 AA 级 | 国际 | 所有错误级和警告级规则 |
| Section 508 | 美国联邦 | 对应 WCAG 2.0 AA 级 |
| EN 301 549 | 欧盟 | 对应 WCAG 2.1 AA 级 |
| PDF/UA (ISO 14289) | 仅适用于 PDF | 所有 PDFUA.* 规则 |
评论
支持 Markdown