SuperAPI AI 工具集

a11y-ally

测试与质量

查看项目

更新于 10-15 21:09

技能介绍

用途:对指定 URL 执行 WCAG 无障碍审计,覆盖 wcag2a、wcag2aa、wcag21a、wcag21aa、wcag22aa 等标签,并借助 LLM 分析上下文生成针对性修复建议,而非仅输出通用模板。

主要能力:

  1. 多工具扫描:axe-core(ARIA 与语义)、pa11y(对比度、链接、HTML 校验)、Lighthouse(无障碍评分),资料称组合检出率比单一工具高约 15%。
  2. 并行与容错:使用 Promise.allSettled 并行执行,每工具独立超时(60s/60s/90s),失败时优雅降级,支持指数退避重试(3 次);1/3 工具成功即可继续,3/3 时约 95% 检出率。
  3. 浏览器自动化:优先 Vibium,其次 agent-browser,最后 Playwright + stealth 回退。
  4. 多页与爬站:提供 parallel-audit.js(最多 6 并发)与 crawl-audit.js(默认最多 50 页)脚本。
  5. 视频无障碍:检测到视频时下载、抽帧并用 Vision 描述,生成字幕建议。
  6. 输出:结果写入 docs/accessibility-scans/{page-slug}/,扫描中间结果存于 /tmp/a11y-work/scan-results.json。

使用方式:以 URL 调用该技能,Claude 会自动执行全部步骤,无需逐步确认。回退方案需安装依赖:npm install playwright-extra puppeteer-extra-plugin-stealth @axe-core/playwright pa11y lighthouse chrome-launcher。多页审计示例:node parallel-audit.js https://example.com https://example.com/about;爬站示例:node crawl-audit.js https://example.com 50。

适用场景:单页或多页网站的无障碍合规检查、修复建议生成、视频字幕辅助生成。

限制:依赖 Claude 的 LLM 分析,跳过分析则价值有限;需要可用的浏览器环境与系统 Chromium(/usr/bin/chromium);爬站默认上限 50 页;具体收费、平台支持与效果数据暂未提供。