accessibility

Web Accessibility (WCAG 2.1 AA) 是一个专注于构建包容性数字体验的开发者指南技能，基于 W3C 权威标准提供系统化的无障碍开发解决方案。

核心用法：该技能通过五步流程法指导开发者实现 WCAG 2.1 AA 合规：首先强制使用语义化 HTML 替代通用 div，确保按钮、链接等交互元素具备原生可访问性；其次在 HTML 语义不足时补充 ARIA 属性（如 aria-label、aria-live）；第三步实现完善的键盘导航系统，包括焦点陷阱、焦点恢复和逻辑 Tab 顺序；第四步确保颜色对比度达到 4.5:1（正文）和 3:1（大文字/UI 组件）；最后构建带有关联标签、错误提示和实时区域的无障碍表单。配套提供的子代理 a11y-auditor 可对现有代码库进行自动化扫描，识别 12 类常见违规项（如缺失焦点指示器、跳级标题等）。

显著优点：作为纯文档型资产，该技能零执行风险，所有代码示例透明可查且经过安全审计。内容体系完整，涵盖从快速检查清单到复杂模式（对话框、标签页、数据表）的全场景实践，特别提供 React/TypeScript 现代框架示例。其决策树和"永不执行"清单能有效预防常见反模式，显著降低合规成本。

潜在局限：来源为 T3 级个人开发者项目，虽内容符合 W3C 标准，但缺乏大型企业或基金会的背书。所有代码示例需开发者手动集成到项目中，无法自动修复现有问题。此外，示例主要基于 Web 技术栈，对原生移动应用或 PDF 文档可访问性指导有限。

适用人群：前端开发工程师、UI/UX 设计师、需要满足法规合规（如 ADA、Section 508）的企业技术团队，以及希望提升产品包容性的产品经理。特别适合正在修复屏幕阅读器兼容性、键盘导航障碍或面临可访问性诉讼风险的团队。

使用风险：开发者需注意示例代码需根据实际技术栈调整，直接复制可能导致样式冲突。无障碍合规不能仅依赖自动化检查，必须配合 NVDA、VoiceOver 等真实辅助技术进行人工测试。此外，WCAG 2.1 AA 仅为最低合规标准，特定行业（医疗、金融）可能需要满足更严格的 AAA 级要求。

核心用法

该 Skill 为纯文档型无障碍开发指南，提供从语义化 HTML 基础到复杂交互组件的完整 WCAG 2.1 AA 合规方案。核心流程包含 5 步：1）选用正确 HTML 元素（button 替代 div onclick）；2）按需添加 ARIA 补全语义缺口；3）实现完整的键盘导航（Tab、Escape、方向键）；4）确保 4.5:1 文字对比度；5）为表单提供可见标签与错误提示。

显著优点

• 框架无关：纯 HTML/CSS/TS 示例，适用于 React/Vue/原生开发
• 可执行清单：提供 12 项常见问题的预防方案与快速检测清单
• 实战代码：包含对话框焦点陷阱、标签页键盘控制、跳转链接等生产级组件
• 权威引用：整合 W3C WCAG、MDN、ARIA Authoring Practices 官方规范

潜在局限

• 纯文档性质，无自动化检测功能（需配合 axe DevTools/Lighthouse 使用）
• 未覆盖移动端 TalkBack/VoiceOver 手势细节
• 复杂自定义组件（如虚拟列表、拖拽排序）需额外查阅 ARIA APG

适合人群

前端开发者、UX 设计师、QA 测试人员，尤其适合需要快速通过无障碍审计（Lighthouse 90+ 分）的团队。

常规风险

• 开发者可能过度依赖 ARIA 而忽略语义化 HTML（Skill 明确警告"优先用原生元素"）
• 键盘导航实现不完整可能导致焦点陷阱失效
• 色觉无障碍需设计团队配合，非开发单方可控