让编码 Agent 直接从零写一个前端页面,很多时候结果都挺微妙:代码结构看着还像那么回事,TypeScript 类型也写得工整,可页面一跑起来,总带着一股挥之不去的“AI 模板味”——千篇一律的紫蓝渐变、到处乱加的阴影圆角卡片、拉不开层次的字号对比,写到第三四个页面时,间距和配色就已经开始各管各的。
这种割裂感在偏重逻辑推理、但前端审美相对弱一些的 Agent(比如 GPT 系列)身上尤其明显。它们擅长拆架构、写状态管理、排查 Bug 和对接后端接口,却并不擅长凭空拿捏视觉比例和色彩氛围。与其在代码里反复用文字指挥它“按钮再收窄一点”“卡片不要那么重”,更合理的做法是把视觉设计和工程实现拆开:让 Google Stitch[1]Google Stitch参考资料 负责界面探索与设计系统,再通过 Stitch MCP 和 Stitch Skills 把定稿交给编码 Agent 落地。
为什么把设计和写代码拆开,效果会好很多
在没接入专门的设计工具前,编码 Agent 写前端本质上是在“凭空盲写 CSS”——一边想业务结构,一边靠语言模型猜测什么样的布局和色板顺眼。接入 Stitch MCP 后,这套分工就彻底变了:
| 对比维度 | 让编码 Agent 直接盲写 UI | Stitch 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,全都是它最擅长的活。

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:基于单条提示词循环生成并校验完整多页面网站。

它产出的是原型,还是能接后端的 React 前端?
准确说,它处在这两者中间,但已经足够作为正式前端的起点。
以 stitch::react-components 为例,它不是把 Stitch 导出的静态 HTML 原样塞进项目,而是强制按工程规范重构:
- 组件与类型:按复用单元拆进
src/components/和src/pages/,为每个组件补全只读 TypeScriptProps接口,并用脚本跑 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 | { |
不同 Agent 客户端的配置文件位置与远程地址字段名略有差异(常见为 url 或 serverUrl),按所用客户端的远程 HTTP MCP 规范填入即可。
如果希望免去配置里的明文密钥,可以通过 Google Cloud CLI 完成授权并启用 Stitch MCP 服务:
1 | gcloud auth login |
随后在支持 Google ADC 凭据提供方的 Agent MCP 配置中指向 https://stitch.googleapis.com/mcp 并启用 Google 凭据认证。
配好 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 步走最不容易返工。

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,在画布里出几版改版方案选优,再同步回代码库。
一次完整实战:用这套流程做出「行笺 · 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/v1REST 直出、RFC 7807ProblemDetail错误体和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(暮色夜航工坊版):深炭灰黑 + 暖砂赭石,暗色航图视觉辨识度高,但顶部二级工具栏存在轻微挤压。

几分钟看清 4 个方向的取舍并锁定基准稿,没有写一行作废的前端代码。
3. 回写 Design System,复用同套规范铺开全站 4 屏
基准稿定稿后,从导出 HTML 中核对实际表面色阶与组件圆角,回写更新 .stitch/DESIGN.md 与 Stitch 项目的 Design System,随后严格复用同一 designSystem 依次生成「灵感与意图入口页」「我的行程库」与「公开只读分享页」,全站 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 | /grill-me 我想设计一个 Desktop Web「AI 智能旅行计划网站」,最终交付物是: |
Step 2 · 建项目、同步 Design System 并探索核心页 1 基准 + 3 变体(enhance-prompt + stitch::generate-design)
1 | 规范确认没问题。请使用 enhance-prompt 和 stitch::generate-design: |
Step 3 · 锁定方向回写规范,复用同套 Design System 铺开其余页面
1 | 核心页定稿了,最终方向是基准。请把当前定稿页的视觉规范同步更新到项目 Design System 和 .stitch/DESIGN.md。 |
Step 4 · 转换为模块化 React + shadcn/ui 前端并校验启动(stitch::react-components + shadcn-ui)
1 | 所有设计稿均已定稿。请使用 stitch::react-components,并搭配 shadcn-ui 处理弹窗、日期选择、抽屉和下拉菜单等交互组件, |
Step 5 · 领域类型、Mock/HTTP Service 层与 OpenAPI 契约收口
1 | 前端页面验收通过。现在进入交付收口,不需要接真实后端: |
这次实战里最直观的三点体会
- 反模板约束写在
DESIGN.md,生成提示词别重复堆色值:用taste-design提前写死单主色和反 AI 模板禁令,首版出图观感就稳住了;而在调generate_screen_from_text时,让项目级designSystem管色彩字体、提示词专注布局与真实中文内容,生成一致性更稳。 - 多屏难免有细微漂移,留到 React 转码阶段一次收口最省力:即便复用同一个 Design System,后两屏设计稿仍会出现少量中文衬线标题或静态地图浮窗边缘略裁。没必要在 Stitch 里死磕像素级完美——版式和色阶定住后,进 React 用共享
<AppHeader />、统一 Tailwind Token 和真实坐标投影就能一次性拉齐。 - 纯前端交付带上同源 OpenAPI 与
/api-docs,才算真正可交接:如果只交一包写死假数据的页面,后端联调时还要返工对字段;把领域类型、VITE_USE_MOCK双模式 Service 和openapi.yaml同步收口,甚至直接挂进站内/api-docs,前端验收完成的那一刻,后端契约也就齐活了。
说到底,Stitch MCP 加上 Stitch Skills 干的是一件很朴素的工程事——让擅长画图的管审美,让擅长写代码的管架构和业务。无论你平时主力用的是哪款编码 Agent,只要把 .stitch/DESIGN.md 这份契约立住,前端页面的视觉下限和工程可维护性都能同时往上提一截。










