简诗 AI 网站无障碍审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指引,在当前 AI 助手中安装技能 @user_fccf428b/accessibility-auditor-checklist。
技能介绍
要解决的问题
网站要过 WCAG 2.1 AA,最常见的坑是把"跑一遍 axe 就算合规"。自动化工具只能覆盖一部分缺陷,键盘焦点顺序、焦点陷阱、屏幕阅读器朗读的 name / role / state 大多只能靠人工走查;而 Level A / AA 条目繁多,逐条核对很花时间,修完一轮还容易遗漏回归。这个技能的目标是把自动化扫描 + 键盘测试 + 屏幕阅读器实测 + 逐条 WCAG 核对 + 修复回归串成一条可重复的审计流程。
技能如何工作
- 自动化扫描:按
references/automated-testing.md执行 CLI 扫描,并在测试中接入jest-axe或 Playwright 断言,先拿到机器能发现的全部违规。 - 键盘测试:用 Tab 走查整页,按
references/wcag-checklist.md核对 Tab 顺序、激活逻辑、Escape 行为、焦点可见性,以及是否存在焦点陷阱。 - 屏幕阅读器实测:用 NVDA 或 VoiceOver 走一遍页面,确认控件的名字、角色和状态是否被正确朗读。
- 逐条核对标准:对照清单逐项审计 Level A 与 AA 条款,记录每条的符合情况。
- 修复并回归:按
references/common-fixes.md(7 类最常见缺陷的修复模式与sr-only类)和references/aria-patterns.md(tabs、accordion、menu、alert、progress 的 ARIA 写法)逐项修复,然后重跑第一步的自动化检查,确认违规归零。
适用边界与注意点
- 不自动安装依赖、修改系统权限、创建持久化任务或执行下载内容;命令和代码默认只作参考,只有在你明确要求执行、且目标范围清楚时才会运行。
- 涉及发送、发布、删除、付款、部署等外部写入操作,会先展示目标与影响,取得明确确认后再执行。
- 凭据只用于你指定的对应官方服务,不回显、不记录,也不转发到无关地址。
- 最终合规结论仍需结合人工走查,自动化零违规不等于覆盖所有人工测试项。
使用场景
- 前端团队上线新官网前,需全面审计页面是否符合WCAG 2.1 AA标准并定位所有无障碍缺陷
- 修复Tab焦点顺序混乱的问题后,需重跑自动化扫描确认违规项已归零
- 产品新增键盘操作功能,需验证Escape键行为、焦点可见性等是否符合无障碍规范
- 客户要求提供屏幕阅读器兼容证明,需用NVDA实测页面控件的名字、角色朗读情况
适合人员
- 前端开发者:需要将页面调整至WCAG 2.1 AA标准,修复Tab顺序、ARIA属性等无障碍缺陷
- 测试工程师:负责上线前无障碍回归测试,确保每次迭代后键盘与屏幕阅读器兼容性不下降
- 产品经理:需要为客户输出无障碍合规报告,证明产品符合法规要求
- 网站运维:在部署新版本前,需快速排查无障碍问题避免上线后违规