关于 keyboard-review
keyboard-review 是用于评估网页及交互组件键盘可访问性的审查技能，指导检查焦点顺序、动态内容和页面地标，并生成分级报告。
主要功能
- 01检查整页 Tab 焦点顺序
- 02测试常见组件的键盘操作
- 03检查动态内容的焦点与播报
- 04检查跳转链接和页面地标
- 05生成按优先级排序的报告
适用场景
- 01审查整页键盘可操作性
- 02检查菜单、模态框、标签页和表单
- 03检查内容更新后的焦点处理
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/keyboard-review确认已加载。
详细介绍
键盘审查
重点审查键盘无障碍性——这是最重要的交互要求。如果键盘无法使用，屏幕阅读器就无法使用，开关设备也无法使用，许多行动不便的用户更是会被完全阻挡在外。
流程
第 1 步：通过 Tab 遍历所有内容
从浏览器地址栏开始，反复按 Tab，遍历整个页面。记录：
- 无法访问的元素——按 Tab 时会跳过的交互项
- 顺序错误——焦点跳到了意料之外的位置
- 焦点不可见——焦点移动了，但看不出当前焦点所在位置
- 键盘陷阱——焦点进入某个区域后无法离开
第 2 步：测试所有组件
使用 keyboard-navigation，测试页面上的每种组件：
- 菜单：按 Tab 打开，使用方向键导航，按 Escape 关闭
- 模态框：焦点应限制在框内，按 Escape 关闭，关闭后焦点应返回
- 标签页：使用方向键在标签间切换，按 Tab 进入面板内容
- 表单：按 Tab 在字段间切换，按 Enter 提交
- 自定义控件：按照其角色采用相应的键盘操作模式
第 3 步：测试动态内容
屏幕上的内容发生变化时：
- 在适当情况下，焦点是否会移至新内容？
- 屏幕阅读器用户是否会获知内容变化？
- 内容被移除时，焦点是否会移至合理位置？
- 加载状态是否会播报？
使用 feedback-and-status，确认所有动态变化都会通过 aria-live 区域或焦点管理进行播报。
第 4 步：检查跳过链接和地标
- 是否存在且可使用“跳至主要内容”链接？
- 是否存在 ARIA 地标（banner、navigation、main、contentinfo）？
- 键盘用户能否高效跳过重复的导航内容？
输出
提交一份键盘无障碍性报告：
- 通过/失败摘要——是否可以仅用键盘完成所有任务？
- Tab 顺序图——实际的焦点顺序，并标出问题
- 组件测试结果——每个交互组件的通过/失败情况
- 动态内容测试结果——内容变化时的焦点管理情况
- 修复清单——按严重程度排序（阻断级、重大、轻微）
评论
支持 Markdown