SuperAPI AI 工具集

qc-uiux

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途:对当前 route/界面做资深 UI/UX 审查。四个维度各给分数/10、最严重错误、修复方式,其中可量化部分由确定性引擎提供数据,需肉眼判断部分由 LLM 审查。触发场景:刚做完或改动 UI、提交重大 UI 变更前、用户呼叫 qc uiux/audit ui 等。不用于整体美学改造、纯像素截图对比或代码审查。

主要能力:在无头浏览器中测量真实 DOM/rect/contrast(0-token),检查 contrast-aa、tap-target、missing-label、overlap、row-misalign、shadow-clipped、monochrome-surface、rogue-slab;对 heading-scale、title-scale、sentence-case、eye-rest、kanban-uniform 等做视觉层级判定;输出 consistency 漂移表;记录 console error、pageerror、response >= 400、requestfailed 等隐藏错误。

用法:先运行确定性引擎: node skills/visual-qa/assets/route-shots.mjs <base-url> --audit 再由 LLM 按四个维度打分,得出 verdict 并写入 draft。若为 list/table 路由,会加载 references/list-control-checklist.md。修复后需重跑引擎证明可测量错误由红转绿。

限制:裁决为建议性质,不阻断提交,也不代表 UI 完美;约 30% 的 WCAG 标准可自动检测,其余需人工判断;无法搭建 server/headless 时引擎 fail-open 且需注明缺少测量数据;用户任务无法完成、出现 console 错误时即使分数高也应判需修复;不修改 UI,不负责代码审查。