Agent Skills
返回列表
简诗 AI 网站无障碍审计

简诗 AI 网站无障碍审计

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 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属性等无障碍缺陷
  • 测试工程师:负责上线前无障碍回归测试,确保每次迭代后键盘与屏幕阅读器兼容性不下降
  • 产品经理:需要为客户输出无障碍合规报告,证明产品符合法规要求
  • 网站运维:在部署新版本前,需快速排查无障碍问题避免上线后违规