AI 寫 UI 總是風格跑偏?Google 的 DESIGN.md 可能是關鍵補丁

作者:MaxKing寶藏
日期:2026年5月12日 下午1:31
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

AI 寫 UI 風格跑偏嘅關鍵補丁DESIGN.md 提供項目級設計規則

整理版摘要

呢篇文章係由 Max King 寫嘅,佢係一個成日同 AI 一齊寫 UI 嘅全棧開發者。佢發現 AI 唔係唔識寫 UI,而係每次做新頁面都會重新猜度呢個項目應該係咩風格,搞到同一個產品入面嘅頁面風格不一致。佢覺得問題核心係缺少一份畀 AI 長期遵守嘅設計規則文件。

Google Stitch 推出嘅 DESIGN.md 正好補返呢個缺口。DESIGN.md 係一種專門向 coding agent 描述視覺身份嘅格式,令 AI 理解設計系統背後嘅原因,而唔係單純睇截圖估結構。作者強調,截圖只係結果,DESIGN.md 先係規則。佢仲提出一個完整嘅 AI UI 工作流:先用 DESIGN.md 定規則,再用 UI Spec 拆頁面,然後用 Handoff.md 派任務,最後做截圖對比驗收。

整體結論係:AI 寫 UI 要穩定,唔可以一開始就畀佢自由發揮,而係要先用設計規則框住,再畀佢喺規則入面發揮。DESIGN.md 就係呢個關鍵補丁,但唔係全部答案,佢只係整個交付鏈嘅第一層。

  • AI 寫 UI 風格跑偏嘅根本原因係缺乏項目級設計規則,令 AI 每次都重新猜度風格。
  • Google StitchDESIGN.md 係一種畀 AI agent 讀取嘅視覺身份格式,解決設計規則缺失問題。
  • 截圖只係結果,DESIGN.md 先係規則,佢明確講出顏色、圓角、字體等點樣用。
  • 完整工作流分四層DESIGN.md 定規則、UI Spec 拆頁面、Handoff.md 派任務、截圖對比做驗收。
  • 唔好畀 AI 一開始就自由發揮,應該先寫清楚規則,再等 AI 喺規則入面創作。
整理重點

AI 寫 UI 風格跑偏嘅真實痛點

Max King 發現,用 AI 做 UI 嘅時候,第一個頁面係深色金融風,第二個頁面突然變咗極簡白色風,按鈕圓角、卡片陰影同表格密度每次都唔同。你叫 AI 修一個按鈕,佢可能順手改咗成個佈局。

問題唔係 AI 唔會寫 UI,而係佢每次都在重新猜呢個項目應該長成點樣。

整理重點

設計規則缺失係關鍵缺口

作者指出,截圖只能話畀 AI 呢個頁面外觀像咩,但冇話畀佢知主色、輔助色、危險色、卡片圓角、字體分層等具體規則。AI 只能靠估,結果就係單頁好睇,整體唔統一。

  • 主色、輔助色、危險色點樣用?
  • 背景色去到咩程度?
  • 卡片圓角同表格密度係幾多?
  • 按鈕有幾種層級?字體點分層?
  • 邊啲效果可以用,邊啲唔可以出現?
整理重點

Google Stitch 嘅 DESIGN.md 係關鍵補丁

DESIGN.md 唔係一個普通 prompt 模板,而係 Google Labs 定義嘅畀 coding agents 描述視覺身份嘅格式。佢令設計規則可以被 AI 理解同複用,解決設計規則分散喺 Figma、品牌手冊同設計師腦入面嘅問題。

DESIGN.md 要話畀 AI 呢個產品係咩類型、整體視覺氣質係點、顏色、字號、按鈕、卡片、表格應該點樣,同埋邊啲風格唔準出現。

舉例講,如果要做一個交易儀表盤,只講「dark fintech 風格」太模糊,AI 可能會出一個好炫但難用嘅大屏。有咗 DESIGN.md,就可以寫清楚:數據優先、避免賽博朋克、狀態色只用於風險提示、卡片高可讀性、表格緊湊等。

整理重點

完整工作流:四層分工避免亂局

Max King 建議將 AI UI 工作流拆成四層,每層各有職責,唔可以混淆。DESIGN.md 只係第一層,負責項目級設計規則。

  1. 1 DESIGN.md 定規則:定義項目級設計系統。
  2. 2 UI Spec 拆頁面:具體頁面嘅模塊、字段、狀態、交互同響應式。
  3. 3 Handoff.md 派任務:話畀 Codex / Cursor / Claude Code 點樣實現。
  4. 4 截圖對比做驗收:檢查頁面同參考圖、規則嘅偏差。
整理重點

記住三句話,展望後續

AI 寫 UI 風格跑偏,唔只係模型問題,更多係設計規則缺失。

截圖係結果,DESIGN.md 係規則。

DESIGN.md 定規則,UI Spec 拆頁面,Handoff.md 派任務,截圖對比做驗收。

作者預告下一篇會繼續拆 UI Spec 到底應該寫咩,仲會整理 DESIGN.md 示例、UI Spec 模板、Handoff.md 模板同截圖對比清單。如果你都遇到過同個項目唔同頁面風格不一致、AI 每次都重新發明組件嘅問題,可以喺評論區分享。

哈嘍,大家好,我是 Max King。

最近我用 AI 做 UI,越來越明顯感受到一個問題:

AI 不是不會寫頁面。

它能畫圖,也能寫 React,也能生成一套看起來還不錯的後台頁面。

但真正做成一個項目時,問題很快就來了。

第一個頁面是深色金融風。
第二個頁面突然變成極簡白色風。
第三個頁面按鈕圓角變了。
第四個頁面卡片陰影又不一樣。
到了設置頁,表格密度、字體層級、按鈕樣式全都開始漂。

你讓它修一個按鈕,它可能順手改了整個佈局。你讓它調一個卡片間距,它可能把字體也換了。你讓它還原參考圖,它可能重新發明一套組件。

這時候你會發現:

問題不是 AI 不會寫 UI,而是它每次都在重新猜:這個項目到底應該長什麼樣?

所以我現在越來越確定一件事:AI 寫 UI 最缺的,不一定是更強的出圖工具,而是一份能讓 AI 長期遵守的設計規則文件。

而 Google Stitch 推出的 DESIGN.md,剛好補上了這個缺口。

01

-MaxKing.cc-

AI 寫 UI 為什麼總是風格跑偏?


很多人現在做 AI UI,第一步就是:

“幫我生成一個漂亮的後台頁面。”
“按這張圖寫一個 React 頁面。”
“把這個截圖轉成代碼。”
“參考這個風格,再做一個設置頁。”

這一步看起來很快。

但後面很容易失控。

因為你沒有告訴 AI 一件最重要的事:

這個項目的設計規則是什麼?

沒有這層規則,AI 每次做頁面,都像重新開了一個新項目。

你讓它做首頁,它可能發揮一次。你讓它做設置頁,它又發揮一次。你讓它做數據表格頁,它再發揮一次。

每一次單獨看,好像都還不錯。

但放到同一個產品裏,就會發現:

單頁好看,整體不統一。
局部能用,項目不可維護。
第一版驚豔,後面越修越亂。

這不是某一個模型的問題,而是 AI UI 工作流裏缺了一層東西。

缺的是:項目級設計規則。

02

-MaxKing.cc-

截圖是結果,DESIGN.md 是規則


很多人以為,只要給 AI 一張圖,它就能還原 UI。

但這其實不夠。

一張圖只能告訴 AI:

這個頁面看起來像什麼。

但它沒有明確告訴 AI:

主色是什麼;
輔助色是什麼;
危險色怎麼用;
背景色應該到什麼程度;
卡片圓角是多少;
表格密度應該多緊湊;
按鈕有幾種層級;
字體大小怎麼分層;
哪些效果可以用;
哪些效果不能出現。

比如一個後台頁面裏有一個藍色按鈕。

AI 看到截圖以後,能猜出來它是藍色的。

但它不知道這個藍色到底是主按鈕色、連結色、當前選中態、數據強調色,還是隻是這張圖裏偶然出現的裝飾色。

如果不寫清楚,AI 就只能猜。

這裏最大的區別

截圖
告訴 AI:這個頁面看起來像什麼。

DESIGN.md
告訴 AI:為什麼應該這樣長,以及以後同類頁面也應該怎麼長。

這篇文章的結論
截圖是結果,DESIGN.md 是規則。

這也是 image-to-code 最大的問題之一:它不是在讀取設計系統,而是在根據圖片猜設計結構。

03

-MaxKing.cc-

DESIGN.md 不是自創模板


這裏先說清楚:

DESIGN.md 不是我自己起的名字,也不是一個普通 Prompt 模板。

它來自 Google Stitch。

Google 對 DESIGN.md 的定位,是讓設計規則可以在不同項目之間導入和導出,讓 AI 理解設計系統背後的原因,從而生成符合品牌的 UI。

Google Labs 的開源倉庫裏,對 DESIGN.md 的定義也很直接:

DESIGN.md 是一種向 coding agents 描述視覺身份的格式,讓 agent 對設計系統形成持續、結構化的理解。

這句話很重要。

過去我們做 UI,設計規則可能藏在 Figma 文件裏、品牌手冊裏、設計師腦子裏、項目截圖裏、前端組件庫裏,或者一堆歷史代碼裏。

但 AI coding agent 不一定真正理解這些東西。

它看到截圖,只知道“這個頁面看起來像這樣”。它看到代碼,只知道“這裏寫了這些樣式”。但它未必知道:

這套 UI 背後的設計系統是什麼。

DESIGN.md 要解決的,就是這個問題。

官方來源說明

Google Stitch
提出 DESIGN.md,用來讓設計規則可以被 AI 理解和複用。

Google Labs design.md 倉庫
把 DESIGN.md 定義為給 coding agents 描述視覺身份的格式。

04

-MaxKing.cc-

它解決的是項目級設計規則


我現在對 DESIGN.md 的理解是:

它不是某一張頁面的說明,而是一份寫給 AI 的項目級設計系統文件。

它要告訴 AI:

這個產品是什麼類型;
整體視覺氣質是什麼;
顏色怎麼用;
字號怎麼分層;
按鈕、卡片、表格應該長什麼樣;
頁面信息密度應該高還是低;
哪些組件要複用;
哪些風格不要出現。

比如你要做一個交易儀表盤。

如果只對 AI 說:

做一個 dark fintech 風格的交易後台。

這句話其實很模糊。

AI 可能會給你一個很酷的金融大屏:大量霓虹漸變、發光線條、複雜背景、巨大的圖表裝飾、很多沒意義的動態感元素。

第一眼看起來很震撼。

但真的放到產品裏,就會很難用。

因為真實交易後台最重要的不是炫,而是數據清晰、風險突出、持倉信息容易掃描、盈虧狀態一眼可見、表格密度合理,不能為了視覺效果犧牲可讀性。

如果先寫 DESIGN.md,就可以把規則提前說清楚:

這是一個真實交易產品後台,不是展示大屏。

整體風格:dark fintech。
要求:專業、剋制、數據優先。
避免:賽博朋克、過度霓虹、無意義 3D 裝飾。

深色背景可以使用,但必須保證數據可讀性。狀態色只用於風險提示、盈虧信息和交易信號。卡片要保持高可讀性,不使用過重陰影。表格密度要緊湊,適合快速掃描。圖表必須服務決策,不做純裝飾。

這時候 AI 再去出圖、寫代碼,就不是自由創作。

它是在一套明確的設計系統裏完成任務。

DESIGN.md 不是替你做完所有 UI。它更像一個補丁:補上 AI 在設計規則理解上的缺口。

05

-MaxKing.cc-

它應該放在 AI UI 工作流最前面


這裏也要說清楚:

DESIGN.md 不是萬能的。

它不負責把某個頁面的所有模塊都拆出來。它也不負責告訴 Codex / Cursor 這次具體要寫哪個組件。它更不負責最後的截圖對比和頁面修正。

在我的 AI UI 工作流裏,它只解決第一層問題:

這個項目的 UI 應該遵守什麼設計規則?

後面還需要繼續往下拆。

DESIGN.md

UI Spec

Handoff.md

Codex / Cursor / Claude Code

截圖對比修正 → 可交付頁面

三份文件怎麼分工?

DESIGN.md 定規則
負責項目級設計系統。

UI Spec 拆頁面
負責具體頁面有哪些模塊、字段、狀態、交互和響應式。

Handoff.md 派任務
負責告訴 Codex / Cursor / Claude Code 具體怎麼實現。

截圖對比做驗收
負責檢查頁面跑起來以後,和參考圖、設計規則、交付標準之間還有哪些偏差。

這幾層不能混在一起。

如果一上來就跳到 image-to-code,AI 很容易猜錯結構。

如果一上來就讓 Codex 寫頁面,AI 很容易自由發揮。

如果沒有 DESIGN.md,後面 UI Spec 寫得再細,也可能缺少一個統一的風格底座。

06

-MaxKing.cc-

不能讓 AI 一開始就自由發揮


所以我現在不太建議一上來就讓 AI 自由出圖。

也不建議直接把一張圖丟給 image-to-code,然後期待它變成可交付頁面。

不是這些工具沒用。

而是如果前面沒有設計規則,後面的圖、代碼、修正都會變成一次次隨機發揮。

AI 做 UI,真正穩定的方式不是讓它“自由創作”,而是先把規則寫清楚,再讓它在規則裏發揮。

這也是為什麼我覺得 Google 的 DESIGN.md 值得關注。

它真正重要的地方,不是多了一個 Markdown 文件。

它背後的變化是:

過去,設計規則藏在 Figma、品牌手冊、截圖和人的經驗裏。

現在,我們開始需要把這些規則整理成 AI agent 能長期讀取的設計上下文。

這就是為什麼 AI 寫 UI 總是風格跑偏時,DESIGN.md 可能會成為一個關鍵補丁。

但它還不是完整答案。

它只是 AI UI 交付鏈路裏的第一層。

圖片


這篇先記住三句話

1. AI 寫 UI 風格跑偏,不只是模型問題,更多是設計規則缺失。

2. 截圖是結果,DESIGN.md 是規則。

3. DESIGN.md 定規則,UI Spec 拆頁面,Handoff.md 派任務,截圖對比做驗收。

我想收集真實場景,邀請您參與

你用 AI 寫 UI 時,有沒有遇到這種問題:

1. 同一個項目裏,不同頁面風格不一致。

2. AI 每次都重新發明按鈕、卡片、表格。

3. 修一個地方,另一個地方又被改亂。

4. 圖片很好看,但代碼落地後完全不像一個產品。

如果你也遇到過,可以在評論區說一下。我後面會挑一些典型場景,匿名拆成文章繼續覆盤。

模板會陸續放出來

這個系列後面會陸續整理:

- DESIGN.md 示例

- UI Spec 模板

- Handoff.md 模板

- 截圖對比修正清單

我會結合真實案例一點點拆,不會一次性堆完。

下一篇預告

下一篇我會繼續拆:有了 DESIGN.md 之後,UI Spec 到底應該寫什麼?也就是一個具體頁面,應該如何把模塊、字段、狀態、交互和響應式寫清楚。

- END -

關於 MaxKing寶藏

我是 MaxKing,全棧開發者、量化交易實踐者,也是 AI 重度用戶。這裏分享的不是遙遠概念,而是我在真實使用、搭建和踩坑後留下的判斷。

後面我會繼續記錄 AI 如何進入真實開發、產品交付、知識管理和自動化工作流。