ui-review 是一个 UI 审查技能,充当“设计师之眼”,用于检查应用界面的一致性、设计系统合规性与结构模式,发现功能临时开发中累积的不一致。它有两种模式。
模式一:代码审查(/ui-review 或“review the UI code”)。在构建新视图后或界面感觉不一致时运行,分析视图文件的结构一致性,检查:布局使用(每页应使用 Kiso 仪表盘布局组件 dashboard_group、dashboard_navbar、dashboard_sidebar、dashboard_panel,标记自行搭建外壳的页面);页面结构(对比所有页面模板,检查页头模式、内容包裹层、区块间距是否一致);组件使用(每个 UI 元素应使用 kui() 组件,标记 Kiso 已覆盖的原始 HTML,如手写按钮、卡片、表格、徽章、警告、头像、对话框、下拉菜单);间距值(应来自标准刻度 1、1.5、2、3、4、5、6、8、10、12、16、20、24,标记 p-7、mt-11、gap-3.5 等任意值);排版(同类页面应使用相同标题层级);颜色(应使用语义令牌 primary、secondary、muted、destructive,而非 blue-500、zinc-700 等原始颜色);模式漂移(同一 UI 概念在多处出现时应外观一致)。输出按一致性问题和缺失组件等分组。
模式二:视觉审计(“audit the UI”或“screenshot audit”)。系统分析每个屏幕:先用 bin/rails routes | grep "GET" | grep -v "rails/" | grep -v "turbo" 发现路由;再用浏览器自动化工具(Chrome MCP 或 claude-in-chrome)登录、逐页截图并保存渲染后 HTML 到 tmp/ui-audit/;然后分析渲染 HTML(data-slot 属性标识 Kiso 组件、间距刻度合规、颜色令牌合规、排版一致性、布局结构);再整体分析截图集合(页头、侧边栏、内容区、卡片样式、排版层级、间距节奏、配色、空状态、操作位置);最后按严重程度分组报告(结构、间距、排版、组件、次要)。
设计原则:最常见模式胜出;提取而非复制;Kiso 优先;间距取自标准刻度;每件事只有一种做法。限制:资料未提供安装方式、收费、平台支持等细节。