技能介绍

无障碍开发的合规痛点与自动化盲区

在现代 Web 开发中，无障碍访问往往被视为事后补充的合规任务。当项目面临欧洲无障碍法案（EAA）或类似区域法规（如德国 BFSG）的强制要求时，开发团队不仅要确保产品对屏幕阅读器、键盘导航等辅助技术友好，还需提供详尽的合规声明与监管机构对接流程。然而，仅靠人工检查不仅耗时巨大，且难以在 CI/CD 流水线中保持持续的质量反馈；而纯自动化测试又存在无法覆盖所有 WCAG 2.2 AAA 级准则的盲区。

技能的核心工作流与交付物

该技能通过“自动化扫描+手动验证+合规生成”的闭环流程，将无障碍检测无缝融入日常开发周期：

程序化规则检查：在 CI 管道中集成 pa11y CLI 与 axe-core runner，对最新的开发构建产物执行自动化规则检测。同时支持对独立组件进行隔离扫描，确保早期发现缺陷。
深度手动审查：针对组件的 WCAG 2.2 AAA 级合规性进行手动核对，并生成包含准则编号、名称、描述及状态（通过/失败/不适用/未测试）的评估表格。利用 Playwright 等浏览器工具替代部分传统真人测试；对于无法可靠判断的场景，会生成带有明确指导说明的 TODO 任务。
拒绝捷径的修复建议：在输出问题评估报告时，坚决抵制为了快速通过而滥用 ARIA 模式的表面修补。若根本原因在于架构设计缺陷，技能将直接建议进行彻底的架构重构。
EAA 合规声明与监管对接：自动生成符合法律要求的公开无障碍信息页面，涵盖服务详情、联系方式、使用工具与流程、各准则的具体合规状态以及监管机构联络方式。此外，还会起草向监管机构主动报备的邮件草稿。

适用边界与实施注意点

该技能旨在辅助开发团队建立严谨的无障碍工程体系，而非完全替代专业的无障碍审计。自动化工具只能拦截约 30%-40% 的无障碍问题，剩余部分必须依赖开发者的手动检查与语义理解。此外，生成的无障碍声明页面虽然建议在所有页面全局部署，但团队仍需确认服务是否确切落入法规管辖范围。对于涉及复杂 ARIA 交互模式或高度动态渲染的组件，需结合人工测试以确保最终用户体验的可靠性。