SuperAPI AI 工具集

auditing-wcag

测试与质量

查看项目

更新于 10-16 00:06

技能介绍

用途:该技能执行 WCAG 2.2 A/AA 正式合规审计,按成功标准逐条输出 Pass/Fail/NT/NA 并附证据。若目标是发现问题、提出修复建议或给开发反馈,应改用 reviewing-a11y;若请求不明确,需先确认用户要合规报告还是问题评审。

主要能力:接受 URL 或本地文件路径,多页面需确认清单与入口。流程分六步:输入接收、范围约定(目标级别默认 WCAG 2.2 AA、页面范围、限制、输出格式)、自动化检查、交互检查、人工检查项、报告生成。自动化检查用 Playwright 导航并抓取无障碍树,也可用 a11y-audit CLI;覆盖矩阵确保 A/AA 覆盖。交互检查验证键盘访问与焦点行为。人工与内容检查项若无证据则保留为 NT。

使用方式:首次安装浏览器:npx playwright install chromium。运行全部检查:npx -y @a11y-skills/audit --url "https://example.com"。指定检查:npx -y @a11y-skills/audit --url "https://example.com" --checks axe-audit,focus-indicator-check,page-snapshot。带截图:npx -y @a11y-skills/audit --url "https://example.com" --checks focus-indicator-check --screenshot。自定义输出目录:npx -y @a11y-skills/audit --url "https://example.com" --output-dir ./results。退出码:0 无违规、1 发现违规、2 运行时错误。需 Node 18+。

限制:Playwright 仅提供计算后的无障碍树信号(role/name/state),自动化结果本身不能保证审计结论。屏幕阅读器验证与 AT×浏览器兼容性测试不在范围内。动态行为依赖 Playwright,执行受阻时相关标准标记为 NT。证据缺失时不得猜测,应使用 NT。知识库以相对路径 ../a11y-knowledge/ 引用,单独符号链接安装技能目录时需一并链接该知识库。