用途
该技能用于在用户的工作目录中创建或修改一个设计系统目录(<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() 等值。具体收费、平台支持等信息资料暂未提供。