mcpField
A
accessibility-rules

accessibility-rules

github.com/community-access文档处理429243 次安装今天更新
代码仓库

关于 accessibility-rules

accessibility-rules 是面向文档无障碍检查的规则参考,覆盖 Word、Excel、PowerPoint、PDF 和 ePub。它按规则类型整理问题,并将文档规则对应到 WCAG 2.2 标准。

主要功能

  1. 01按文件格式与严重程度分类规则
  2. 02映射 WCAG 2.2 A 和 AA 标准
  3. 03说明错误、警告和提示级别
  4. 04提供置信度等级
  5. 05列出 Section 508 与 EN 301 549 对应关系

适用场景

  1. 01查找特定文档格式的无障碍规则
  2. 02将检查结果关联到 WCAG 条款
  3. 03区分需修复的问题与改进建议
  4. 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-accessibility9 条规则
DOCX-W*Word 警告word-accessibility6 条规则
DOCX-T*Word 提示word-accessibility3 条规则
XLSX-E*Excel 错误excel-accessibility8 条规则
XLSX-W*Excel 警告excel-accessibility5 条规则
XLSX-T*Excel 提示excel-accessibility3 条规则
PPTX-E*PowerPoint 错误powerpoint-accessibility7 条规则
PPTX-W*PowerPoint 警告powerpoint-accessibility6 条规则
PPTX-T*PowerPoint 提示powerpoint-accessibility4 条规则
PDFUA.*PDF/UA 一致性pdf-accessibility30 条规则
PDFBP.*PDF 最佳实践pdf-accessibility22 条规则
PDFQ.*PDF 质量/处理流程pdf-accessibility4 条规则
EPUB-E*ePub 错误epub-accessibility7 条规则
EPUB-W*ePub 警告epub-accessibility6 条规则
EPUB-T*ePub 提示epub-accessibility3 条规则

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