跳转到使用指南
stitch::extract-design-md作者 Google Labs

Stitch Extract Design MD Skill.

Claude Code 和 Codex 的品牌和设计系统 skill:从任何框架的前端源代码中提取完整的 DESIGN.md。

  • Brand & Design Systems
  • DESIGN.md
google-labs-code/stitch-skills · plugins/stitch-design/skills/extract-design-md/SKILL.mdSKILL.md
--- name: stitch::extract-design-md description: - Extract a comprehensive design system (DESIGN.md) directly from frontend source code — React, Vue, Svelte, Angular, plain HTML/CSS, or any web framework. Analyzes component files, stylesheets, Tailwind configs, theme definitions, and design tokens to produce a rich, Stitch-compatible design system document. Use this skill whenever the user wants to reverse-engineer a design system from an existing codebase, audit … --- ## Why This Exists ## When to Use ## Prerequisites ## Workflow ## 1. Visual Theme & Atmosphere ## 2. Color Palette & Roles
前言和章节标题读取自 2026-09-14 的上游文件 · 完整 13,970 字符

01 功能说明

stitch::extract-design-md Skill 在 Claude Code 和 Codex 中做了什么

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

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

以 skill 自身的术语

这个 skill 读取前端代码库并写出一份 DESIGN.md,捕捉其视觉语言,而不构建或渲染应用。它通过 package.json 和配置文件检测框架(React、Vue、Svelte、Angular、Tailwind、CSS-in-JS、纯 CSS),然后依次梳理氛围、色彩调色板与角色、字体排印、组件样式、布局原则,以及供 Stitch 生成使用的备注。

输出落在 .stitch/DESIGN.md,且必须以带有 name 和 colors 映射的 YAML frontmatter 块开头,因为其他 skill 会解析它。面向对现有项目的设计系统进行逆向工程、审计或迁移的设计师和开发者。

它产出什么

  • 一份按标准设计系统格式组装的 DESIGN.md 文档。
  • 该文件顶部有一个带 name 和 colors 映射的 YAML frontmatter 块,随后是各个 markdown 章节。
  • 最后一部分是供 Stitch 生成使用的设计系统备注,涵盖语言、色彩引用和组件提示词。
查看示例提示词 ↗

工作方式

  1. 01
    检测框架和技术栈

    扫描项目根目录,查找 package.json、tailwind.config.js、postcss.config.js、theme.js 或 tokens.js 等标志性文件,然后读取 package.json 以了解框架、CSS 工具链和任何设计 token 库。

  2. 02
    阅读匹配的框架参考文档

    React/Next/Tailwind、Vue/Nuxt、Svelte、Angular 和纯 CSS 各有一份参考文件,包含针对特定框架的模式,用于定位颜色、字体排印和间距。

  3. 03
    提取色彩调色板并分配角色

    颜色来自 CSS 自定义属性、Tailwind 配置、主题文件、组件样式、局部作用域类和 CSS-in-JS 对象,随后按功能而非色调分组。

  4. 04
    分析组件和布局

    该 skill 会查看按钮、卡片、导航、输入框和特定领域的组件,以及网格、留白、对齐方式和响应式表现。

  5. 05
    写出 DESIGN.md

    所有内容按标准 DESIGN.md 格式组装,并写入一个 .stitch 目录(若不存在则创建)。

  6. 06
    可选:交给 Stitch 处理

    如果用户希望将设计系统推送到 Stitch,写好的 DESIGN.md 就会成为 manage-design-system skill 的输入。

02 找到适合场景

何时使用 stitch::extract-design-md Skill

当工作是此类品牌与设计系统任务时,在 Claude Code 或 Codex 中使用 stitch::extract-design-md skill。适用范围和限制来自该 skill 自身的文件。

适合场景

  • 您有一个前端代码库,希望从源代码中提取或记录其设计系统。
  • 该应用无法构建或渲染,但源文件是可用的。
  • 您想将项目现有的视觉标识迁移到 Stitch。
  • 代码库中的样式不一致,需要统一或协调。

了解边界

  • 这不是渲染后 HTML 的路线;那是独立的 design-md skill 从渲染后的 HTML 完成的工作。
  • 若无法访问前端项目的源代码目录,它就无法运行。

需要提供的信息

  • 主题或 token 文件(如果存在)指向 theme. 或 tokens. 文件能提供最权威的设计值来源。
  • 项目名称,以及已知的 ID文档标题使用项目名称;项目 ID 在可用时会包含进去,否则省略。
  • 是否推送到 Stitch 的决定如果用户希望将设计系统推送到 Stitch,工作流会在第 3 阶段之后继续进入集成交接环节。

03 Skill 内部

stitch::extract-design-md Skill 为 Claude Code 和 Codex 设定的规则

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

  1. YAML Frontmatter 是必需的

    文件必须以包含 name 和 colors 映射的 YAML 块开头,与 examples/DESIGN.md 保持一致。

  2. 按特质而非色相命名颜色

    每种颜色都会获得一个描述其外观特质的名称,因此 #294056 会变成“Deep Muted Teal-Navy”,而不是“Blue”。

  3. 合并近似重复的颜色

    像 #333 和 #2C2C2C 这样的近似重复颜色,会合并为最能代表预期颜色的那个单一名称。

  4. 从 Tailwind 配置开始

    经过自定义的 tailwind.config.js 会被视为设计系统本身,是最先提取的对象,之后再对组件进行覆盖项的抽查。

  5. 主题文件的优先级高于组件样式

    定义调色板的主题文件揭示了预期的设计系统,而分散的内联样式只能反映实际发布出来的内容。

  6. 将 CSS 自定义属性视为有意为之

    像 --brand-primary 这样的变量是刻意设计的 token,而不是偶然出现的值,应当被相应地对待。

  7. 用自然语言撰写 Stitch 说明

    生成说明用文字描述组件,而不是粘贴 CSS 语法或原始属性。

  8. 保留 Atmosphere 编辑风格

    atmosphere 部分以关于氛围与理念的编辑性文字写成,而非技术文档。

04 投入使用

在 Claude Code 或 Codex 中安装 stitch::extract-design-md

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

将 stitch::extract-design-md 添加到 Claude Code、Codex 或你的 Agent

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

Terminal
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::extract-design-md

针对 plugins/stitch-design/skills/extract-design-md/SKILL.md 的通用 skills CLI 形式;该仓库可能记录了自己的路径。

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

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

Starter prompt
Pull the design system out of [./src] for me — it's a Vue app with a theme.ts and some SCSS, and the dev server won't start right now. Group the colors by role, not by hue, give near-duplicates one descriptive name, and cover typography, buttons, cards, navigation and inputs. Write it to .stitch/DESIGN.md with the YAML frontmatter, and finish with a few Stitch generation prompts.

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

检查首次结果

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

  • 每种颜色都有描述性名称、十六进制代码和功能角色。
  • Typography 涵盖字体家族、字符描述和完整的层级结构。
  • 组件样式说明形状、颜色、状态和过渡效果。
  • Layout 说明最大宽度、网格、断点和间距策略。
  • 该文档捕捉的是样式背后的意图,而不仅仅是原始数值。

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

05 开源、可追溯

来源、许可与验证

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

Skill 文件
plugins/stitch-design/skills/extract-design-md/SKILL.md 验证时记录的内容校验和;提交 0337446
License
Apache-2.0 来自 LICENSE。
仓库星标数
8,304 GitHub 快照拍摄于 2026-09-14,针对整个 google-labs-code/stitch-skills 仓库,该仓库在此目录中包含 12 个 skills。不是 stitch::extract-design-md 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 存在的意义阅读源码比渲染后的 HTML 更快,并且在构建失败时依然可用。
  2. 何时使用触发场景:提取、记录、审查、迁移设计系统,统一不一致的样式。
  3. 前置条件仅需访问源目录;不需要构建或运行时依赖。
  4. 工作流四个阶段:项目发现、深度提取、编写 DESIGN.md、可选的 Stitch 集成。
  5. 质量核对清单用于验证颜色、typography、组件、layout、语言、去重和意图的检查项。
  6. 更好提取的建议挖掘代码注释,优先使用 token 库和主题文件,将 Tailwind 配置视为系统本身。
Skill 自身的描述
"- 直接从前端源代码(React、Vue、Svelte、Angular、纯 HTML/CSS 或任何 web 框架)提取全面的设计系统(DESIGN.md)。分析组件文件、样式表、Tailwind 配置、主题定义和 design token,生成丰富且与 Stitch 兼容的设计系统文档。当用户想要从现有代码库逆向工程设计系统、审查项目的视觉语言、从源文件提取 design token,或理解前端代码库的样式模式时使用此 skill——即使他们只是说「这个应用看起来是什么样的?」或「从这段代码中提取设计」。"

来自 SKILL.md 的前置描述。完整文件约 13,970 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 stitch::extract-design-md Skill 的常见问题

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

我需要先安装依赖或让应用可构建吗?

不需要。该 skill 仅读取源文件,不需要构建或运行时依赖,因此即使依赖缺失或构建失败也能正常工作。

它能处理哪些框架和样式配置?

React、Vue、Svelte、Angular、纯 HTML/CSS 以及任何 web 框架,包括 Tailwind 配置、CSS-in-JS 以及主题或 token 文件。特定框架的提取模式记录在它所参考的针对 React/Tailwind、Vue、Svelte、Angular 和纯 CSS 的参考文件中。

为什么 DESIGN.md 需要 YAML frontmatter?

该代码块以结构化数据的形式携带名称和颜色映射,供其他 skill 解析。省略它,或省略核心颜色 token,都属于未能正确使用该 skill。

它能把完成的设计系统推送到 Stitch 吗?

该步骤是可选的,由另一个 skill 处理:Phase 4 会交给 manage-design-system,由它以 DESIGN.md 为输入进行 MCP 的创建/更新调用。如果你只需要文档,工作在 Phase 3 之后即结束。

Stitch Extract Design MD

在真实的品牌与设计系统工作任务中运行 stitch::extract-design-md。

下载 OpenDesign,从其 SKILL.md 链接导入 stitch::extract-design-md,粘贴上方的提示,并在查看结果前先阅读计划。

终端
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::extract-design-md

OpenDesign 桌面客户端

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

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

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

支持 macOS 与 Windows