Agent Skills
返回列表
💻

无障碍审计

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kg-accessibility-audit。

技能介绍

为什么需要结构化的无障碍审计?

很多团队在推进无障碍合规时,会遇到三个典型问题:一是过度依赖自动化工具,axe-core 或 Lighthouse 能发现大量语义问题,但键盘导航顺序、屏幕阅读器实际朗读逻辑这类需要人工判断的场景常被遗漏;二是缺乏统一的评分标准,不同成员对「严重程度」的判断不一致,导致修复优先级混乱;三是输出内容零散,没有可落地的修复方案,最终整改效率低下。无障碍审计不是简单的「过一遍工具」,而是需要覆盖自动检测、手动验证、标准对齐和分级输出的完整流程。

技能如何帮你完成审计?

这个技能围绕「从检测到落地」设计了四层工作流:

  • 自动检测层:优先用 axe-core 扫描 DOM 语义结构,或通过 Lighthouse 分析性能与可达性的交叉项,快速定位如「图片缺失 alt 属性」「按钮未绑定键盘事件」这类显性问题。
  • 手动检查层:补充工具覆盖不到的场景,包括用键盘 Tab 键验证焦点顺序是否逻辑连贯,通过屏幕阅读器听读确认动态内容(如弹窗)是否被正确朗读,以及用对比度工具检测文本与背景的色值是否符合 AA 级标准(普通文本≥4.5:1)。
  • 标准对齐层:严格对照 WCAG 2.1 AA 条款逐项评分,确保每个结论都有明确的标准依据,避免主观判断。
  • 输出落地层:将问题分为 Critical(完全阻断操作)、Serious(核心功能不可用)、Moderate(体验受影响但不阻断)三级,并对应输出可复用的修复步骤,例如「为表单标签添加 for 属性」「调整导航栏焦点样式的 outline 属性」。

适用边界与注意点

技能聚焦于Web/App界面的可达性审计,不适用于后端服务性能优化、数据库索引设计等非前端无障碍场景。使用时需注意:自动检测结果需与手动验证结合,不能直接以工具报告作为最终结论;对于定制组件(如企业自研的富文本编辑器),可能需要额外编写 axe-core 规则才能覆盖自定义逻辑。

使用场景

  • 团队要上线新官网,需要按WCAG 2.1 AA标准完成首页的无障碍审计并输出分级修复方案。
  • 现有管理系统存在键盘操作混乱问题,需要手动检查Tab焦点顺序并生成优化步骤。
  • App新增了弹窗组件,需要验证屏幕阅读器是否能正确朗读弹窗内容并给出调整建议。
  • 需要对比axe-core和Lighthouse的检测结果差异,确认哪些问题必须手动补充验证。

适合人员

  • 前端开发工程师:需要在提交代码前对新功能模块进行无障碍检测,确保符合WCAG标准。
  • 产品体验设计师:要针对视障用户场景优化界面,需要获取手动检查的焦点顺序和对比度具体要求。
  • 合规负责人:负责公司产品无障碍合规,需要按标准生成结构化的审计报告用于内部存档。
  • 测试工程师:在迭代测试阶段要验证弹窗的无障碍表现,需要知道如何手动测试屏幕阅读器朗读逻辑。