SuperAPI AI 工具集

design-system-spec

设计与创作

查看项目

更新于 10-15 23:33

技能介绍

用途:指导如何编写一份 AI 智能体可读的 DESIGN.md,使智能体生成的 UI 与项目设计系统保持一致。智能体缺乏隐性知识,因此规范需要比给人看的文档更明确。

适用场景:新项目希望智能体从第一天就生成符合品牌风格的 UI;已有项目中智能体产出不一致或通用化界面;让新智能体接入既有设计系统;设计系统演进后更新规范。不适用于 UI/UX 设计决策、CSS 实现模式或组件实现,这些应使用对应的其他技能。

主要能力与要求:

  1. 令牌必须有具体值,抽象名称对智能体无用,每个令牌需给出解析后的值,如颜色表包含令牌、值与用途。
  2. 用护栏替代指南,明确“绝不要做”的事项,例如单个视图不超过两种字重、不并排放两个主按钮、不单靠颜色传达状态、圆角固定为 6px、卡片阴影不超过 0 1px 3px rgba(0,0,0,0.1)。
  3. 组件需记录全部变体与状态(默认、悬停、激活、禁用、加载),智能体默认只做“正常路径”。
  4. 间距使用命名刻度而非任意像素值,规则是只用刻度令牌。
  5. 排版需同时给出字号、字重与行高,正文最大行宽 72ch,正文不居中。
  6. 若有暗色模式,需显式列出明暗两套令牌映射,在 [data-theme="dark"] 覆盖令牌,不重复组件样式。
  7. 定义图标系统,包括库、尺寸、描边宽度与颜色继承规则,避免混用图标库。

使用方式:按颜色、间距、排版、组件、护栏的顺序编写;新增组件时记录全部变体与状态;设计系统变化时先更新 DESIGN.md 再生成新 UI,并在文件顶部标注版本。

限制:资料未提供安装命令、收费或平台信息;迁移既有项目时应从 CSS/Tailwind 配置提取真实值,不要发明新令牌;使用第三方组件库时只记录主题覆盖部分;多主题场景以基础文件加按租户覆盖文件组织。