SuperAPI AI 工具集

accessibility-audit

测试与质量

查看项目

更新于 10-16 01:17

技能介绍

用途:该技能针对给定界面、组件、产品或设计稿,依据 WCAG 2.2 生成结构化无障碍审计,覆盖视觉、运动、认知与屏幕阅读器无障碍,并给出按优先级排列的修复建议。

主要能力:按感知、可操作、可理解、健壮四类组织检查项,输出审计摘要(关键/中等/轻微问题计数与总体合规状态)、逐条检查结果、优先级整改清单、一小时内可完成的快速修复项,以及测试建议(键盘、屏幕阅读器、对比度、自动化扫描)。问题需映射到具体 WCAG 条款,关键问题需给出具体修复方案。

必要输入:被审计对象(屏幕、组件、完整产品或设计规格)、界面描述或图片、目标 WCAG 等级(A/AA/AAA,默认 AA)、是否已知辅助技术用户及其类型、平台(Web/iOS/Android/桌面应用)。资料缺失时以标注“假设,待确认”的合理假设补齐,并在末尾列出;仅当核心对象本身缺失时才先提问。

对比度计算:颜色对比度不能靠目测,AA 阈值为 4.5:1。可用以下命令计算比值、APCA 亮度对比度及最接近的合格颜色:

npx --yes notugly fix "#8ab4f8" "#ffffff" npx --yes notugly onepager <url> --out review.html npx --yes notugly vision

该工具确定性、零依赖、不调用模型,结果一致且无成本。1.4.3 与 1.4.11 的每行整改项应带实测比值;若用户只提供截图而非十六进制值,需在审计中明确说明,推断比值不构成审计发现。

限制与反模式:不要仅依赖自动化扫描(约只能发现 30% 问题),必须配合手动键盘与屏幕阅读器测试;不要因受影响用户比例小就标为轻微;不要用 ARIA 修补错误语义,应优先使用正确语义 HTML;不要混淆文本对比度(4.5:1)与 UI 组件对比度(3:1);不要只审计正常路径,错误、空与加载状态也需满足无障碍要求。

适用场景:设计评审、上线前合规检查、组件级无障碍排查。触发示例:“审计此设计的无障碍性”“检查某屏幕/组件的 WCAG 合规性”“给出某界面的 a11y 审计”。