用途:对 Web 应用进行 WCAG 2.0/2.1/2.2 无障碍合规审计,识别常见违规并提供可执行的修复步骤。适用于用户要求无障碍审计、a11y 检查、WCAG 合规审查,或提到屏幕阅读器、键盘导航、残障用户可访问性等场景。
主要能力:围绕 WCAG 的 POUR 原则(可感知、可操作、可理解、健壮)与 A/AA/AAA 合规等级展开,重点覆盖 12 类常见违规,包括低色彩对比度、缺失或不当 alt 文本、缺少名称/角色/值、键盘导航失败、未标注表单控件、缺失语言属性、标题结构不当、空链接或链接文本不佳、焦点指示缺失、ARIA 滥用、数据表格标记不足、媒体缺少字幕。
使用方式:分四阶段。自动化测试可运行 ESLint(如 npx eslint --ext .jsx,.tsx --no-ignore --format json . > .claude/skills/a11y-auditor/eslint-results.json 2>&1 || true)或 Lighthouse(npx lighthouse https://example.com --only-categories=accessibility --output=json --output-path=./lighthouse-results.json),并检查 axe-core 集成。随后按 grep 模式做人工代码检查,按严重程度分级(Critical、Serious、Moderate),再按屏幕阅读器指南做键盘、屏幕阅读器、缩放、高对比度、减少动效等人工测试。最终输出结构化审计报告,含摘要、问题分级、位置、问题说明与修复示例。
适用场景:React/JSX 项目、生产或预发站点、需要 WCAG 合规审查的 Web 应用。
限制:自动化工具仅能发现约 30%–57% 的问题,必须配合人工测试;使用 ARIA 的页面平均错误更多;应优先处理键盘、屏幕阅读器和对比度等关键问题。具体安装与配置细节资料未提供。