mcpField
A
accessibility-testing

accessibility-testing

github.com/kreerc测试与质量3459 次安装25 周前更新
代码仓库

关于 accessibility-testing

accessibility-testing 是面向开发者的 Web 无障碍评估与实施技能,结合自动化检查、组件级 WCAG 2.2 AAA 审查、问题修复记录,以及无障碍信息页面发布指南。

主要功能

  1. 01使用 pa11y 和 axe-core 自动检查
  2. 02组件级 WCAG 2.2 AAA 审查
  3. 03表格记录各项标准状态
  4. 04整理问题与建议修复方案
  5. 05无障碍信息页面编写指南

适用场景

  1. 01将无障碍检查加入 CI 流水线
  2. 02按 WCAG 标准评估组件
  3. 03记录无障碍问题与修复方案
  4. 04起草公开的无障碍信息页面

安装

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

$npx skills add https://github.com/kreerc/accessibility.md --skill accessibility-testing

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

详细介绍

正确实现无障碍功能,对于为所有人(包括开发者)提供优质 Web 体验至关重要。

软件要求与程序化测试

要快速、可靠地发现无障碍缺陷,请使用自动化和基于规则的无障碍检查。为此,请将 pa11y/pa11y CLI 工具和 axe-core runner 设为开发环境的必需工具,并使用它们检查新构建的开发版本。此外,还要单独检查各项功能和组件,不受页面其他部分的影响。

将这些检查工具纳入现有的 CI 流水线。

手动检查

针对每个组件,检查其是否完全符合 WCAG 2.2 AAA 级要求,并创建一张表格,其中包含成功标准编号、名称、简短说明和符合状态(通过、失败、不适用、未测试)。

如有帮助,也可以将其制作为模板并重复使用。

你可以使用基于浏览器的工具(例如 Playwright)自行运行以往需要真实用户参与的检查。如果无法作出判断,或判断可能不可靠,请添加一条 todo,并为开发者提供清晰简洁的评估说明。

生成交付成果

每当你进行无障碍评估或判断时,都要撰写一份简短报告,列出所有记录的问题及建议的修复方案。如果彻底的架构改造才是更好且正确的选择,切勿建议快速修补或简化方案。尤其是快速修补方案涉及 ARIA 模式时。

无障碍信息(《欧洲无障碍法案》要求)

根据欧盟法律及当地等效法规(例如德国的《无障碍强化法案》/BFSG),项目必须提供面向公众的页面,介绍该页面的无障碍情况,并以通俗语言包含以下内容:

  • 服务名称
  • 服务的总体说明
  • 服务提供方的电子邮件地址和电话号码,以及可提供的实体地址
  • 适用法律的名称
  • 对所用无障碍保障工具和流程的说明,以及参与评估的任何 Agent 的名称
  • 各项标准的无障碍情况详情,使用通俗语言说明(通过、失败、不适用)
  • 主管机构的联系方式(例如在德国,为德国各州产品与服务无障碍监督机构 MLBF AöR,马格德堡)
  • 上次评估的日期
  • 所有未通过要求的修复期限

法律还要求开发者主动向主管机构申报其提供的服务。请起草一封邮件,并查找相关电子邮件地址。

此页面必须在每个页面上均可访问,并放在隐私政策等其他法规相关链接附近。

无论该服务是否直接受该法律约束,都必须实现此页面。

评论

支持 Markdown