SuperAPI AI 工具集

brandkit

设计与创作

查看项目

更新于 10-16 07:08

技能介绍

用途

Brand Kit 用于在任何页面设计之前先建立品牌的“基础层”——一个所有渲染都依赖的 token 系统。目标是让每一页都能从单一位置保持一致并支持主题切换。

主要能力

  • Brief Inference(必要步骤):推断行业、受众、一个情绪形容词以及动效深度(参考 taste/design-taste.md → Brief Inference),并从 taste/aesthetic-systems.md 中选取一个锚定原型。
  • Primitives(原始层):在 OKLCH 中生成品牌色阶(11 个色阶,色度一致)以及中性色阶;并按 CLAUDE.md 的 Color Generation 校验:500 色阶在白色背景上的文本对比度 ≥ 4.5:1,600 色阶作为 UI 时 ≥ 3:1。
  • Semantic layer(语义层):将角色映射到原始层,包含 action.primary/-hover/destructive、text.{primary,secondary,on-action,link}、surface.{page,card,raised}、border.{default,strong}、feedback.{success,warning,error,info},以及精心设计的深色覆盖值(非简单反转)。
  • Scales(尺度):Major Third 字体比例与复合文本样式、4px 间距比例、圆角层级、阴影层级,以及 tokens/motion.json 风格的时长与缓动。
  • 输出:DTCG tokens/*.json(三层结构)加单一 theme.css(唯一共享源,含 [data-theme="dark"] 覆盖);可选择接入 token-build 流水线以支持其他平台。

使用方式

技能以脚本校验作为完成标准:

  • python3 scripts/validate_tokens.py — 校验 JSON 有效,所有别名可解析。
  • python3 scripts/validate_contrast.py — 校验必需的文本/操作/边框组合在浅色与深色下均通过 WCAG AA,border.strong ≥ 3:1。
  • python3 scripts/validate_theme_refs.py — 校验每个组件 var(--…) 都能解析到主题。
  • 运行 npm run verify 进行整体验证。

设计约定:单一主题,不使用逐页调色板;destructive 使用 danger token(而非 primary);零硬编码值。

适用场景

适合需要在页面开发前先确立统一、可访问、可换肤的品牌 token 基础的项目,特别是要求颜色对比度合规、支持深色模式、并希望避免逐页硬编码样式的团队。

限制

该技能产出的可测量部分是 token 基础的验证结果,品牌“感觉”仍需人工对照 taste/design-taste.md 进行评审。其他平台输出需借助 token-build 流水线。资料未提及收费、价格、具体平台支持范围、效果或性能数据。