SuperAPI AI 工具集

baseline-ui

前端与建站

查看项目

更新于 10-16 08:45

技能介绍

Baseline UI 是一套强制性的 UI 基线约束,用于防止 AI 生成的界面出现随意、低质的实现。它主要面向使用 Tailwind CSS 的前端项目,以规则清单的形式约束技术栈、组件、交互、动画、排版、布局、性能和设计等方面的做法。

使用方式:在对话中输入 /baseline-ui,可将这些约束应用到后续任何 UI 工作;输入 /baseline-ui <file> 可让工具按全部约束审查指定文件,并输出违规内容(引用具体代码行或片段)、问题原因(一句简短说明)以及代码级的具体修复建议。

主要能力与规则要点:技术栈方面,除非已有自定义值或明确提出,必须使用 Tailwind CSS 默认值;需要 JavaScript 动画时应使用 motion/react;类名逻辑须使用 cn 工具;入口和微动画建议使用 tw-animate-css。组件方面,涉及键盘或焦点行为时必须使用可访问的组件原语,优先项目已有原语,同一交互面不得混用不同原语系统,纯图标按钮必须添加 aria-label,不得手写键盘或焦点行为。交互方面,破坏性或不可逆操作必须使用 AlertDialog,加载状态建议使用结构化骨架屏,不得使用 h-screen 而应使用 h-dvh,固定元素须尊重 safe-area-inset,错误须显示在操作发生处附近,不得阻止输入框粘贴。动画方面,除非明确要求不得添加动画;只动画化 transform 和 opacity 等合成属性;不得动画化宽度、高度、位置、外边距、内边距等布局属性;交互反馈不得超过 200ms;循环动画离屏时须暂停;应尊重 prefers-reduced-motion;不得引入自定义缓动曲线。排版方面,标题须用 text-balance、正文须用 text-pretty,数据须用 tabular-nums,密集界面建议截断或行数限制,不得随意修改字距。布局方面,须使用固定 z-index 层级而非任意 z-,正方形元素建议用 size-。性能方面,不得动画化大面积模糊或背景滤镜表面,不得在非活动动画外使用 will-change,不得用 useEffect 表达可用渲染逻辑完成的事情。设计方面,除非明确要求不得使用渐变、紫色或多彩渐变,不得以发光效果作为主要可供性,空状态须给出一个明确的下一步操作,每屏建议只用一个强调色,优先使用既有主题或 Tailwind 颜色标记。

限制说明:以上约束偏强制和主观,可能不适用于所有设计体系;其规则以资料所列内容为准,具体集成方式、支持的框架版本与完整配置暂未提供。