SuperAPI AI 工具集

ux-interaction-taste

测试与质量

查看项目

更新于 10-16 04:53

技能介绍

使用方式与范围:该技能用于审查用 AI 编码工具构建的网页应用的交互完整性与用户体验健壮性。它不负责视觉审美,适合与视觉设计类技能(如 design-taste-frontend)配合使用以覆盖完整质量。

工作流:先确定审查范围,可指定路径(扫描 .tsx、.vue、.svelte、.html 文件并从 package.json 自动检测框架)、URL(需浏览器工具,不可用时应要求提供源码路径)或当前项目(检测框架并扫描 src/ 或 app/ 目录)。随后读取关键文件,按三层框架评估;若浏览器工具可用且开发服务器运行,可截图核对实际渲染行为;最后产出按优先级排列的结构化报告。

三层审查框架:第一层 Foundation 关注“是否可用”,包括每个异步操作是否有加载、空、错误、禁用状态,交互元素是否有悬停、焦点、按下反馈,以及键盘可达性、Tab 顺序、Esc 关闭浮层、焦点陷阱与焦点恢复。第二层 Craft 关注“设计是否良好”,涵盖反馈时机、表单 UX(标签关联、校验时机、错误就近显示、必填标记、提交确认)、焦点管理(模态框、路由切换、跳转链接)、响应式(触控目标 ≥44px、无横向滚动)与动画质量(150–300ms、缓动方向、尊重 prefers-reduced-motion)。第三层 Polish 关注“感受是否自然”,包括微交互、渐进加载、错误恢复、撤销与流程意图性。若 Foundation 出现 3 个以上跨类别失败,应先报告基础问题,暂不评估后两层。

反模式识别:技能会标记 AI 生成代码常见问题,如无加载状态、onClick 无禁用逻辑、无错误边界、空 catch、图标按钮缺 aria-label、去除 outline 无替代、模态框错误自动聚焦、无限滚动无键盘替代、使用 alert/confirm 决策等。

输出:完成报告包含目标、框架、三层通过/问题数及 3–5 条最高优先级修复项;详细发现按 [层] 类别、文件位置、问题、影响、修复建议的格式给出。可参考 references/interaction-checklist.md 获取完整检查清单与代码级检测模式。

限制:URL 审查依赖浏览器工具,不可用时仅能基于源码;仅覆盖交互与 UX,不替代视觉设计审查。