SuperAPI AI 工具集

ci-accessibility

测试与质量

查看项目

更新于 10-16 05:03

技能介绍

用途:作为 CI/CD 无障碍专家,帮助团队在持续集成流水线中搭建、维护和排查自动化无障碍扫描。

主要能力:生成无障碍扫描 CI 配置;创建和更新 axe-baseline.json 基线文件,使 CI 仅对回归失败;配置阻断部署与仅告警的严重级别阈值;配置 SARIF 输出用于 GitHub 代码扫描(PR 差异内联标注);将无障碍摘要作为 PR 评论发布并给出通过/失败结论;诊断 CI 检查失败原因并给出修复建议;支持 GitHub Actions、Azure DevOps、GitLab CI、CircleCI、Jenkins。

使用方式分阶段:先评估现状,检查已有 CI 配置文件(.github/workflows/、azure-pipelines.yml、.gitlab-ci.yml、Jenkinsfile、.circleci/config.yml)、已有工具(package.json 中的 @axe-core/cli、pa11y、lighthouse)、已有基线文件(axe-baseline.json、.a11y-cache.json)以及扫描配置(.a11y-web-config.json)。再配置流水线,询问用户的 CI 平台、扫描工具(axe-core CLI、Playwright + axe-core、Lighthouse CI)与门禁策略(严格、标准即仅 critical/serious 失败、基线即违规数增加才失败)。随后生成配置,扫描面向 WCAG 2.2 AA 标签(wcag2a,wcag2aa,wcag21a,wcag21aa,wcag22aa),从 PR 变更文件发现 HTML,存在基线时执行基线比较,输出 SARIF,并给出清晰的任务通过/失败摘要。基线管理流程为:运行 axe-core 捕获当前全部违规生成 axe-baseline.json;每个 PR 运行时与基线比较;出现基线外新违规则失败;基线内违规不阻断,可逐步修复;修复后重新生成基线锁定改进。最后在测试 PR 中验证流水线,生成 README 说明,并可选设置定期全站扫描。

适用场景:需要将无障碍检测接入 CI 并控制回归的团队,尤其是存量代码较多的项目。

限制:资料未提供具体命令细节、定价或效果数据;输出应仅回答所问内容,不追加未请求的清单。共享规则与权威规范见 skills/a11y-core/SKILL.md 与 skills/a11y-core/references/sources.md。