SuperAPI AI 工具集

a11y-ally

设计与创作

查看项目

更新于 10-16 03:48

技能介绍

用途:对指定 URL 做全面的 WCAG 无障碍审计。该技能由 LLM 驱动,价值在于 Claude 的推理能力:为无名称按钮结合图标类名、父元素与周边文本推断出具体名称;对缺失 alt 的图片用视觉能力描述实际内容;对无字幕视频下载并抽帧、逐帧用视觉分析生成真实字幕,最终输出上下文相关、可直接复制的修复方案。

主要能力:以 qe-browser(封装 Vibium,WebDriver BiDi,约 10MB Go 二进制)作为浏览器引擎抓取无障碍树与整页截图,并用 vibium eval 注入 axe-core 检测违规;当需要更多规则集时回退使用 pa11y 与 Lighthouse。支持多 URL 并行审计、站点爬取审计等可选模式,并将结果写入 docs/accessibility-scans/{page-slug}/。扫描采用并行与弹性架构,各工具独立超时,带指数退避重试,渐进输出结果;3 款工具全部成功时检测覆盖率约 95%,2 款约 85%,1 款约 70%,0 款则失败需换策略。

使用方式:以 URL 调用该技能后,Claude 会自动连贯执行全部步骤,不在步骤间等待用户确认:先做多工具扫描,再逐条分析违规上下文,如检测到视频则执行视觉字幕流程,随后生成针对性修复并写出报告。必要命令保持原样,例如 vibium go "$TARGET_URL"、vibium wait load、vibium a11y-tree --json > /tmp/a11y-work/tree.json、vibium screenshot -o /tmp/a11y-work/page.png --full-page;回退路径 pa11y "$TARGET_URL" --reporter json > /tmp/a11y-work/pa11y.json 与 lighthouse "$TARGET_URL" --only-categories=accessibility --output=json --output-path=/tmp/a11y-work/lighthouse.json --chrome-flags="--headless"。并行与爬取脚本示例见资料中的 /tmp/a11y-work/parallel-audit.js 与 crawl-audit.js。

适用场景:发布前的无障碍合规检查、多页面站点审计、视频内容的字幕补全以及需要具体修复建议的开发流程。

限制:依赖 qe-browser/Vibium、axe-core、pa11y、Lighthouse 及系统 Chromium 等运行环境;若跳过 LLM 分析环节,该技能的核心价值将失效。资料未提供收费、价格、支持平台与效果承诺等具体信息。