# Design System Extract

> 从品牌规范、代码库、现有网站、Figma 或截图中提取颜色、排版、间距、圆角、阴影、动效和断点等设计 token，并输出符合项目格式的结构化 token 文件。用户要求“提取设计系统”“整理 token”“匹配现有品牌”或从参考物反推视觉规范时使用；无法从来源确认的值不得猜测。

- Skill: `onevium/design-system-extract` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add onevium/design-system-extract`
- Raw SKILL.md: https://api.skillmd.com/api/skills/onevium/design-system-extract/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- License: MIT. See LICENSE.txt for full terms.
- Author: Onevium (https://skillmd.com/u/onevium)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/onevium/design-system-extract

---


# 提取设计系统 Token

从可验证来源提取现有视觉语言，让后续设计复用同一套规则。此 Skill 用于发现和结构化，不负责凭空创造品牌。

## 1. 确认来源

可能的来源包括主题文件、CSS 变量、Tailwind 配置、组件库、线上页面、截图、品牌 PDF 或 Figma。优先级通常为：明确的设计规范与 token 源码，其次是稳定组件实现，最后才是截图推断。

若来源未指定，先询问。记录每个值来自哪里；无法确认时标记缺口，不要补成“合理默认值”。

## 2. 按类别提取

- **颜色**：品牌主色与强调色、语义色、中性色阶、页面和组件表面、边框与遮罩；记录值、来源名称和用途。
- **排版**：字体家族与 fallback、字号、字重、行高、字距和已命名文本样式；只保留实际加载或明确定义的字重。
- **间距**：真实使用的尺度，以及内边距、行内、区块或组件间距是否分层。
- **圆角与阴影**：所有有效级别及完整 CSS 值，说明对应组件或层级。
- **其他**：动效时长与缓动、z-index、断点、容器宽度、图标尺寸等来源确实存在的 token。

把近似重复、不同色调的中性色阶和离群值列为发现，不要自行合并。

## 3. 输出项目原生格式

优先匹配现有格式与命名：`tokens.css`、带类型导出的 `tokens.ts`、`tokens.json`、SCSS 变量或 Tailwind 扩展。新项目默认可使用 `tokens.css`，按品牌、语义、中性、表面、排版、间距、圆角、阴影和动效分组。

所有名称应表达语义或稳定层级，避免把一次性页面位置写进全局 token。保留来源可追溯性，但不要把本机绝对路径或私有信息写入公开文件。

## 4. 交付报告

列出使用的来源、已提取类别、无法确认的缺口、近似重复或离群值，以及需要用户决定的合并项。不要把未决项静默写成最终规范。

## 示例

**输入：**“从这个 React 项目的主题和组件里提取设计 token。”

**输出：**读取主题、CSS 变量与核心组件后生成项目命名风格一致的 `tokens.ts`；报告发现两套近似蓝色和三个离散圆角值，保留原值并要求用户确认是否收敛。

## 来源与许可

本 Skill 基于 Trystan Sarrade 的 [claude-design-system-prompt](https://github.com/Trystan-SA/claude-design-system-prompt) 进行中文化与 Claude Skill 规范适配。上游与本改编均按 MIT License 发布，详见 [LICENSE.txt](./LICENSE.txt)。