让编码 Agent 直接从零写一个前端页面,很多时候结果都挺微妙:代码结构看着还像那么回事,TypeScript 类型也写得工整,可页面一跑起来,总带着一股挥之不去的“AI 模板味”——千篇一律的紫蓝渐变、到处乱加的阴影圆角卡片、拉不开层次的字号对比,写到第三四个页面时,间距和配色就已经开始各管各的。

这种割裂感在偏重逻辑推理、但前端审美相对弱一些的 Agent(比如 GPT 系列)身上尤其明显。它们擅长拆架构、写状态管理、排查 Bug 和对接后端接口,却并不擅长凭空拿捏视觉比例和色彩氛围。与其在代码里反复用文字指挥它“按钮再收窄一点”“卡片不要那么重”,更合理的做法是把视觉设计和工程实现拆开:让 Google Stitch[1]Google Stitch参考资料 负责界面探索与设计系统,再通过 Stitch MCP 和 Stitch Skills 把定稿交给编码 Agent 落地。

为什么把设计和写代码拆开,效果会好很多

在没接入专门的设计工具前,编码 Agent 写前端本质上是在“凭空盲写 CSS”——一边想业务结构,一边靠语言模型猜测什么样的布局和色板顺眼。接入 Stitch MCP 后,这套分工就彻底变了:

对比维度让编码 Agent 直接盲写 UIStitch MCP + Stitch Skills 分工协作
视觉与排版下限高度依赖当前模型的审美,容易出“模板味”由 Stitch 专职完成布局、配色层次与留白节奏
编码 Agent 的输入模糊的自然语言需求高清设计截图 + 对应 Tailwind HTML + DESIGN.md 规范
多方案试错成本写 3 套前端代码再对比,耗时且返工重几分钟出 3–5 版视觉变体挑定稿,只写 1 套代码
多页风格一致性写到第 5 页之后容易漂移统一复用项目 Design System 与 .stitch/DESIGN.md

对 GPT 这类工程能力强、但审美偏弱的 Agent 来说,这种变化的收益是立竿见影的。

一方面,它不再需要自己硬憋配色和版式,视觉下限直接由 Stitch 兜住;另一方面,它的任务从“凭空创作好看的界面”变成了“对照设计截图、HTML 结构和 Token 规范做模块化重构”——拆分组件、补齐 TypeScript 接口、整理 Hooks、排查编译错误、对接后端 API,全都是它最擅长的活。

编码 Agent 盲写 UI 与 Stitch 视觉工程分工对比
编码 Agent 盲写 UI 与 Stitch 视觉工程分工对比

Stitch MCP 和 Stitch Skills 分别管什么

很多人刚接触时会把这两个东西混在一起,其实它们是上下层配合关系:

  • Stitch MCP 是底层能力接口。Google Stitch 官方提供了远程 Streamable HTTP 服务端点 https://stitch.googleapis.com/mcp[2]Stitch MCP 配置文档参考资料,暴露了十几个原子工具,覆盖项目管理(create_project / list_projects)、文生页面(generate_screen_from_text)、多版变体生成(generate_variants)、局部改图(edit_screens)、设计系统管理(create_design_system_from_design_md / apply_design_system)以及文件下载(download_file)。
  • Stitch Skills 是工作流和工程约束。Google Labs 开源的 google-labs-code/stitch-skills[3]google-labs-code/stitch-skills参考资料 遵循 Agent Skills 开放标准[4]Agent Skills 开放标准参考资料,主流支持 MCP 与 Skills 的编码 Agent 都可以直接使用。每个 Skill 不仅有步骤说明 SKILL.md,还带校验脚本、规范清单和模板,用来约束 Agent 按固定顺序拉图、提取 Token、拆分组件和做编译检查,避免每次自由发挥漏掉关键步骤。
查看 stitch-skills 的 3 个插件包与 16 个 Skill

仓库把 16 个 Skill 划进了三个插件包,分别对应设计、转码和提效三段流程:

1. stitch-design(设计工作流,6 个)

  • stitch::generate-design:文生图/图生 UI、修改已有页面、生成多套风格变体。
  • stitch::code-to-design:把已有前端代码转成 Stitch 设计稿(自动串联静态 HTML 提取、设计规范提取与上传)。
  • stitch::extract-design-md:扫描前端源码,提取设计系统到 .stitch/DESIGN.md。
  • stitch::manage-design-system:上传 DESIGN.md 并将统一主题批量应用到 Stitch 页面。
  • stitch::extract-static-html:把本地运行中的网页抓成内联 CSS 与图片的单文件静态 HTML。
  • stitch::upload-to-stitch:上传本地图片、原型或 HTML 到指定 Stitch 项目。

2. stitch-build(设计稿转工程代码与演示,5 个)

  • stitch::react-components:把 Stitch 页面转为带自动校验和设计 Token 一致性的 React 组件体系,支持同步后续设计改动。
  • stitch::react-native:将设计稿转为带 StyleSheet 和平台适配的 React Native 组件。
  • react-vite-dashboard:面向数据密集型仪表盘的 React + Vite + TanStack Query 转换方案。
  • shadcn-ui:接入与定制 shadcn/ui 组件的实践指南。
  • remotion:用 Remotion 为 Stitch 项目生成带平滑缩放和转场的产品演示视频。

3. stitch-utilities(提示词、规范与整站循环,5 个)

  • enhance-prompt:把模糊的界面想法改写成富含 UI/UX 关键词、适合 Stitch 生成的提示词。
  • design-md:分析现有 Stitch 项目,反向生成语义化的 DESIGN.md。
  • taste-design:生成反“AI 模板味”、强调排版与色彩校准的高质感 DESIGN.md。
  • site-md:把需求简报整理成站点规约 .stitch/SITE.md,用于驱动多页构建。
  • stitch-loop:基于单条提示词循环生成并校验完整多页面网站。
Stitch MCP 与 Stitch Skills 三层协作架构
Stitch MCP 与 Stitch Skills 三层协作架构

它产出的是原型,还是能接后端的 React 前端?

准确说,它处在这两者中间,但已经足够作为正式前端的起点。

以 stitch::react-components 为例,它不是把 Stitch 导出的静态 HTML 原样塞进项目,而是强制按工程规范重构:

  • 组件与类型:按复用单元拆进 src/components/ 和 src/pages/,为每个组件补全只读 TypeScript Props 接口,并用脚本跑 AST 校验和 tsc --noEmit。
  • 样式与路由:从设计稿提取 Tailwind Token(支持 dark: 暗黑模式),不硬编码色值;把原生 HTML 里的 href="#" 占位链接全部换成真实 React Router <Link> 路由。
  • 逻辑与数据解耦:交互状态抽到 src/hooks/,页面文本和列表数据统一放到 src/data/mockData.ts,避免把假数据写死在组件里。

组件库方面,Stitch 本身不绑定私有 UI 库,默认产出纯 React + Tailwind CSS 组件。需要弹窗、下拉菜单、日期选择、复杂表格等高交互组件时,可以直接搭配官方内置的 shadcn-ui Skill 接入 shadcn/ui[5]shadcn/ui 官方文档参考资料;如果团队已有固定技术栈(例如 Ant Design 或 MUI),也可以只借用 Stitch 的页面布局和 DESIGN.md 主题变量,在转码阶段显式指定映射到对应组件库。

它默认不包含真实接口地址、登录鉴权、权限守卫和复杂提交校验——这些仍然需要结合你的后端来补。但因为 UI 组件、Hooks 和 Mock 数据从一开始就是分开的,后续接后端时只需要把 mockData.ts 和 hooks/ 换成真实请求,不用推倒重写界面。

怎么接入:配置 MCP 与安装 Skills

Stitch 官方直接托管了远程 Streamable HTTP MCP 服务,不需要额外装第三方代理,只要在支持远程 HTTP MCP 的 Agent 客户端配置里加上服务端点和认证信息即可。

先登录 Google Stitch,进入 Stitch Settings → API Keys 生成密钥,然后在 Agent 客户端的 MCP 配置文件中添加:

1
2
3
4
5
6
7
8
9
10
{
"mcpServers": {
"stitch": {
"url": "https://stitch.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_STITCH_API_KEY"
}
}
}
}

不同 Agent 客户端的配置文件位置与远程地址字段名略有差异(常见为 url 或 serverUrl),按所用客户端的远程 HTTP MCP 规范填入即可。

如果希望免去配置里的明文密钥,可以通过 Google Cloud CLI 完成授权并启用 Stitch MCP 服务:

1
2
3
4
5
gcloud auth login
gcloud config set project YOUR_PROJECT_ID
gcloud auth application-default login
gcloud auth application-default set-quota-project YOUR_PROJECT_ID
gcloud beta services mcp enable stitch.googleapis.com

随后在支持 Google ADC 凭据提供方的 Agent MCP 配置中指向 https://stitch.googleapis.com/mcp 并启用 Google 凭据认证。

Stitch 生成或编辑页面往往需要数十秒到数分钟,建议在客户端里把该 MCP Server 的调用超时调高(例如 600 秒),避免生成中途断连。另外,含明文 API Key 的配置优先放在用户级全局目录,不要提交到 Git 仓库。

配好 MCP 并确认工具列表加载成功后,就可以按需安装 Skills:

1
npx skills add google-labs-code/stitch-skills

日常做产品前端,不必一次全装,先挑核心的几个就够用:site-md、taste-design、design-md、enhance-prompt、stitch::generate-design、stitch::react-components,有复杂表单或数据后台需求再补上 shadcn-ui 和 react-vite-dashboard。

一套顺手的端到端落地流程

把官方推荐的 Design-First 思路和实际踩坑经验揉在一起,从零把一个产品想法做成可对接后端的 React 前端,按下面 6 步走最不容易返工。

从产品想法到真实后端的 6 步前端落地流程
从产品想法到真实后端的 6 步前端落地流程

1. 先收敛需求,定好 SITE.md 和 DESIGN.md

不要把一句“帮我做一个好看的管理后台”直接扔给 Stitch。先整理清楚四件事:产品给谁用、目标端型(Desktop Web 还是 Mobile)、3–6 个核心页面清单(并指定 1 个最具代表性的核心页),以及偏好的视觉调性或参考图。

让 Agent 基于这些信息先落两份文件到 .stitch/ 目录:

  • .stitch/SITE.md:记录产品定位、Stitch Project ID、页面清单(Sitemap)与优先级;
  • .stitch/DESIGN.md:用语义化语言描述配色角色、字体层级、留白策略和组件质感。如果不想落入常规 AI 模板风,起稿阶段可以用 taste-design 先拉高审美基准。

2. 只拿 1 个核心页出多版变体,选定视觉方向

先在 Stitch 里建项目,用 enhance-prompt 润色核心页提示词后调 generate_screen_from_text 出一版基准稿,再调 generate_variants 一次生成 3–5 个方案。

generate_variants 可以控制两个很实用的参数:一是发散幅度(REFINE 微调、EXPLORE 平衡探索、REIMAGINE 大幅重构),二是变化维度(LAYOUT、COLOR_SCHEME、TEXT_FONT、IMAGES、TEXT_CONTENT)。

这一步不需要来回切换工具:你可以全程在 Agent 对话里驱动,让它把高清截图拉回本地查看;如果想把 3–5 张画板并排放大对比,或者用鼠标框选某个区块局部改,也可以随时顺手点开 Stitch 网页画布。两边连的是同一个云端项目,状态实时同步。

3. 锁定 Design System,再批量铺开其余页面

核心页定稿后,立刻把它的视觉规范固定成项目里的 Design System,并同步更新本地 .stitch/DESIGN.md(可用 npx @google/design.md lint DESIGN.md 校验格式)。

之后再按 SITE.md 生成登录、列表、详情、设置等其余页面,每次生成统一复用同一个 designSystem。这样整站配色、圆角、字号和组件密度就会自然对齐,不会出现“一页一个画风”。如果做的是偏展示型的多页官网,这一步也可以直接启用 stitch-loop,靠 .stitch/next-prompt.md 接力文件逐页批量跑完。

4. 转成模块化 React 工程并本地走查

所有核心页面在 Stitch 里定稿后,再进入编码阶段。调用 stitch::react-components(或 react-vite-dashboard + shadcn-ui)把页面拉取并转换为 Vite + React + TypeScript + Tailwind 项目,跑通 tsc --noEmit 和本地开发服务,在浏览器里把页面路由、暗黑模式和响应式布局完整点一遍。

5. 替换 Mock 层,对接真实后端接口

界面和静态交互验收通过后,把后端接口文档(OpenAPI / Swagger 或后端源码)交给 Agent,把 src/data/mockData.ts 和 src/hooks/ 替换为真实 API 请求(例如 axios / fetch 搭配 TanStack Query),再补齐鉴权、路由守卫、表单校验、加载骨架屏和异常提示。

6. 后续迭代与老项目逆向改版

上线后如果需要加新页面或改版,仍然回到同一个 Stitch 项目复用既有 designSystem 生成或修改,再增量同步回现有 React 组件。如果是已有老项目想重新做视觉升级,也可以反向走 stitch::code-to-design——抓取本地运行页面的静态 HTML 并提取 DESIGN.md 上传到 Stitch,在画布里出几版改版方案选优,再同步回代码库。

这套流程有三条最值得守住的边界:

  1. 先定 1 页,再铺全站:核心页风格没定型前,不要一次性生成所有页面。
  2. 先定视觉,再写工程:布局、信息密度和配色尽量在 Stitch 阶段收敛,定稿后再转 React,减少在代码里反复返工改样式。
  3. 动态交互仍由编码 Agent 主导:Stitch 解决的是视觉排版和设计语言,像复杂联动表单、拖拽排序、乐观更新和边界异常状态,还是要在转成 React 之后由编码 Agent 扎实补齐。

一次完整实战:用这套流程做出「行笺 · Vellum」

为了验证上面这套流程在真实项目里的落地效果,我用一次完整对话让 Agent 跑通了从需求澄清到上线发布的全过程,做了一个 Desktop Web AI 智能旅行计划纯前端工作台——行笺 · Vellum[6]行笺 · Vellum GitHub 仓库参考资料。

这是一个纯前端实践项目:不接真实数据库和线上大模型,默认通过 VITE_USE_MOCK=true 在前端内存与浏览器 localStorage 里完成模拟 SSE 流式生成、增删改查、拖拽排序和 AI 局部修订演示;同时基于同一套 TypeScript 领域类型产出了字段 100% 对齐的 OpenAPI 3.1 契约,并在站内直接挂载了交互式 API 文档页。

1. 先做 2 轮轻量澄清,立住规约再动图

起手没有直接让 Agent 生图,而是先用 /grill-me 做了 2 轮共 8 个关键决策,把会影响页面范围、核心交互、视觉方向和后端接口结构的分支提前收敛:

  • 页面范围:聚焦 4 个核心屏——灵感与意图入口页(/)、行程规划主工作台(/trips/:tripId)、我的行程库(/trips)和公开只读分享页(/share/:shareToken)。
  • AI 交互范式:跳过大段文字问答,改为创建阶段 SSE 流式逐日生成,工作台内支持手工拖拽节点与对话式局部修订(在时间轴原位渲染 Diff 提案,确认后合并并支持单步撤销)。
  • 视觉基调:用 taste-design 起草 .stitch/DESIGN.md,定调为暖纸编辑风(画布 #F7F5F0 + 炭墨 #1C1B18 + 唯一低饱和深松林绿 #2C5E4F),显式封禁紫蓝霓虹、Emoji、居中 Hero、三列均等特性卡与虚构指标墙。
  • 数据与契约边界:同步生成 .stitch/SITE.md 与 .stitch/DATA_MODEL.md,提前统一 /api/v1 REST 直出、RFC 7807 ProblemDetail 错误体和 version 乐观锁。

2. 核心页 1 基准 + 3 变体选型,几分钟锁定方向

规约确认后,先在 Stitch 建项目并同步 .stitch/DESIGN.md 为项目 Design System,但只生成信息密度最高的「行程规划主工作台」基准稿;接着调用 generate_variants(creativeRange: EXPLORE,聚焦 LAYOUT 与 COLOR_SCHEME),拉出 4 张 2560 × 2048 高清图并排对比:

  • 基准稿(最终定稿):暖纸白 + 深松林绿,左时间轴(44%)+ 中路线地图 + 右常驻 AI 副驾,视图切换、原位 Diff 与撤销入口最齐全。
  • 变体 1(制图优先宽幅版):矿石浅灰 + 深石板蓝,70% 宽幅主地图 + 底部横向 AI 栏,地图视野极佳但缺少预算与清单切换位。
  • 变体 2(三栏典藏书志版):宣纸暖白 + 暖陶土赤,极细左天数轨 + 居中阅读列 + 右侧上下堆叠地图与 AI,阅读呼吸感强但右上地图高度偏紧。
  • 变体 3(暮色夜航工坊版):深炭灰黑 + 暖砂赭石,暗色航图视觉辨识度高,但顶部二级工具栏存在轻微挤压。
行程规划主工作台基准稿与 3 个 EXPLORE 变体 2x2 对比
行程规划主工作台基准稿与 3 个 EXPLORE 变体 2x2 对比

几分钟看清 4 个方向的取舍并锁定基准稿,没有写一行作废的前端代码。

3. 回写 Design System,复用同套规范铺开全站 4 屏

基准稿定稿后,从导出 HTML 中核对实际表面色阶与组件圆角,回写更新 .stitch/DESIGN.md 与 Stitch 项目的 Design System,随后严格复用同一 designSystem 依次生成「灵感与意图入口页」「我的行程库」与「公开只读分享页」,全站 4 屏在配色、细线排印和时间轴语言上自然对齐:

复用同一套 Design System 生成的全站 4 个核心页面一致性对比
复用同一套 Design System 生成的全站 4 个核心页面一致性对比

4. 转成模块化 React 工程并收口 OpenAPI 契约

设计定稿后,调用 stitch::react-components 搭配 shadcn-ui 生成 web/ 下的 Vite + React + TypeScript + Tailwind 项目,再完成纯前端交付收口:

  • 组件与交互补齐:用 shadcn/ui(Radix)实现分享设置/登录/节点编辑弹窗(Dialog)、出发日期选择器(Popover + Calendar)、响应式抽屉(Sheet)与状态下拉菜单(DropdownMenu);全部 40 个 TSX 组件和页面通过 SWC AST 校验(强制只读 Props 接口、零硬编码 hex 色值)和 tsc --noEmit。
  • 零 Key 可演示与双模式 Service 层:路线地图采用自定义 WGS-84 暖纸矢量图(与时间轴双向高亮并绘出 AI 备选虚线路线)+ 可选 Leaflet 实时瓦片切换;数据层按领域拆分为 src/types/ 与 src/services/,默认 VITE_USE_MOCK=true 开箱演示,改为 false 即可无改动对接真实 /api/v1。
  • 同源 OpenAPI 3.1 与线上部署:基于同一套类型与 httpTravelService.ts 输出 docs/openapi.yaml(22 条路径、26 个操作、64 个 Schema)与 docs/api-spec.md,通过 Vite 插件同步挂载到 /api-docs 与 /docs/openapi.yaml,并配置 GitHub Actions 自动部署至 GitHub Pages[7]行笺 · Vellum 在线演示参考资料。
查看本次 5 步实战的完整 Prompt 驱动序列(可直接复用改造)

下面 5 条指令就是本次对话从立项到收口的真实驱动序列,去掉业务细节即可套用到其他 Desktop Web 产品:

Step 1 · 轻量需求澄清与立规约(grill-me + site-md + taste-design)

1
2
3
4
5
6
7
8
9
/grill-me 我想设计一个 Desktop Web「AI 智能旅行计划网站」,最终交付物是:
1)一套可运行的模块化 React 前端(内置可演示的 Mock 与标准 Service 接口层);
2)一份与前端类型完全对齐、给后端看的 API 接口文档(Markdown + OpenAPI)。

请先对我做轻量需求澄清:
- 最多追问 2 轮,每轮不超过 4 个问题;
- 只问会影响「页面范围、核心交互、视觉方向、或后端接口结构」的关键决策;
- 每个问题请给出你的推荐选项,其余细枝末节按常规直接替我做默认决定;
- 澄清结束后立刻停止追问,使用 site-md 和 taste-design 生成 .stitch/SITE.md、.stitch/DESIGN.md 以及核心数据实体草案(反 AI 模板味),先不要生图,等我确认。

Step 2 · 建项目、同步 Design System 并探索核心页 1 基准 + 3 变体(enhance-prompt + stitch::generate-design)

1
2
3
4
5
规范确认没问题。请使用 enhance-prompt 和 stitch::generate-design:
1. 在 Stitch 中创建新项目,并将 .stitch/DESIGN.md 同步为项目的 Design System;
2. 先只生成核心页「行程规划主工作台」(DESKTOP 端)的基准稿;
3. 基于基准稿调用 generate_variants 生成 3 个变体(creativeRange 用 EXPLORE,重点探索 LAYOUT 和 COLOR_SCHEME);
4. 下载基准稿和 3 个变体的高清截图给我对比挑选。

Step 3 · 锁定方向回写规范,复用同套 Design System 铺开其余页面

1
2
核心页定稿了,最终方向是基准。请把当前定稿页的视觉规范同步更新到项目 Design System 和 .stitch/DESIGN.md。
接着严格复用同一套 Design System,按 .stitch/SITE.md 依次生成其余页面,每页拉取高清截图给我确认风格一致性。

Step 4 · 转换为模块化 React + shadcn/ui 前端并校验启动(stitch::react-components + shadcn-ui)

1
2
3
4
5
6
所有设计稿均已定稿。请使用 stitch::react-components,并搭配 shadcn-ui 处理弹窗、日期选择、抽屉和下拉菜单等交互组件,
把当前 Stitch 项目中的所有页面转换成 Vite + React + TypeScript + Tailwind 前端项目,放到 web/。
要求:
- 组件按职责拆到 src/components/ 和 src/pages/,打通 React Router 路由
- 静态示例数据先抽离到 src/data/mockData.ts,页面状态抽到 src/hooks/
- 通过 tsc --noEmit 和组件校验后,帮我验证本地可正常启动。

Step 5 · 领域类型、Mock/HTTP Service 层与 OpenAPI 契约收口

1
2
3
4
前端页面验收通过。现在进入交付收口,不需要接真实后端:
1. 根据所有页面的真实交互,把 src/data/mockData.ts 重构为规范的领域类型(src/types/)和接口服务层(src/services/),通过 VITE_USE_MOCK=true 支持本地完整交互演示(包括模拟 AI 流式生成行程、增删改查和筛选);
2. 基于同一套 TypeScript 类型和服务层,生成给后端开发看的接口文档 docs/api-spec.md 和 docs/openapi.yaml(含鉴权约定、请求/响应 JSON 示例、流式输出格式、分页与错误码规范),确保前端调用与 API 文档字段 100% 一致;
3. 再次运行 tsc --noEmit 和构建检查确认无报错。

这次实战里最直观的三点体会

  1. 反模板约束写在 DESIGN.md,生成提示词别重复堆色值:用 taste-design 提前写死单主色和反 AI 模板禁令,首版出图观感就稳住了;而在调 generate_screen_from_text 时,让项目级 designSystem 管色彩字体、提示词专注布局与真实中文内容,生成一致性更稳。
  2. 多屏难免有细微漂移,留到 React 转码阶段一次收口最省力:即便复用同一个 Design System,后两屏设计稿仍会出现少量中文衬线标题或静态地图浮窗边缘略裁。没必要在 Stitch 里死磕像素级完美——版式和色阶定住后,进 React 用共享 <AppHeader />、统一 Tailwind Token 和真实坐标投影就能一次性拉齐。
  3. 纯前端交付带上同源 OpenAPI 与 /api-docs,才算真正可交接:如果只交一包写死假数据的页面,后端联调时还要返工对字段;把领域类型、VITE_USE_MOCK 双模式 Service 和 openapi.yaml 同步收口,甚至直接挂进站内 /api-docs,前端验收完成的那一刻,后端契约也就齐活了。

说到底,Stitch MCP 加上 Stitch Skills 干的是一件很朴素的工程事——让擅长画图的管审美,让擅长写代码的管架构和业务。无论你平时主力用的是哪款编码 Agent,只要把 .stitch/DESIGN.md 这份契约立住,前端页面的视觉下限和工程可维护性都能同时往上提一截。

参考资料