用途:在 Claude CLI 中审计线上 URL 的无障碍问题,结合 Playwright 与 Axe 的自动化结果和仓库内的 WCAG 技能进行解读。
主要能力:运行指定命令后输出 JSON,包含 axe.violations(自动化 WCAG 与最佳实践失败)、axe.incomplete(需人工确认的潜在违规)以及 accessibilityTree(自动化规则难以覆盖的行为问题,如交互元素名称缺失或不清晰、角色异常或不匹配、地标与标题结构问题、状态传达缺口、对话框与菜单语义可能带来的焦点管理风险)。
使用方式:当用户要求审计页面 URL 时运行:npx --yes --package=github:mgifford/accessibility-skills cli-audit-inspect <URL>。该调用从仓库包拉取检查命令,无需目标项目本地 scripts/ 文件。解析输出后,先参考 skills/ACCESSIBILITY-general/SKILL.md,再按观察到的问题应用相关主题技能(如表单、键盘、导航、颜色对比、aria-live-regions、图片替代文本、表格、svg、触摸指针、工具提示)。
报告要求:每条问题标明来源(axe 或 accessibilityTree);在可用时包含 axe 节点的选择器/路径;给出影响摘要与严重程度;在可确定时引用 WCAG 2.2 成功标准并注明映射来源,不得编造证据不支持的映射;给出与技能规则关联的具体修复建议;保留原始结果(violations 与 incomplete 分开,或无障碍树证据),不要合并为单一通过/失败标签。所有 axe.violations 与 accessibilityTree 发现应标记为 evidence_status: automated-indicator 与 handling: review,单次审计不构成人工确认。若无问题,需说明残余风险:自动化扫描可能遗漏交互、时序、焦点流和辅助技术行为问题,建议按 skills/manual-testing/SKILL.md 进行键盘与屏幕阅读器人工验证。
限制:需遵守 robots 指令与站点服务条款;优先单页或小批量检查,避免对生产页面快速重复扫描;若被 Cloudflare/WAF 拦截,不要暴力重试,建议使用暂存 URL、加入允许列表或人工检查等经所有者批准的替代方案。