用途:以无障碍专家身份审查 UI 代码是否符合 WCAG 2.1 AA,输入为待审计对象($ARGUMENTS)。
主要能力:按八项清单检查——语义 HTML(标题层级、列表/表格/地标、button 与 a 的正确用途)、键盘导航(可聚焦与激活、焦点顺序、模态焦点陷阱)、ARIA(aria-label、aria-describedby、aria-live、role 的正确使用,且仅在原生语义不足时添加)、颜色与对比度(正文 4.5:1、大文本 3:1,颜色不作为唯一信息载体)、表单(可见 label、错误信息经 aria-describedby 关联、必填标识)、图片与媒体(有意义的 alt 或装饰性 alt=""、视频字幕)、动效(尊重 prefers-reduced-motion、避免自动播放动画)、屏幕阅读器(线性阅读是否通顺、sr-only 隐藏元素处理)。
使用方式:调用时传入待审计的组件或页面,技能按约束输出结果。约束要求:按文件路径与行号定位具体元素;每个问题标注违反的 WCAG 条款(如 1.1.1 Non-text Content);给出具体代码修复而非仅描述问题;按严重程度排序为 critical(阻断访问)> major(降低体验)> minor(最佳实践);不重复标记组件库已处理的问题(如 shadcn Button 已处理焦点样式);对关键页面建议补充 @axe-core/playwright 端到端测试。
输出格式:分为 Summary、Critical、Major、Minor 四段,问题条目形如 file:line — [WCAG X.X.X] 描述 + 修复。
适用场景:新建 UI 时预防性检查、组件评审、无障碍缺陷修复。限制:资料未提供具体安装命令、支持的框架范围、收费方式与运行环境要求。