技能介绍

要解决的问题

网页无障碍合规是工程化的，但在发布流程里很容易断。无障碍缺陷通常只有在上线后才被用户反馈，或者在迭代节奏里被当作“回头再修”。一旦合并到主干，定位成本会成倍增加：你需要复现、截图、判断严重程度，再回到代码里找对应的元素。对工程团队来说，这意味着把无障碍当作一次性的人工审计，而不是流水线里的常规检查。

技能如何工作

这个技能的目标是让无障碍检查能像构建检查一样跑在工程流程里。它以 Pa11y 为核心，把页面级检查封装成可执行的报告。使用时，你只需指向目标 URL：pa11y https://example.com；也可以在 Node.js 里通过 API 调用，拿到结构化结果后自行处理。报告不仅给出违规数量，还会标识出问题元素的选择器，并附上修复上下文，方便直接定位到代码位置。

在 CI 中，你可以把检查接入提交钩子或发布前的流水线，让每次变更都经过同样的规则扫描。通过命令行或 Node.js，你可以根据项目需要选择运行方式。

适用边界与注意点

需要注意的是，该工具当前支持 Linux 和 macOS 环境，Windows 支持可能受限。另外，自动化检查适合作为持续集成的第一道防线，但无法替代真实用户场景下的手动测试，尤其是屏幕阅读器、键盘导航等交互细节。规则覆盖面取决于 Pa11y 默认配置，如果你需要更严格的标准，可能需要自行扩展规则集。