关于 accessibility-testing
accessibility-testing 是面向开发者的 Web 无障碍评估与实施技能,结合自动化检查、组件级 WCAG 2.2 AAA 审查、问题修复记录,以及无障碍信息页面发布指南。
主要功能
- 01使用 pa11y 和 axe-core 自动检查
- 02组件级 WCAG 2.2 AAA 审查
- 03表格记录各项标准状态
- 04整理问题与建议修复方案
- 05无障碍信息页面编写指南
适用场景
- 01将无障碍检查加入 CI 流水线
- 02按 WCAG 标准评估组件
- 03记录无障碍问题与修复方案
- 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,马格德堡)
- 上次评估的日期
- 所有未通过要求的修复期限
法律还要求开发者主动向主管机构申报其提供的服务。请起草一封邮件,并查找相关电子邮件地址。
此页面必须在每个页面上均可访问,并放在隐私政策等其他法规相关链接附近。
无论该服务是否直接受该法律约束,都必须实现此页面。