跳转到使用指南
stitch::react-components作者 Google Labs

Stitch React Components Skill.

Claude Code 和 Codex 的 UI 设计 skill:将 Stitch 设计转换或同步为模块化 React + Vite 组件。

  • Web & UI
  • UI 代码
google-labs-code/stitch-skills · plugins/stitch-build/skills/react-components/SKILL.mdSKILL.md
--- name: stitch::react-components description: - Converts Stitch designs into modular Vite and React components, or syncs/updates existing React components to align with the latest Stitch designs, using system-level networking and AST-based validation. --- ## Phase 1: Retrieval and networking ## Phase 2: Style extraction ## Phase 3: Architectural rules ## Phase 4: Execution steps
前言和章节标题读取自 2026-09-14 的上游文件 · 完整 8,725 字符

01 功能说明

stitch::react-components Skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

该 skill 可将 Stitch 项目转换为模块化的 React 与 Vite 前端,或将现有 React 组件同步至最新的 Stitch 设计。它面向基于 Stitch 屏幕工作的前端工程师:Agent 先用 list_tools 找到 Stitch MCP 前缀,再用 get_screen 拉取每个屏幕,通过 scripts/fetch-stitch.sh 下载 HTML 与截图,将 tailwind.config 中的 token 提取到 resources/style-guide.json,然后构建组件、hooks 与模拟数据,并交由 AST 验证检查。

四个受门控的阶段强制执行这一顺序,npm run validate 会强制要求 Readonly Props 接口、使用主题 token 而非十六进制颜色值,以及不允许出现单体式页面文件。

它产出什么

  • 每个屏幕对应下载的设计素材,位于 .stitch/designs/{page}.html 与 .stitch/designs/{page}.png。
  • 一个 .stitch/metadata.json 文件,保存 projectId、title、deviceType、screens 映射以及 Last Sync Time 字段。
  • 一个被覆盖的 resources/style-guide.json 文件,携带当前项目的颜色、字体、间距、圆角和排版 token。
  • src/components 中的 React 组件、src/hooks 中的 hooks、src/data/mockData.ts 中的模拟数据,以及一个渲染它们的更新后入口文件。
查看示例提示词 ↗

工作方式

  1. 01
    找到 Stitch 命名空间

    运行 list_tools 来发现 MCP 前缀,然后在之后每次调用 Stitch 时复用该前缀。

  2. 02
    拉取每个页面的元数据

    对项目中的每个页面调用 get_screen,获取设计 JSON 及其下载链接,不遗漏任何页面。

  3. 03
    通过脚本下载

    内部 fetch 工具在访问 Google Cloud Storage 时可能失败,因此下载需通过提供的 bash 脚本进行,该脚本处理重定向和安全握手。

  4. 04
    提取设计 token

    打开每个下载的 HTML 文件,读取 head 脚本块中的 tailwind.config 对象,获取颜色、字体、间距、圆角和排版信息。

  5. 05
    根据模板起草组件

    以随附的组件模板为基础,在连接入口文件之前,重命名所有占位组件名称的实例。

02 找到适合场景

何时使用 stitch::react-components Skill

在 Claude Code 或 Codex 中,当任务涉及此类 UI 设计时,请使用 stitch::react-components skill。适用范围和限制取自该 skill 自己的文件。

适合场景

  • 你有 Stitch 设计,并希望得到干净、模块化的 React 代码,而不是一整个转换后的大页面。
  • 你已经有 React 组件,需要将其与最新的 Stitch 设计重新对齐。
  • 你正在搭建一个多页应用,每个 Stitch 页面都是一个独立页面,其中的占位链接需要替换为真实路由和可用的导航。
  • 你希望对生成的代码有自动化的质量关卡,而不是靠肉眼检查。

了解边界

  • 它不能部分运行。该 skill 声明每一步都是强制性的,每个部分都有一个必须满足才能继续的关卡。
  • 你不能直接给它已下载的设计 HTML 并跳过 MCP 获取阶段。
  • 它不会主动启动开发服务器或运行浏览器审计。
  • 生成的组件不应携带 Google 许可证头。

需要提供的信息

  • 关于现有本地设计文件的决定如果 .stitch/designs/{page}.html 和 .png 已经存在,系统会询问你是重新下载还是复用它们,该 skill 不会自行假定。
  • 验证步骤的许可在 npm run dev 启动或开始视觉浏览器审计之前,系统会先询问你。
  • 目标项目自身的约束组件方面的决定应遵循所构建的具体项目的需求,而不是通用布局。

03 Skill 内部

stitch::react-components Skill 给 Claude Code 和 Codex 的规则

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

  1. 每个组件都需要一个 Props 接口

    每个组件文件(包括页面)都必须声明一个以该组件命名的 Readonly TypeScript 接口。验证器会将缺少该接口的文件判定为失败。

  2. 不允许单体页面文件

    卡片、徽章、分页和搜索栏等可复用 UI 模式各自拥有独立文件,存放于 src/components 下;禁止用单一文件承载整个页面。

  3. 逻辑存放在 Hooks 中

    事件处理与业务逻辑迁移到 src/hooks 下的自定义 hook 中,例如分页逻辑放入 usePagination,筛选逻辑放入 useFilter。

  4. 禁止硬编码内容

    所有静态文本、图片 URL 和列表都应放在 src/data/mockData.ts 中,而不是写在组件文件内。

  5. 将占位 Hrefs 转换为路由

    Stitch 生成的界面自带 href="#" 链接,每一个都必须转换为指向正确路由的 React Router Link。

  6. 让 Logo 成为主页链接

    TopAppBar 的 logo 或标题必须是指向根路径的 Link,因为 Stitch 底部导航栏使用了 md:hidden,在桌面端不可见。

  7. 所有元素都要有 Theme Token 和暗黑模式

    颜色类应来自同步的样式指南,而不是任意的十六进制代码,并且每个颜色类都要带有 dark: 变体。

  8. 运行任何操作前先询问

    验证脚本、开发服务器和自动化浏览器审查只能在用户授权后才能运行。

04 投入使用

在 Claude Code 或 Codex 中安装 stitch::react-components

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

将 stitch::react-components 添加到 Claude Code、Codex 或你的 Agent

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

Terminal
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::react-components

针对 plugins/stitch-build/skills/react-components/SKILL.md 的通用 skills CLI 形式;该仓库可能会记录其自己的路径。

给 Skill 一个首次 UI 设计任务

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

Starter prompt
Convert the screens in my Stitch project [project name] into a modular React + Vite app. Use scripts/fetch-stitch.sh to download every screen, sync the Tailwind tokens into resources/style-guide.json, then split the layout into components under src/components with logic in src/hooks and content in src/data/mockData.ts. Wire all the href="#" navigation links to React Router routes with dark mode variants, and ask me before running validation or the dev server.

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

检查首次结果

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

  • 对 src/components 和 src/pages 中的每个 .tsx 文件运行 AST 验证器,以报告组件有效性。
  • 运行 tsc --noEmit,在宣布任务完成前确认 TypeScript 能够编译通过。
  • 将输出与随附的架构检查清单进行对比。
  • 查看每一张下载的截图,以确认设计意图和布局细节,而不是凭空假设。
  • 重新提取 token 后,确认样式指南中的主色、字体和间距与从 HTML 中提取的内容一致。
  • 依次点击导航项,确保每个导航项都指向正确的页面。

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

05 开源、可追溯

来源、许可与验证

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

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

SKILL.md 内部

  1. 阶段 1:检索与联网发现 MCP 前缀,抓取每个屏幕,通过脚本下载,审查截图,编写元数据。
  2. 阶段 2:样式提取从当前 HTML head 中提取 tailwind.config token,并覆盖共享的样式指南。
  3. 阶段 3:架构规则模块化文件、hooks、模拟数据、Props 接口、主题 token、路由与深色模式。
  4. 阶段 4:执行步骤安装、构建数据层、从模板起草、连接应用,然后进行可选的、经用户批准的验证。
  5. 故障排查修复抓取错误、验证失败、失效的导航链接以及过期的样式指南。
Skill 自身的描述
"- 将 Stitch 设计转换为模块化 Vite 和 React 组件,或同步/更新现有 React 组件以与最新 Stitch 设计保持一致,使用系统级网络和基于 AST 的验证。"

来自 SKILL.md 的前置元数据描述。完整文件约 8,725 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 stitch::react-components Skill 的常见问题

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

我已经下载过这些设计了。它会覆盖它们吗?

不会。当 .stitch/designs/{page}.html 和 .stitch/designs/{page}.png 已存在时,它会询问是要从 Stitch 项目刷新还是复用本地文件,并且只有在你确认后才会重新下载。

Stitch React Components

在真实 UI 设计任务上运行 stitch::react-components。

下载 OpenDesign,从其 SKILL.md 链接导入 stitch::react-components,粘贴上方提示,在结果前查看计划。

终端
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::react-components

OpenDesign 桌面客户端

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

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

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

支持 macOS 与 Windows