accessibility-audit

用途：在应用发布前做无障碍合规审查、回应无障碍投诉或法律要求、对现有应用做周期性审计、重大 UI 重构后验证无障碍、准备 WCAG 2.1 AA 认证，或帮助团队学习无障碍最佳实践时使用。主要能力：提供系统化审计方法论，分六个阶段——侦察（用 discover 与 precision_grep 搜索交互组件、表单、ARIA 用法、图片组件，识别表单、导航、模态、数据表、媒体播放器、自定义交互组件等关键区域）、语义 HTML 审计（检查标题层级、landmark 区域、列表语义）、ARIA 模式审计（角色、标签与描述、live region）、键盘导航审计（焦点管理、跳转链接、键盘事件处理）、屏幕阅读器支持审计（视觉隐藏文本、aria-hidden 用法）、颜色与对比审计。脚本与参考：scripts/validate-accessibility-audit.sh、references/accessibility-patterns.md。使用方式：按阶段执行搜索查询，针对 onClick 非按钮或链接元素逐一人工核查角色、tabIndex 与 Enter/Space 按键处理；必要时编写符合模式的代码（如模态焦点陷阱、可访问通知、图标按钮）。限制：具体命令参数、阈值和运行环境未在资料中完整说明，颜色对比部分内容被截断，需结合浏览器 DevTools 或外部工具完成；不提供自动修复，部分问题需人工审查。