SuperAPI AI 工具集

a11y-audit

设计与创作

查看项目

更新于 10-16 03:43

技能介绍

用途:对界面或设计进行无障碍(可访问性)审计,依据 WCAG 2.2 AA/AAA 与项目 ARIA 模式,返回引用具体准则的发现(criterion-referenced findings),含严重级别与具体修复方案。适用于需要按标准检查键盘、焦点、对比度、屏幕阅读器等无障碍问题的场景。

环境检查:技能会读取 kit 中的文件。需先确认 kit 是否就位: ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING 若为 KIT_MISSING(仅安装了技能文件夹,即 npx skills add 的情况),应如实说明并指向 npx ux-ui-agent-skills init 或插件安装方式后停止,不得猜测无法打开文件的内容。

主要能力与流程:读取 accessibility/wcag-checklist.md(按 POUR 组织,分 P0/P1/P2)和 accessibility/aria-patterns.md;按组件检查强制 P0 集:可键盘导航、焦点可见(≥3:1)、屏幕阅读器可识别名称/角色/状态、对比度(文本 4.5:1 / UI 3:1)、目标尺寸 ≥24×24、不以颜色作为唯一信号。核对 WCAG 2.2 新增项:Focus Not Obscured (2.4.11)、Target Size (2.5.8)、Accessible Authentication (3.3.8)。

对比度测量:不得凭肉眼判断。对已渲染 HTML 运行真实渲染门禁并报告实际输出: node ${CLAUDE_SKILL_DIR}/../../../scripts/measure_render.mjs <file> [--dark](检查每个文本元素) node ${CLAUDE_SKILL_DIR}/../../../scripts/verify_states.mjs <file> [--dark](检查每个交互元素的默认/悬停/聚焦状态,可发现悬停态失败) 对零散颜色对使用:python3 ${CLAUDE_SKILL_DIR}/../../../scripts/contrast.py "<fg>" "<bg>" 不得给出未实际测量的比率。

其他检查:减少动效处理(taste/motion-choreography.md)。

输出:发现表格,列为 WCAG 准则(如 1.4.3)· 严重级别(P0/P1/P2)· 失败内容 · 具体修复;对通过项明确确认。无障碍不得因美观而妥协。

限制:该技能依赖 kit 文件与脚本;kit 缺失时只能停止并提示初始化。官方资料未说明具体支持的平台、收费或价格。