AI 寫 UI 總是風格跑偏?Google 的 DESIGN.md 可能是關鍵補丁
整理版優先睇
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 Stitch 嘅 DESIGN.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 DESIGN.md 定規則:定義項目級設計系統。
- 2 UI Spec 拆頁面:具體頁面嘅模塊、字段、狀態、交互同響應式。
- 3 Handoff.md 派任務:話畀 Codex / Cursor / Claude Code 點樣實現。
- 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 就只能猜。
這也是 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 要解決的,就是這個問題。
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
↓
截圖對比修正 → 可交付頁面
這幾層不能混在一起。
如果一上來就跳到 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 如何進入真實開發、產品交付、知識管理和自動化工作流。