用途
ai-design-fix 是一个用于修复 AI 生成、拼凑式(vibecoded)界面的技能。目标是让界面“读起来像被设计过”:保留产品的功能、数据、内容和区块顺序,只改变尺寸、颜色、用词和效果的选取方式。资料明确说明:一个干净但放到任何产品都成立的界面不算完成。
主要能力
- 先度量:把待改文件复制为 .before. 副本或记录 git commit,便于最终生成前后对比;对目标文件运行检查器并保留数字:
npx @enmera/ai-design-check path/to/screen.tsx --json
-
人工审查:在桌面与手机宽度下查看屏幕(浏览器工具、Playwright 或用户截图),重点看需要人眼判断的规则,包括 one-accent、nested-radius、hero-one-action、show-the-product、no-badge-spam、selector-language、empty-states、legible-contrast、readable-measure、spacing-rhythm。随后把问题整理成简短清单:问题、位置、对应规则,按区域分组、最严重的在前。若界面已经不错,则只建议两三项小改进,而不是重设计。
-
确定设计方向(编辑前先写 4 行):用户与该屏幕的任务;产品所属的“世界”(如账本、新闻编辑室、港口、工坊),由此决定中性色阶(暖、石墨或墨)与强调色;一个强调色,用于主操作、选中态和一个关键数字,强调保留真实品牌色,紫到蓝的辉光不算品牌;一个视觉重点,即承载丰富度的那一处(主图表、产品视图、标题数字),其余保持安静。
项目尚无设计令牌(无字号阶梯、无颜色变量)时,可由方向生成而非凭空取值:
npx @enmera/ai-design-check system --character <calm|precise|friendly|warm|bold|editorial|luxurious|playful|technical|trustworthy> --brand "<hex>" --kind <dashboard|app|marketing|reading>
它输出 CSS、Tailwind、SwiftUI 和 Compose 令牌,文本颜色已通过对比度;加 --json 可直接打印。大改动时先展示审查和方向、让用户决定再编辑;小屏幕或用户说“直接做”时则可继续。
-
分轮修复,覆盖整屏:一层一层地处理所有元素,而不是逐个元素处理;复用项目组件与令牌,无令牌时参考 scales.md 的起始值。
- 间距:任意值对齐 4 px 网格;组内一个间距、组间更大间距;同级卡片同一内边距;每个列表同一行高。
- 表面与颜色:一套中性表面色阶;边框使用文字色 6–10% 的细线;层次靠表面色阶;去掉表面与文字渐变、图表外的辉光、模糊色块、侧边条纹;强调色出现两三次。
- 图标:一套线性图标、同一尺寸与线宽;不用 emoji 和闪光符号;每行图标框宽度一致。
- 数据:统计卡片按 标签 → 数值 → 变化及其周期 排列;图表除一条系列外保持中性,并在图上直接标注该系列;标题数字中的分位与小数做弱化。
- 文案:标题命名页面而非问候用户;不用感叹号与流行套话;每个变化都说明与什么相比;按钮写明动作;句首大写;标签不加句号;占位文案简短;示例数据可信。
- 字体:字号取自字号阶梯;字重 400–600;不加字距的全大写标签;负字距只用于大号展示文字;数字用等宽数字;每个数字只用一种格式。
- 布局:页头只有一个主操作;卡片头部一个模式(标题在左,右侧一个控件);一个主元素领衔(主图表占大部分宽度,统计卡片紧凑等高);宽表格跨页;首屏一个主操作、至多一个次要操作;行宽可读。
- 组件:扁平按钮;卡片用表面色阶而非重阴影;一套状态系统;按钮、输入、徽章、卡片使用共享组件与共享外观,不用样式覆盖;按尺寸设定圆角并处理嵌套圆角;徽章少而安静。
- 动效:只用命名过渡;悬停不放大、不弹跳;脉冲只用于实时数据;用 transform 与 opacity 而非位置;尊重减少动效设置。
- 视觉:需要图片处,用真实感数据展示产品本身,而不是通用画面。
-
验证:对同一批文件再跑检查器,按区域报告 前 → 后(例如 221 → 0;间距 76 → 0、字体 57 → 0)。残留项要么修复,要么在行内 ignore 注释中写明理由。用产品支持的最长语言(德语、芬兰语)在手机宽度渲染:
npx @enmera/ai-design-check narrow path/to/page.html --width 320
它报告页面横向滚动、文字被截、文字缩小以适应、手机上内容被隐藏。修复方式是让布局让步(换行、堆叠、连字符、宽表格在自身容器内滚动),绝不缩小文字、截断标签或隐藏内容。之后再次在桌面与手机宽度目视检查,因为检查器看不到对比度、节奏和层级。
- 可选分享:渲染方形前后对比视频(需本机有 Chrome 和 ffmpeg):
npx @enmera/ai-design-check story screen.before.html screen.html --out story.mp4
支持文件或 URL,会在修改前屏幕上标出每个问题、擦除过渡到修改后屏幕并倒计时。
适用场景
用于 AI 生成或快速拼凑的 Web 界面、仪表盘、应用、营销页、阅读页的视觉与文案质量整改;适合在已有检查器结果基础上完成从审查到修复再到验证的完整流程。
限制与规则
- 不为降低问题数而删除功能、数据或内容。
- 不为让布局适配而缩小或截断文字;这样做不算修复。
- 不在没有理由的情况下用 ignore 注释屏蔽问题。
- 若某项修复可推广到下一个项目,可作为规则提交到 rules.json。
- 资料未提供价格、平台支持范围等更多信息。
使用方式概览
- 备份/记录版本,运行检查器,记录数字。
- 桌面与手机宽度目视审查,整理问题清单。
- 写出四行设计方向;必要时用 system 命令生成设计令牌。
- 按层分轮修复全屏元素,复用项目组件与令牌。
- 复跑检查器对比前后;用 narrow 检查 320 宽度;再目视检查。
- 可选用 story 命令生成前后对比视频。