SuperAPI AI 工具集

review-a11y

智能体与模型

查看项目

更新于 10-15 21:56

技能介绍

用途:这是一个内部无障碍审查步骤,由 review-change 和 product-audit 在对话内组合调用,不属于可选菜单项。它只产出发现项,从不编辑代码,也不重构代码。

使用方式:按调用方传入的 diff,或路径/glob 确定审查范围;默认比较当前变更与默认分支,并在返回表格顶部标明范围。任何代理均可按照该文件内联执行此步骤。

主要能力:按固定清单逐项评估,每一项都不可跳过,不适用必须说明原因。检查内容包括:语义元素优先于通用元素(用 button 而非可点击 div,标题按序,存在地标);每个输入有关联 label,每个图像有 alt(仅装饰性图片可为空 alt);变更面的完整键盘可操作性(tab 顺序、Enter/Space 激活、Escape 关闭);动态变更的焦点管理(模态框捕获并恢复焦点,路由切换移动焦点);变更文本/UI 的对比度符合项目声明级别(默认 WCAG AA),可核对时引用计算值;ARIA 使用正确且仅在语义无法表达时使用;不单靠颜色传达信息;动效尊重减少动效偏好(未新增动效则 n/a);错误消息与字段程序化关联。

重要性门槛:仅在合格用户结果改变,或明确违反项目声明规则时报告一行,并在证据旁引用所违反规则。不算发现项的情况:注释/标点拼写错误、仅格式漂移、无引用规则的风格偏好、超出 SPEC 指定场景的假设性健壮性。格式良好的变更预期返回空表格加 Decision: PASS,不得为凑行数填充表格。

返回格式:固定块,包含标题行 REVIEW ACCESSIBILITY — scope: <scope>、表格(列:# / Finding / Sev / Evidence / Suggested fix,严重度为 critical、major、minor)、Checklist 统计行、Summary 行和 Decision 行。任一 critical 或 major 发现未关闭则 FAIL,否则 PASS;minor 从不阻断,交由调用方的分类步骤处理。

完成条件:每个清单项都已用证据(file:line 或命令输出)评估,或明确标记 n/a 并说明原因;只返回上述固定格式块,不多不少,且未改动任何代码。

限制:官方文本暂未提供;价格为暂未提供;平台与安装方式暂未提供。