跳转到使用指南
design-system-patterns作者 Seth Hobson

Design System Patterns Skill.

Claude Code 和 Codex 的品牌和设计系统 skill:可扩展的设计系统,包含 token、主题基础架构和组件架构。

  • Brand & Design Systems
  • 设计系统
wshobson/agents · plugins/ui-design/skills/design-system-patterns/SKILL.mdSKILL.md
--- name: design-system-patterns description: Build scalable design systems with design tokens, theming infrastructure, and component architecture patterns. Use when creating design tokens, implementing theme switching, building component libraries, or establishing design system foundations. --- ## When to Use This Skill ## Core Capabilities ## Quick Start ## Detailed patterns and worked examples ## Best Practices
从 2026-09-14 的上游文件读取的前言和章节标题 · 完整 4,003 字符

01 功能说明

design-system-patterns skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

该 skill 通过设计 token、主题基础设施和组件架构模式来构建可扩展的设计系统。它创建三层 token 层级结构——原始值层的 primitive token、承载语境意义的 semantic token,以及特定用法的 component token——然后使用 CSS custom properties 和 React context provider 实现主题切换。

该 skill 处理面向 CSS、iOS 和 Android 的多平台 token 生成,借助 Style Dictionary 建立 Figma 到代码的工作流,并使用复合组件、多态组件、variant、slot 和 headless UI 模式来构建组件库架构。它可检测 prefers-color-scheme 等系统偏好以及减少动态效果模式。

它产出什么

  • 为 CSS、iOS 和 Android 生成的多平台 token 文件
  • 具备 variant 与尺寸体系的组件库
  • 设计系统文档与规范指南
查看示例提示词 ↗

工作方式

  1. 01
    定义 Primitive Token

    为颜色、尺寸和字体创建原始值 token,作为基础层。这些是十六进制代码和像素度量等字面值。

  2. 02
    构建 Semantic Token 层

    引用 primitive token 来创建具有语境意义的 token,如 text-primary、surface-elevated 和 border-default,它们承载意义而非视觉描述。

  3. 03
    创建特定组件的 Token

    为特定组件用法定义 token,例如 button-bg 和 card-border,它们引用 semantic token。

02 找到适合场景

何时使用 design-system-patterns Skill

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

适合场景

  • 为颜色、排版、间距和阴影创建 design token
  • 使用 CSS 自定义属性实现亮色/暗色主题切换
  • 构建多品牌主题系统
  • 设计具有一致 API 的组件库架构
  • 使用 Figma token 建立从设计到代码的工作流

了解边界

  • 存在网页 token 但缺少移动端 token(或反之)的平台差异

03 Skill 内部

design-system-patterns Skill 为 Claude Code 和 Codex 设定的规则

1 SKILL.md 为 Agent 设定的具体指令、默认值和限制 —— 文件中真正影响结果的部分。

  1. 使用语义化版本管理 Token

    将 token 变更视为 API 变更,采用语义化版本控制。Token 修改对下游应用的影响与 API 变更相同。

04 投入使用

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

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

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

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

Terminal
npx skills add https://github.com/wshobson/agents --skill design-system-patterns

针对 plugins/ui-design/skills/design-system-patterns/SKILL.md 的通用 skills CLI 形式;仓库可能会另行说明其自身路径。

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

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

Starter prompt
Build a design token system for [our SaaS dashboard] with light and dark themes. Create the three-tier token hierarchy (primitive, semantic, component) for colors, typography, and spacing. Implement CSS custom properties and a React theme context provider with system preference detection and persistent storage. Generate tokens for both web and React Native using Style Dictionary, and set up the compound component pattern for our Button and Card components with size and variant props.

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

检查首次结果

在接受输出之前,在记录和文件中查找以下内容:

  • 结果以设计系统的形式交付,如本目录为该 skill 列出的。
  • Agent 在生成结果之前,会在其计划或记录中提及 design-system-patterns skill。
  • 您自己的内容、名称和数字在输出中保持不变。

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

05 开源、可追溯

来源、许可与验证

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

Repository
github.com/wshobson/agents 分支 main
Skill 文件
plugins/ui-design/skills/design-system-patterns/SKILL.md 验证时记录的内容校验和;commit 4236bb9
License
MIT 来自 LICENSE。
仓库星标数
39,635 2026-09-14 为整个 wshobson/agents 仓库拍摄的 GitHub 快照,该仓库包含目录中的 18 个 skills。不是 design-system-patterns 的评分或使用次数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 何时使用此 Skill列出适用于设计 token、主题化、多品牌系统、组件库以及 Figma 工作流的场景
  2. 核心能力详述设计 token、主题化基础设施、组件架构以及 token 流水线能力
  3. 设计 Token定义原始、语义和组件三层 token,包含命名规范与多平台生成方式
  4. 主题化基础设施涵盖 CSS 自定义属性、React context、动态切换、系统偏好设置以及无障碍模式
  5. 组件架构描述复合组件、多态模式、变体、slot、headless UI 以及样式 props
  6. Token 流水线说明 Figma 同步、Style Dictionary 配置、转换规则以及 CI/CD 集成
  7. 快速开始提供原始与语义 token 结构配合 CSS 自定义属性的 TypeScript 示例
  8. 最佳实践列出七条规则:语义命名、层级结构、文档化、版本管理、测试、自动化、迁移
  9. 常见问题警示 token 泛滥、命名不一致、缺失深色模式、硬编码值、循环引用、平台差异等问题
Skill 自身的描述
"构建可扩展的设计系统,包含 design token、主题基础设施和组件架构模式。在创建 design token、实现主题切换、构建组件库或建立设计系统基础时使用。"

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

Design System Patterns

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

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

终端
npx skills add https://github.com/wshobson/agents --skill design-system-patterns

OpenDesign 桌面客户端

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

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

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

支持 macOS 与 Windows