Agent Skills
返回列表
💻

屏幕阅读器无障碍测试

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/screen-reader-testing。

技能介绍

要解决什么问题

Web 应用在键盘、对比度之外,辅助技术用户能否正确理解界面,往往取决于屏幕阅读器如何播报 DOM 与 ARIA。团队常见痛点包括:加了 aria-* 却听不对、动态插入内容不通知、表单错误只变红不读出来、焦点顺序与视觉顺序不一致。这类问题很难单靠自动化规则扫完,需要按真实播报路径做手工或半结构化验证。

技能如何帮你做校验

本技能把「屏幕阅读器测试」收敛成一套可重复的操作指引:先明确目标、约束与输入(测哪条用户流、用哪款读屏、桌面还是移动),再按场景套用最佳实践——例如校验 ARIA 实现、调试辅助技术异常、验证表单标签与错误关联、检查 aria-live 等区域对动态内容的播报,以及主导航与地标是否可被线性浏览发现。

输出侧强调可执行步骤与验证方法,而不是泛泛的 WCAG 条文复述;需要更细的模式与示例时,可对照 resources/implementation-playbook.md 中的 playbook。

适用边界

任务若与屏幕阅读器或 Web 无障碍播报无关,或必须依赖本技能未覆盖的其他领域工具链,则不在范围内。它补充的是读屏路径上的验证思路,不能替代完整的无障碍审计策略或与设计/后端联调的全链路责任划分。

使用场景

  • 新功能上线前,用 NVDA 或 VoiceOver 走通结账/提交链路,确认按钮名称与状态变化会被播报
  • SPA 异步更新后页面「静默」,需按技能步骤检查 `aria-live`、焦点落点与动态插入节点
  • 表单校验失败只变红无文案关联时,要验证读屏能否读出错误信息与对应输入框
  • 主导航或侧边栏改版后,需确认地标角色与链接顺序在线性浏览下仍可完成任务

适合人员

  • 维护组件库或设计系统的前端,合并含 ARIA 的 PR 前需要用读屏做可访问性抽检
  • 负责无障碍回归的 QA,要在关键业务路径上固定覆盖屏幕阅读器播报场景
  • 接手运营/Admin 后台的工程师,需定位辅助技术用户无法完成筛选、弹窗与提交的具体播报断点
  • 产品或 UX 提出「要过无障碍」但缺少测试清单时,需要可执行的读屏验证步骤与验收标准