SuperAPI AI 工具集

design-system

设计与创作

查看项目

更新于 10-20 08:10

技能介绍

用途

该技能用于在用户的工作目录中创建或修改一个设计系统目录(<system>/)。设计系统以文件形式存储:索引为 <system>/design-system.json,设计 token 写在 <system>/tokens.json,品牌手册写在 <system>/README.md,组件及其预览、bundle、样式与类型文件放在 components/ 下,标志、图标、图片等素材按素材组放在 assets/ 下,字体放在 fonts/ 下。图标和图片等二进制素材通过上传存入 <system>/_blobs/,由索引里的 record 命名。

主要能力

  • 建立设计系统:依据品牌真实来源(代码库样式与组件、文件、演示文稿、规范)构建,先列出 token、组件、素材的完整清单,值要求精确;标志、图标、字体和图片作为文件复制,不仿造标志。
  • token 管理:tokens.json 覆盖颜色、字体与文字样式、间距、圆角等 family,每个 family 为 {"tokens":[{"name","value","usage"}, …]} 的条目列表,颜色另带 themes;支持十六进制、rgb()、hsl()、oklch() 等颜色值以及指向其他颜色 token 的 alias。
  • 品牌手册:README.md 作为品牌手册,包含内容基调、视觉基础、图标规范与真实示例,用法规则点名 token;组件使用指南写在 components/<Comp>/README.md。
  • 组件与预览:components/bundle.js、bundle.css、index.d.ts,每个组件有 preview.html 实时预览;preview.html 首行标注卡片分组与高度。
  • 素材上传与登记:通过 design_system_import_asset 上传,返回 /_blob/<id> 及要写入索引的 record;索引中的 assetGroups 记录名称、blob、大小、类型,groups 决定素材组排序。
  • 校验:运行 design_system_check 检查文件问题,反复修正直至不再列出问题,此时线程中才出现设计系统卡片。

使用方式

在会话中按技能指引操作:新建时先读索引的 marker;若没有 design-system.json 则为空设计系统。把每个文件写到 <system>/<path>;index 在每轮工作最后写一次,写前当场重读,保留其他键与 marker,并设置 lastChange。修改时只写改动过的文件,tokens.json 整份写入。上传用 design_system_import_asset(system, path, group),检查用 design_system_check(path)。为避免预览依赖问题,CDN URL 需钉到确切版本。

适用场景

从代码仓库或设计工具同步品牌样式;为智能体提供可读取的品牌手册与 token;维护组件库的预览与使用指南;在现有设计系统上做增量修改。没有可依据来源时,可先做一个小初版设计系统(一个 theme 内 6–10 种颜色、5–7 种文字样式、4 级间距、3 种圆角、一段话 README、不做组件),并向用户说明。

限制

设计系统上限为 1,008 个文件、256 MiB,单文件 ≤15 MiB;上传支持 png、jpeg、gif、webp、svg、mp4、webm、pdf、woff2、woff、ttf、otf,≤20 MB,SVG ≤2 MB;路径须为相对路径,不含 ..。design-system.json 没有 marker 时页面以只读方式打开。页面生成的 api/、tokens.css、manifest.json 不应写入。token 名称须符合 [A-Za-z0-9][A-Za-z0-9_.-]{0,63};不支持颜色名、var()、color-mix() 等值。具体收费、平台支持等信息资料暂未提供。