SuperAPI AI 工具集

ui-skills

智能体与模型

查看项目

更新于 10-16 07:23

技能介绍

ui-skills 是一份带有明确主张的约束清单,目标是让智能体在构建界面时遵循统一规范,从而产出更一致、可访问的前端实现。它不是工具库,而是一组 MUST、SHOULD、NEVER 级别的规则集合。

技术栈方面:自定义值之前必须优先使用 Tailwind CSS 默认值(间距、圆角、阴影);需要 JavaScript 动画时必须使用 motion/react(原 framer-motion);建议使用 tw-animate-css 处理入场与微动画;类名逻辑必须使用 cn 工具(clsx + tailwind-merge)。

组件方面:凡涉及键盘或焦点行为的都必须使用可访问的组件基元(Base UI、React Aria、Radix);必须优先使用项目已有的组件基元;同一交互面绝不混用不同基元系统;若与栈兼容,新基元建议优先选 Base UI;仅图标按钮必须加 aria-label;除非明确要求,绝不手写键盘或焦点行为。

交互方面:破坏性或不可逆操作必须用 AlertDialog;加载态建议用结构化骨架屏;绝不用 h-screen,改用 h-dvh;固定元素必须尊重 safe-area-inset;错误须显示在操作发生处附近;绝不禁用输入框和文本域的粘贴。

动画方面:除非明确要求,绝不添加动画;只对合成属性(transform、opacity)做动画;绝不动画布局属性(width、height、top、left、margin、padding);除小型局部 UI 外避免动画绘制属性;入场建议用 ease-out;交互反馈不超过 200ms;循环动画离屏时必须暂停;必须尊重 prefers-reduced-motion;不引入自定义缓动曲线;避免动画大图或全屏表面。

排版方面:标题用 text-balance,正文用 text-pretty;数据用 tabular-nums;密集 UI 建议 truncate 或 line-clamp;未经要求不改 letter-spacing。布局方面:使用固定 z-index 层级,不用任意 z-x;方形元素建议用 size-x。性能方面:不动画大 blur() 或 backdrop-filter;will-change 仅在动画激活时使用;能用渲染逻辑表达就不用 useEffect。设计方面:不用渐变(除非要求),不用紫色或多色渐变,不用发光作主要可点击提示;建议用 Tailwind 默认阴影;空状态须给出一个明确的下一步操作;每屏强调色建议限一种;优先使用已有主题或 Tailwind 颜色令牌。

使用方式与版本、安装方式、许可与平台支持等资料暂未提供。