SuperAPI AI 工具集

visual-review

前端与建站

查看项目

更新于 10-16 07:28

技能介绍

用途:visual-review 是针对已改动 UI 的浏览器端 QA 技能。静态检查能发现代码异味,而它用于捕捉需要实际查看和交互才能发现的组合式 UI 缺陷。可在 /commit-push-pr 之前运行,适用于 diff 涉及渲染 UI 的场景,如 .tsx、.jsx、.css、.scss、*.html,src/routes/、src/pages/、src/app/、src/components/、components/ui/,以及影响视觉的 Tailwind/主题/配置文件。仅文档、测试、类型、后端改动可跳过,或需记录明确跳过原因。

主要能力:支持独立触发 /visual-review,也接受路由或组件提示;未提供时会检查 git diff --name-only HEAD,将路由文件映射到 URL、组件改动映射到最近受影响的路由/故事/测试,无法推断时提一个简洁问题。审查矩阵最低要求包括 Chromium 桌面、Chromium 移动视口、仅键盘操作(Tab、Shift+Tab、Enter、Space、Escape)、控制台/网络错误扫描、可达的加载/空/错误/密集数据状态,以及表单提交路径和通知/toast 路径。可行时还覆盖 Firefox 桌面、WebKit/移动 Safari、减少动态效果、深色/浅色模式、高对比度或强制颜色、文本缩放、RTL 或本地化长文本、前进/后退导航、慢网络或媒体节流。检查范围涵盖布局与打磨、可访问性与语义、浏览器/平台差异、性能敏感 UI。

使用方式:优先使用项目脚本,如 scripts/skills-browser.sh、Playwright、bun run dev。工具可验证时不要要求用户手动验证视觉 UI。输出为简洁报告,包含状态(ready/needs fixes/blocked)、改动 UI、已检查项、发现(严重级别、区域、问题、证据、修复)、截图、PR 备注和自动化候选。严重级别 P0 阻止使用/安全/数据丢失,P1 应在 PR 前修复,P2 低风险则修复否则记录,P3 为建议。

限制:资料未提供具体安装命令、收费、价格、平台支持范围或效果保证;部分审查项标注为“可行时”执行,未运行项需记录跳过原因。