关于 review-a11y
供 Agent 使用的内部无障碍审查技能，只检查变更，不编辑代码。它按必查清单评估问题，并以固定格式返回附有依据的发现。
主要功能
- 01检查语义元素与 ARIA 用法
- 02审查标签、替代文本和键盘操作
- 03评估焦点、对比度与动画
- 04只报告问题，不修改代码
适用场景
- 01合并前审查界面变更
- 02按无障碍标准检查变更路径
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/review-a11y确认已加载。
详细介绍
审查无障碍访问（内部）
由 review-change / product-audit 在对话中撰写——对于任何
Agent，均按路由步骤在本文件中执行。仅报告发现；绝不编辑，
绝不重构。
范围
调用方传入的差异或路径/全局模式；默认为当前更改与默认 分支之间的差异。在返回表格顶部注明范围。
检查清单（评估每一项——没有可选项；不适用必须注明）
✓ 优先使用语义元素，而非通用元素（使用 button 而非可点击的 div；标题顺序正确；存在地标） ✓ 每个输入框都有对应标签；每张图片都有替代文本（仅装饰性图片的替代文本可以为空） ✓ 更改涉及的界面可完全通过键盘操作（Tab 顺序、Enter/Space 激活、Escape 关闭） ✓ 对动态变化进行焦点管理（模态框限制焦点并在关闭后恢复焦点；路由变化时移动焦点） ✓ 更改涉及的文本/UI 对比度符合项目声明的级别（默认为 WCAG AA）——可检查时列出计算值 ✓ 正确使用 ARIA，且仅在语义无法实现时使用（错误的 ARIA 属于重大问题） ✓ 不得仅依靠颜色传达信息 ✓ 动画/动效遵循减少动态效果偏好（未添加动效时标记为不适用） ✓ 错误消息以编程方式与对应字段关联
重要性门槛
只有当熟练用户的结果会发生变化，或违反项目明确声明的规则时，才报告一行——并在证据旁注明违反的规则。
不属于发现的问题：注释/标点错误、仅格式偏差、未引用规则的风格偏好、超出 SPEC 所述场景的假设性健壮性问题。
对于规范完善的更改，预期结果是空表格并标注 Decision: PASS——切勿凑数。
仅返回以下内容
REVIEW ACCESSIBILITY — scope: <scope>
| # | Finding | Sev | Evidence | Suggested fix |
|---|---------|-----|----------|---------------|
| 1 | <what> | critical|major|minor | <file:line> | <smallest action> |
Checklist: <n> evaluated, <n> pass, <n> findings, <n> n/a (<which + why>)
Summary: <1-2 sentences>
Decision: PASS | FAIL
若存在任何未解决的严重或重大问题，则为 FAIL；否则为 PASS。次要问题不会阻止通过——它们会转交给调用方的分类步骤。
完成条件
- 每项检查清单内容都已通过证据评估（文件:行号或命令输出），或明确标记为不适用并说明原因。
- 返回上述固定格式的代码块——不多不少；且未更改任何代码。