SuperAPI AI 工具集

ui-review

前端与建站

查看项目

更新于 10-15 21:35

技能介绍

用途:ui-review 是项目级 UI 审查关卡,针对前端改动检查六类视觉质量问题:长内容溢出与截断、响应式多屏布局(flex-wrap、小屏下由行转列)、flex-grow 与固定尺寸、z-index 层级规范、SCSS/CSS/BEM 样式质量、异步 UI 状态与反馈(加载指示、用户可见错误、空状态、请求中禁用)。目标是让改动在真实内容、响应式布局、层级、样式约定以及加载/错误/空分支下都能通过。

主要能力:默认审查所有未提交的前端改动(暂存与未暂存),也可指定文件、目录、组件或整个前端代码库;若范围内没有前端文件则跳过并报告干净。若存在 .code-graph/graph.db,会做影响范围追踪,优先审查共享组件。审查结果写入 plans/reports/ui-review-{date}-{slug}.md,结论分为 BLOCKED(合并前必须修复)、WARN(需评估决定)、PASS(合规)。每条违规需给出 file:line 证据,并在标记模式违规前先 grep 3 个以上既有示例,代码库既有约定优先。

使用方式:先读取项目样式规则、设计系统/令牌、前端架构模式、代码审查规则四类文档,规则来自文档而非通用知识;再确定范围、评估影响、逐类审查、生成报告。修复循环为验证→修复→完整重审,审查在验证前保持只读。

限制:仅适用于前端/UI 改动;需要项目文档提供规则与复用目标,文档缺失时需先走项目初始化或相应设置流程;小屏下内容被裁剪、遮挡或控件不可达才判 BLOCKED,单纯横向滚动不算缺陷;若需大规模响应式重构,应先与用户确认范围,不应静默重写布局。