SuperAPI AI 工具集

ui-skills

智能体与模型

查看项目

更新于 10-15 18:41

技能介绍

UI Skills 是一套带有明确取向的界面构建约束规则,通过命令在对话中调用,让代理在从事任何 UI 工作时遵守这些规则。

用途:为代理提供统一的界面开发标准,尤其强调可访问性、动画克制、性能与设计一致性。

主要能力:

  • 技术栈:默认使用 Tailwind CSS 默认值;需要 JavaScript 动画时使用 motion/react(原 framer-motion);Tailwind 入场与微动画可用 tw-animate-css;类名逻辑使用 cn 工具(clsx + tailwind-merge)。
  • 组件:涉及键盘或焦点行为时必须使用可访问的原语(Base UI、React Aria、Radix),优先项目已有原语,同一交互面不得混用原语系统;仅图标按钮必须加 aria-label,不得手写键盘或焦点行为。
  • 交互:破坏性或不可逆操作必须用 AlertDialog;加载态建议用结构化骨架屏;不得用 h-screen 而要用 h-dvh;固定元素须尊重 safe-area-inset;错误须显示在操作发生处;不得阻止输入框粘贴。
  • 动画:除非明确要求,不得添加动画;只动画 transform 与 opacity 等合成器属性,不得动画布局与绘制属性;入场用 ease-out,交互反馈不超过 200ms;循环动画离屏时暂停;尊重 prefers-reduced-motion。
  • 排版与布局:标题用 text-balance,正文用 text-pretty,数据用 tabular-nums;固定 z-index 层级,不得使用任意 z-;方形元素用 size-。
  • 性能与设计:不得动画大面积 blur 或 backdrop-filter,不在动画外使用 will-change,不用 useEffect 表达可渲染逻辑;不得随意使用渐变、紫色或多色渐变、发光效果作为主要可供性;空状态须给出明确的下一步操作,每视图限制一个强调色。

使用方式:输入 /ui-skills 将约束应用于当前对话的所有 UI 工作;输入 /ui-skills <file> 则按上述全部约束审查该文件,并输出违规片段、原因与具体修复建议。

限制:这些规则具有较强主观倾向,会限制部分常规做法;具体项目是否适配、是否有其他例外,资料暂未提供。