跳转到使用指南
ui-design-system作者 Alireza Rezvani

UI Design System Skill.

Claude Code 和 Codex 的品牌与设计系统 skill:设计 token、组件文档、响应式计算和开发者交接。

  • Brand & Design Systems
  • 设计系统
alirezarezvani/claude-skills · product-team/skills/ui-design-system/SKILL.mdSKILL.md
--- name: ui-design-system description: UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use when creating design systems, generating design tokens, maintaining visual consistency, or facilitating design-dev collaboration and developer handoff. --- ## Trigger Terms ## Workflows ## Quick Reference Tables ## Knowledge Base ## Validation Checklist
前置元数据和章节标题读取自上游文件,时间 2026-09-14 · 完整内容 10,759 字符

01 功能说明

ui-design-system Skill 在 Claude Code 和 Codex 中的功能

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

一个设计系统工具包,可将单一品牌色转化为完整的 token 集合。design_token_generator.py 接受一个十六进制颜色值和 modern、classic 或 playful 预设,返回颜色、字体排版、8pt 间距、尺寸、边框、阴影、动画、断点和 z-index 层级,格式可为 json、css、scss 或摘要。

随后的四个工作流涵盖从原子到模板的组件架构、使用 clamp() 流体排版的响应式断点、WCAG 对比度校验,以及面向构建团队的开发交接(转换为 React CSS 变量、Tailwind 配置或 styled-components),并通过 Tokens Studio 实现 Figma 同步。该工具面向需要为构建团队记录 token 和组件的资深 UI 设计师。

它产出什么

  • 组件 API 文档,涵盖属性、变体选项、状态和无障碍要求。
  • 面向 React 的集成代码片段,包括 CSS 变量、Tailwind 主题配置和 styled-components。
  • 自带对比色的语义化颜色 token。
查看示例提示词 ↗

工作方式

  1. 01
    确定品牌色

    该工作流首先确定品牌主色,该文件要求以十六进制格式提供,因为所有生成的类别都由此派生而来。

  2. 02
    运行 Token 生成器

    一次脚本调用即可生成整套系统:它接受颜色、样式预设和输出格式这三个参数。

  3. 03
    将 Token 映射到组件层级

    组件按原子、分子、组织和模板进行组织,然后每一层都关联到它所使用的 token 组。

  4. 04
    设置断点与流体字号

    六个断点从 xs 到 2xl,流体字体大小通过最小值与最大值之间的 clamp 公式表达。

  5. 05
    将 Token 接入代码库

    交付工作流展示了直接导入 token 文件、基于该 JSON 构建的 Tailwind theme,以及读取 token 键值的 styled-components theme。

  6. 06
    同步 Figma 并完成交付确认

    Token 通过 Tokens Studio 插件导入 Figma,交付清单用于确认流水线、组件库和文档均已完成。

02 找到适合场景

何时使用 ui-design-system Skill

在 Claude Code 或 Codex 中处理此类品牌与设计系统工作时,使用 ui-design-system skill。适用范围和限制取自该 skill 自己的文件。

适合场景

  • 你只有一个品牌色,需要由它推导出一套完整的 token 系统。
  • 你在搭建组件库,希望将 token 映射到原子、分子、组织和模板上。
  • 你需要为你计算断点、流体字号比例或响应式间距值。
  • 你正准备将完成的 token 集合交付给开发团队。

了解边界

  • 样式预设不是深度换肤:主题选择主要影响字体族、默认圆角和阴影特征,例如现代风格圆角为 8px,而经典风格为 4px。

需要提供的信息

  • 一个样式预设从现代、经典或活泼三个方向中选择一个,因为预设会改变生成套件中的字体族、圆角和阴影处理方式。
  • 输出格式说明接收方项目使用哪种格式:json、css、scss 或摘要视图,因为这决定了交付产物的形式。

03 Skill 内部

ui-design-system Skill 为 Claude Code 和 Codex 提供的规则

SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

  1. 默认品牌色

    未传入颜色时,生成器会回退使用 #0066CC 作为主品牌色,因此即使没有十六进制参数,输出仍能正常渲染。

  2. 间距采用 8pt 网格

    间距 token 遵循基于 8pt 网格的比例,从 0 到 64,并在数字步长之上叠加语义别名。

  3. 不使用硬编码值

    组件实现必须只引用 design token;组件中出现的字面像素或十六进制值将被视为检查失败。

  4. 每种变体均需交付

    组件需要实现完整的变体集合——primary、secondary 和 ghost,而不是其中的一部分。

  5. 尺寸变体具有固定尺寸

    小尺寸定义为 32px 高度、12px 水平内边距和 14px 字号,md 和 lg 由此按比例扩展。

  6. 对比度必须满足 WCAG AA 标准

    生成的颜色会按普通文本 4.5:1、大号文本 3:1 进行校验,语义颜色必须定义对比度数值。

  7. 触控目标保持足够大

    在无障碍检查清单中,交互元素的触控目标必须达到 44×44 像素的最小尺寸。

04 投入使用

在 Claude Code 或 Codex 中安装 ui-design-system

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 ui-design-system 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/alirezarezvani/claude-skills --skill ui-design-system

用于 product-team/skills/ui-design-system/SKILL.md 的通用 skills CLI 形式;仓库可能会记录其自己的路径。

为 Skill 分配第一个品牌和 design-system 工作任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
We have settled on [#0066CC] as the brand primary and I need a complete token set for our SCSS codebase, exported as variables we can import. Please generate the tokens in the classic style, document the Button, Input and Card component APIs with their variants and states, and check that the semantic colors clear WCAG AA before we hand off to the developers.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 确认所有 token 类别都已生成,而不是只生成一部分。
  • 验证每个组件的 hover、active、focus 和 disabled 状态是否都真正可用。
  • 检查焦点指示器是否可见,并确认使用了语义化的 HTML 元素。
  • 确保在宣布交接完成之前,设计工具已完成同步。
  • 确认已配置构建流水线,使导出的 token 能够进入代码。

在 OpenDesign 中,通过 SKILL.md 链接导入 ui-design-system:Plugins → Add → Skill → Import from link,然后在顶部栏中选中它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Skill 文件
product-team/skills/ui-design-system/SKILL.md 验证时记录的内容校验和;commit 19392f7
License
MIT 来自 LICENSE。
仓库星标数
25,934 GitHub 快照拍摄于 2026-09-14,来自整个 alirezarezvani/claude-skills 仓库,该仓库在此目录中包含 5 个 skill。这不是 ui-design-system 的评分或使用量。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 触发词诸如 generate design tokens 这样的引号短语,会将请求路由到此 skill。
  2. 工作流四个编号工作流:token 生成、组件系统、响应式设计、开发者交接。
  3. 工具参考design_token_generator.py 的参数、默认值和输出类别,附带示例调用。
  4. 快速参考表色阶步进、1.25 排版比例、WCAG 级别以及样式预设之间的差异。
  5. 知识库四份参考指南:token-generation、component-architecture、responsive-calculations、developer-handoff。
  6. 验证清单针对 token 生成、组件系统、无障碍性和开发者交接的勾选列表。
Skill 自身的描述
"高级 UI 设计师的 UI 设计系统工具包,包括 design token 生成、组件文档、响应式设计计算和开发者交接工具。适用于创建设计系统、生成 design token、维护视觉一致性或促进设计-开发协作和开发者交接。"

来自 SKILL.md 的 Front-matter 描述。完整文件约 10,759 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 ui-design-system Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

运行生成器需要什么?

一个十六进制品牌色和一个样式选择,直接在命令行中与输出格式一起传入。文件中展示的调用示例,例如经典调色板配合 CSS 输出,因此不需要先配置其他任何内容。

我可以获得哪些输出格式?

JSON 是默认格式,同一脚本也可以写出 CSS 自定义属性、SCSS 变量或摘要视图。示例中将 SCSS 输出重定向到一个 partial 文件,以便直接导入。

Figma 同步是如何工作的?

你安装 Tokens Studio 插件并导入生成的 JSON,之后 token 会自动与 Figma 样式同步。同一套交付工作流也涵盖 React、Tailwind 和 styled-components 集成。

它按哪个对比度等级来处理?

参考表同时定义了 AA 和 AAA:AAA 要求正文文本达到 7:1,大号文本达到 4.5:1;而 AA 的目标更宽松,为 4.5:1 和 3:1。大号文本指至少 18pt 常规字重或 14pt 粗体。

UI Design System

在真实品牌和 design-system 工作任务上运行 ui-design-system。

下载 OpenDesign,从其 SKILL.md 链接导入 ui-design-system,粘贴上述提示,在结果前阅读计划。

终端
npx skills add https://github.com/alirezarezvani/claude-skills --skill ui-design-system

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows