用途:对线上 Shopify 店铺做 WCAG 2.2 AA 无障碍审计,覆盖 a11y 检查、WCAG/ADA 合规审查等请求。仅适用于 Shopify 店铺,使用前需先确认目标为 Shopify(如检查 x-shopid、x-shopify-stage 或页面中的 cdn.shopify.com 等);非 Shopify 站点不产出报告。
主要能力:按主题模板而非 URL 数量抽样页面(首页、商品页、集合页、博客文章、/cart、内容页等,通常 5-8 页);用 pa11y 的 axe 与 htmlcs 引擎扫描,可选 Lighthouse 评分;合并去重跨引擎发现,区分违规与需人工判断队列;对替代文本质量、对比度、可读性做模型判断;用浏览器驱动做键盘、焦点、回流等交互检查;输出优先级报告,并可按需创建跟踪任务。
使用方式:设置 SKILL 与 OUT 后运行 bash $SKILL/scripts/scan.sh $OUT <url1> <url2> ...,需要 Lighthouse 时加 LIGHTHOUSE=1;再用 python3 $SKILL/scripts/merge_findings.py $OUT 生成 findings.json 与 summary.md。对比度需用 contrast_reprobe.js 在动画结束态复测,焦点检查用 focus_probe.js。
限制:自动化规则仅覆盖约 20-40% 的 WCAG 成功标准,干净扫描不等于合规,未检查项记为 Undetermined;Shopify 结账页(非 Plus)不在范围内;不要用机器人爬取店铺,仅通过 sitemap 抽样;扫描失败页面记为未扫描而非通过;审计者只给修复建议,不直接改代码。