SuperAPI AI 工具集

setup-design-handoff

前端与建站

查看项目

更新于 10-16 01:15

技能介绍

用途:让“设计研究→生产组件”的交接在项目中可维护。系统核心是契约——一组命名化的设计决策(令牌+组件名),设计研究、应用及各框架渲染都只使用这些名称。本技能安装支撑契约的三个机械部分:令牌层、研究脚手架、强制执行检查。文字规则(design-system.md、design-studies.md、ui-components.md)来自 setup-rules,若仓库尚无 rules/ 需先运行它。

使用方式与能力:

  1. 检测目标技术栈:查看 package.json 是否含 tailwindcss、tamagui/react-native 或两者(Web+原生 monorepo),与用户确认后选择令牌层形态——Web+Tailwind v4 用 CSS 自定义属性文件(:root 及主题变体)加 @theme inline 映射;React Native/Tamagui 用 tokens.ts 喂给 createTokens();多平台用 DTCG tokens.json(W3C 格式),经 Style Dictionary 构建为各目标输出,JSON 是唯一手工编辑文件。多平台需先查最新 Style Dictionary 文档,不要凭记忆手写配置。
  2. 安装或补全令牌契约:已存在则扩展而非替换,须覆盖四类:颜色角色(语义化、按浅/深主题变体)、字体角色(micro/label/body/body-lg/title/display,含字号+行高+字重+字距,按角色命名)、间距角色、圆角/时长/透明度。本技能只装结构,取值属于设计工作;缺失时运行 design-foundations 技能,不得在此处内联推导或把研究稿原始值复制进契约。
  3. 安装研究脚手架:创建 docs/designs/ 及 README.md 索引,生成 docs/designs/tokens.css 供研究导入,配 kit.js(初始为空),种子 study-template.html(仅用 var(--token) 样式,演示 data-component="PascalCaseName" 命名约定);若 .graphifyignore 忽略 docs 需确认覆盖。
  4. 安装强制检查:复制 templates/check-design-tokens.sh,替换 {{SRC_DIRS}}、{{EXCLUDE_FILES}} 占位符并赋可执行权限,添加根脚本 "check:design-tokens": "sh scripts/check-design-tokens.sh",接入 CI 与 pre-commit;React Native 改用引号十六进制与数字字号/内边距模式;先跑一次,若失败则以现有违规项初始化白名单并提交债务单。
  5. 验证与报告:故意写坏一行(如 text-[13px])应使检查失败,删除后通过;模板能在浏览器用令牌词汇渲染;报告检测到的栈、已装/源自结算的令牌族、检查接入位置、白名单债务及下一步(对首个稳定研究运行 componentize-design 技能)。

限制:令牌取值、具体路径与命令需按仓库实际适配;未提供具体脚本内容与安装命令细节。