SuperAPI AI 工具集

design-review

设计与创作

查看项目

更新于 10-16 09:51

技能介绍

用途:design-review 是一个只读设计评审技能,用于诊断 UI 代码并给出改进建议,而非重写代码。适用于用户要求“review this UI”“design review”或批评某个组件/页面,或表示输出“看起来不对劲”“像 AI 生成”“像线框图”,或 PR 涉及 CSS/JSX/Tailwind 需要合并前设计反馈,或想提升现有界面的视觉打磨与可访问性。它不用于从零构建 UI(那用 web-taste),也不替代完整的动画规则集(emilkowal-animations)。

主要能力:以 Emil Kowalski 的设计工程理念为视角,结合 Refactoring UI、WCAG、MDN 的启发式规则,按十个类别排序检查:视觉层级、间距布局、字体排印、颜色对比、组件状态与反馈、动效、响应式与触控、可访问性与语义、流程与导航、交互连续性。每条发现会指出代码落入的错误默认、具体修复方式及原因。

使用方式:默认静态评审,读取代码即可;当结论取决于渲染行为(动效、交互、流程类别)时,切换为运行时评审,按照 runtime-capture.md 驱动真实浏览器(chrome-devtools-mcp)测量。先做“0.5 秒测试”定位视觉焦点,再按优先级顺序检查各类别,每条问题记录 Before(确切代码或测量值)、After(具体修复)、Why(原则)、按影响分配的 Severity(Critical/High/Medium/Low)。最终以固定 Markdown 表格输出,每行一个问题,并给出按影响排序的前三修复项。规则 slug 需在 Why 列引用以便跟进。

限制:只诊断与提议修复,不重写代码库;动画的拖拽、手势、弹簧、交错、clip-path 及完整缓动表需参考 emilkowal-animations;从零构建或构建期前端参考应使用 web-taste、tailwind-ui-refactor、ui-design。