從 0 建設個人網站
AI 做的網站都長一樣?2026 不像模板的設計規格寫法(附範本)
AI 做的網站常是紫色漸層、置中大標加 emoji 卡片,因為它沒拿到任何設計決定。教你寫一份 DESIGN.md 設計規格讓 AI 照做,附可複製的範本。
Kelvin Wang · · 16 分鐘閱讀
重點整理
- AI 做的網站長一樣,是因為沒拿到設計決定,只能給它看過最多次的做法;換工具多半也一樣。
- 紫色漸層、置中大標加兩顆按鈕、emoji 卡片、預設字型、空泛文案,是最容易被認出來的模板感。
- 把顏色、字級、間距、動畫和手機規則寫進專案根目錄的 DESIGN.md,再讓 AI 每次改畫面前先讀。
- 再加上參考圖、自己寫的文案、手機和桌機兩種寬度的截圖驗收,網站才會像你的。
我的網站 kelvinwang.info 從 2026 年 9 月 28 日開始用一份設計規格 DESIGN.md,每次叫 AI 改畫面之前都要它先讀。到 11 月中,這份檔案快六百行,git 紀錄裡改過一百多次。AI 做的網站長一樣,是因為它沒拿到任何設計決定;這個網站的做法是把決定寫成一份 DESIGN.md,讓它每次先讀。
為什麼 AI 做的網站都長一樣?
AI 寫程式工具產生的是「在這個提示下最可能的答案」。你只說「幫我做一個個人網站」,最可能的答案就是它看過最多次的那種網站。Anthropic 在 2025 年 11 月的官方文章裡講過自家模型的這個現象:沒有任何指引時,Claude 做的頁面幾乎都是 Inter 字型、白底紫色漸層、很少動畫;原因是「每個人都能接受」的安全設計在網路上的範例裡佔多數,模型就從那個中間值取樣1。
我的判斷是,下面幾件事讓這個中間值更集中:
- 熱門的元件庫和 CSS 框架預設值被大量使用。網路上很多網站用同一套元件、同一組預設色和圓角,AI 學到的「正常網站」就長那樣。
- 提示太籠統。「現代、簡潔、專業」這幾個字幾乎所有網站都適用,等於沒給條件。
- 沒有參考圖。只用文字描述,AI 不知道你心裡的「簡潔」是哪一種。
- 沒有品牌限制。你沒說主色、字型、能不能用漸層,它就自己挑,挑的就是最常見的。
- 每次對話都從零開始。上次講好的顏色,這次新對話不會記得,又回到預設。
我認為換工具也差不多:Claude Code、Cursor、Codex、v0、Lovable,你沒給的決定,它們都會用最常見的做法補上。
一眼看出是 AI 模板的六個特徵
- 紫色或靛藍漸層。白底、紫到藍的漸層大標或按鈕,是 Anthropic 自己也點名過的一項1。改法:主色只選一個,而且說得出為什麼選它;漸層要用就限定在一個地方。我的網站 2026 年 11 月 11 日從六組配色提案裡選了「暖紙+電光青」:米白和暖黑的底、青色當品牌色。漸層字只用在首頁大標的最後一行,規格寫明「漸層只在這一處」。
- 置中大標加兩顆按鈕的首頁。一句大標語、一行副標、「開始使用」「了解更多」兩顆按鈕。改法:先想第一個畫面要讓人知道什麼,不一定需要按鈕。我的首頁是一層點陣動畫,輪流排出主機板、訊號眼圖、Wi-Fi 天線場形和 K 線,往下捲時點會飛進文章分類卡,聚成各分類的圖示;2026 年 11 月 10 日起,首頁大標下面沒有按鈕。
- 一排 emoji 或圖示庫的特色卡片。三欄卡片,每張一個 emoji、一個粗體標題、兩行說明。改法:圖示要嘛自己畫、和網站其他地方同一種風格,要嘛不放。我的分類卡和工具卡用的是跟首頁同一套點陣圖示。
- 每張卡片都一樣的圓角、陰影和間距。整頁同一種卡片排下去,看不出哪個重要。改法:用一張間距表決定「什麼和什麼靠近、什麼和什麼分開」,層次靠字級和留白,不靠陰影。首頁分類卡和 Lab 卡片沒有陰影,只有一條 0.5px 細框,滑鼠移上去時框變成品牌青色。
- 沒想過的預設字型。英文用 Inter、中文交給瀏覽器隨便挑。改法:刻意選一次,寫進規格。我選的是系統字:Mac 和 iPhone 上是 SF Pro 加蘋方,不載入任何網路字型。中文字型字數多、檔案大,要用中文網路字型,就要做子集化(只下載頁面用到的字)並用 WOFF2 壓縮;web.dev 也提到子集化對字數多的亞洲語言特別重要2。
- 空泛的文案。「打造卓越的數位體驗」「歡迎來到我的網站」這種放在哪個網站都成立的句子。改法:文案自己寫,寫只有你能寫的事,例如做過什麼、用什麼工具、踩過什麼坑;AI 可以幫你改句子,但編不出你的經歷。我的寫作規範還有一條:不寫描述頁面本身的句子(「以下是我的作品」)。
這六項的共同點是:都是 AI 在沒有條件時自己補上的。把這些條件寫下來,就是一份設計規格。
為什麼要寫成檔案?
在對話裡跟 AI 說「標題用深藍色、按鈕圓一點」也有用,但只在那一次對話有用。換一個工具、換一個人接手,更是什麼都沒有。
寫成檔案有三個好處。第一,它跟程式碼一起放在 repo 裡,進版本控制,改了什麼查得到。第二,AI 工具會自動讀專案說明檔:Claude Code 讀 CLAUDE.md,Codex 動手前會先讀 AGENTS.md3,Cursor 也支援專案根目錄的 AGENTS.md4,Lovable 則有專案層級的 Instructions,每次回應都會帶上5。你在說明檔裡加一行指向 DESIGN.md,每次對話它都會先讀到。第三,你自己也會被它約束,三個月後想加新顏色時,會先看到當初為什麼只用這幾個。
我的 CLAUDE.md 第一條規則就是:
- **Design spec: read `DESIGN.md` before changing anything visible** (public site, `/app`, new pages or components).
It is binding for the whole repo; if you need to break a rule, update `DESIGN.md` first and say so.
最後那句「要破例先改規格」很重要。規格和程式不一致時,AI 不知道該聽哪一邊;規定「先改文件再改程式」,兩邊就永遠對得上。
想深入 Claude Code 教學 2026:安裝、CLAUDE.md、skills,用它做出一個個人網站 CLAUDE.md 放哪、寫什麼、怎麼讓 AI 每次都讀到。寫規格之前先決定的五件事
不用懂設計也能寫規格,先回答這五個問題,答案就是規格的骨架:
- 網站給誰看、要讓人有什麼感覺。 找兩三個你喜歡的網站,寫下喜歡它哪裡。
- 要不要深色模式。 要的話,每個顏色都要給淺色和深色兩個值,現在就決定,後面補很痛苦。
- 主色是哪一個。 一個就好。其他都是中性的灰階。
- 字型。 系統字最省事、載入最快;要用網路字型就寫明哪一套、哪幾個字重,中文字型記得處理檔案大小。
- 手機是不是主要情境。 個人網站多半是,那規格裡要有一節專門寫手機。
規格裡要有的七個部分
1. 顏色分兩層:原始值和語意名稱
最常見的錯是讓 AI 在元件裡直接寫色碼(#1a62c2)或 Tailwind 的色名(blue-600)。寫了三十個元件之後想換主色,就要改三十個地方。
正確做法是先定義一組語意 token,用角色命名:頁面底色叫 page,主要文字叫 ink,邊框叫 edge,連結叫 link。元件只准用這些名字,實際色碼只寫在一個 CSS 檔裡。我的規格這一節開頭就寫「元件只用語意層,永遠不直接寫 --pub-*、hex 或 neutral-*」(--pub-* 是我放原始色值的變數,neutral-* 是 Tailwind 的灰階色名)。11 月換整套配色時,元件不用一個個改,主要改的是那個 CSS 檔裡的值,加上少數讀不到 CSS 的地方(分享縮圖、網站圖示這類),這些地方也列在規格裡。
每個文字顏色都要量過對比。WCAG 的 AA 標準是一般文字和背景至少 4.5:16,我的規格寫的是「量過的,不是猜的」,每個文字 token 在它會出現的每個底色上都要過 4.5:1。對比檢查工具很多,貼兩個色碼就能算。
2. 每個顏色只有一個意思
光有色票不夠,還要寫每個顏色代表什麼。我的網站:
- 靛藍色是內文連結,文章小標用同色相、更深的靛藍,所以文章裡的連結另外常駐一條淡底線,兩者不會搞混。
- 青色是品牌色,一個畫面只有一顆填色按鈕,其他按鈕用邊框。
- 紅色只標危險或被動過手腳的東西,不拿來裝飾。
AI 沒有這條規則時,常會把顏色當裝飾用,例如每張卡片換一個顏色,結果整頁沒有重點。我在規格裡還寫了「不用顏色分主題、分類」,分類用文字標籤,以前加過的分類色 token 已經刪掉,並註明不要加回來。
3. 字級表
列一張表:每一級叫什麼、多大、行高多少、用在哪。我照 iOS 的預設字級:一般內文 17px,次要說明 15px,分組標題、頁尾 13px;文章內文 2026 年 11 月 10 日加大到 18px、行高 1.85,因為中文長文需要比較大的字和行高。有了這張表,AI 就不會在每個頁面發明新的字級。
4. 間距與寬度
這一節常被跳過,但頁面看起來整不整齊,很大一部分取決於它。我的規格把間距放在 4px 格上,而且由兩個元素的關係決定,不由頁面決定:同一項的兩行隔 4px,標題到它的內容隔 12px,段落和段落隔 20px,文字和卡片、表格這類區塊隔 24px(文章頁另有一套更鬆的閱讀刻度)。閱讀欄寬度上限 680px,讓中文每行不超過約 40 字。
這一節是 2026 年 11 月 4 日才補上的。在那之前,手機版的麵包屑和導覽列只隔 12px,幾乎貼在一起,每個頁面的段落距離也不太一樣。寫成一張表之後,新頁面都從表裡挑數字。
5. 動畫規則
動畫寫三件事就夠:什麼情況用什麼曲線、多長時間,只動哪些屬性,使用者開了「減少動態效果」時怎麼辦。我的規則是只動 transform 和 opacity(這兩個屬性瀏覽器最不吃效能),hover 和顏色變化 150 毫秒,裝飾性的循環動畫離開畫面就要停,減少動態時要停在一張有意義的靜態畫面,不是一片空白。
6. 手機規則
- 可點的區域至少 44×44px。
- 390px 寬的手機上不能出現水平捲動。
- 全螢幕高度用
dvh,不用vh。iPhone Safari 的網址列會讓vh算錯。 - 固定在頂端或底部的元素要避開瀏海和底部橫條(safe area)。
7. 改完之後的檢查清單
這是讓 AI 自己驗收的部分。我的清單有八條,例如:深淺兩種主題都看過、新加的顏色量過對比、動畫有減少動態的分支、用 390×844 的手機尺寸實際看過。其中一條是「新增的規則或刻意的例外寫回這份文件」,規格才會跟著網站長大。
可以直接複製的範本
這份空白範本照我的 DESIGN.md 結構整理,數值都換成通用的起始值(範本裡的文字色在兩種底色上都量過,至少 5:1),另外多了「元件」和「已知落差」兩節。存成專案根目錄的 DESIGN.md,把方括號裡的內容換成你的決定。
# DESIGN.md: [網站名稱] 的設計規格
整個 repo 都要遵守。改任何看得到的東西之前先讀這份;
跟這份衝突的做法,先改這份再改程式。
優先序:我在對話裡的明確指示 > 本文件 > 通用設計建議。
狀態標記:沒標的規則=已實作;🟡=已定案、尚未實作。
## 0. 手機規則
- 可點區域 ≥ 44×44px。
- 390px 寬時不能水平捲動(驗收時量 document.scrollWidth)。
- 全螢幕高度用 dvh,不用 vh。
- 固定在頂端/底部的元素加 env(safe-area-inset-*)。
- 內文不小於 16px。
## 1. 顏色 token
元件只用語意 token,不直接寫色碼或框架色名。實際值只寫在 [styles/global.css]。
| token | 角色 | 淺色 | 深色 |
|---------|----------------|----------|----------|
| page | 頁面底色 | #ffffff | #0b0d10 |
| surface | 卡片、程式碼底 | #f5f6f8 | #15181d |
| ink | 標題、主文字 | #111418 | #f2f4f7 |
| ink-2 | 內文 | #3a424d | #c3cad3 |
| ink-3 | 說明、日期 | #5f6b78 | #8e9aa7 |
| edge | 邊框、分隔線 | #dde2e8 | #262c34 |
| brand | 主色:主要按鈕 | [你的主色] | [深色版] |
| link | 內文連結 | #1f5fbf | #6aa8ff |
對比:每個文字 token 在它會出現的每個底色上 ≥ 4.5:1,改值之前重算。
加新顏色之前先問:現有角色能不能用?不能才加新「角色」,並同時給淺色和深色值。
漸層:[不用 / 只用在某一處]。
## 2. 顏色的意思
- link = 內文連結。
- brand = 品牌。一個畫面只有一顆填色按鈕,其他用邊框。
- [錯誤色] 只用在錯誤訊息。
- 不用顏色區分分類;分類用文字標籤。
## 3. 字型與字級
字型:[系統字 / 指定字型與字重]。不在元件裡另外指定字型。
| 樣式 | 大小/行高 | 字重 | 用在哪 |
|----------|------------|----------|--------------|
| 頁面標題 | 34 / 41 | Bold | 每頁大標 |
| 區塊標題 | 22 / 28 | Bold | h2 |
| 內文 | 17 / 28 | Regular | 文章段落 |
| 說明 | 15 / 20 | Regular | 第二行、註腳 |
| 小字 | 13 / 18 | Regular | 日期、頁尾 |
## 4. 間距與寬度
間距都在 4px 格上,由兩個元素的關係決定:
| 關係 | 值 |
|------------------------|------|
| 同一項的兩行 | 4px |
| 標籤 → 它說明的東西 | 8px |
| 標題 → 它的內容 | 12px |
| 段落 ↔ 段落 | 20px |
| 文字 ↔ 卡片/表格/圖 | 24px |
閱讀欄最寬 [680px]。左右邊距:手機 [20px],桌機 [24px]。
## 5. 動畫
- 只動 transform 和 opacity。
- hover/顏色 150ms;進場 ease-out,出場比進場快。
- prefers-reduced-motion: reduce 時停在靜態畫面。
- 不加回彈;一個畫面一個焦點。
## 6. 元件
[列出共用元件與規則,例如:按鈕兩種(填色/邊框)、卡片圓角 [16px]、
有沒有陰影、圖示從哪裡來(自己畫/不用 emoji)、
表格在手機上改成一列一張卡片。]
## 7. 檢查清單(改完 UI 之後)
1. 深淺兩種主題都看過。
2. 新加的顏色量過對比。
3. 沒有新的色碼出現在元件裡(grep 一下)。
4. 動畫只動 transform/opacity,有 reduced-motion 分支。
5. 390×844 和桌機寬度都截圖看過:沒有水平捲動、可點區 ≥ 44px。
6. 新規則或刻意的例外寫回這份文件;還沒做的標 🟡 並列進「已知落差」。
## 8. 已知落差
| 規則 | 現況 | 預計處理 |
|------|------|----------|
怎麼讓 AI 照規格做?
- 在專案說明檔加一行指向它(
CLAUDE.md、AGENTS.md或工具自己的專案規則),寫明「改任何看得到的東西之前先讀」。 - 第一個需求就讓 AI 依規格建 token。 例如:「照 DESIGN.md §1 在 global.css 定義顏色 token,深淺兩套,Tailwind 用語意名稱。」token 先建好,之後每個頁面都只能用這些名字。
- 每次改完叫它對照規格挑毛病。 「照 DESIGN.md §7 檢查剛剛的修改,逐條回報;哪裡跟規格不一致、哪裡看起來像模板,直接指出來。」要它找問題,而不是問它「好不好看」。
- 能自動檢查的規則寫成測試。 我的網站有一個測試會擋元件裡直接寫 Tailwind 色相(例如
purple-400、indigo-500),另一個會擋公開頁的上下間距用了表以外的數字。AI 忘了讀規格時,測試會失敗。 - 調整過的決定寫回規格。 我網站背景的漸層光暈,原本淺色模式的透明度是 10%/8%,看過比較稿後調到 22%/18%,因為同樣的透明度疊在接近白色的底上幾乎看不到。這個數字和理由都寫進了規格,之後不會有人(或 AI)又改回去。
- 加新顏色要附理由和量測。 2026 年 10 月 23 日我同意加一個紅色,規格裡記下它在三種底色上的對比值,以及它和品牌色、連結色的色相差距。
這套流程和寫程式前先寫 spec 是同一個道理:先把決定寫下來,AI 才有東西可以遵守。
想深入 AI 寫的網站我看不懂,以後要怎麼改?2026 讓自己維護得動的做法 規格之外,讓 AI 做的網站長期改得動的幾個習慣。規格之外,還有哪些方法讓網站不像模板?
- 給參考圖,並說出你喜歡它哪裡。五個常見工具都能吃圖:Claude Code 可以貼上、拖進視窗或給圖檔路徑7,Codex 可以在對話框貼圖或用
--image帶進去8,Cursor 的 agent 會讀專案裡的圖檔9,v0 和 Lovable 都能在對話框附加截圖,Lovable 還能在截圖上畫圈標出要改的地方1011。但只丟一張截圖,AI 會照抄整個畫面;v0 的文件就寫它會分析截圖的版面、配色和元件,產生接近原圖的程式10。所以要附一句話說你要的是哪一點,例如「要它的大字和留白,不要它的配色」。 - 做兩三個版本並排比較再選。我的配色(六組提案)、背景光暈的透明度,都是先做出幾個版本放在同一頁比較,看過再選,選定的值和理由寫回規格。只看一個版本時很難判斷它是不是平均值。
- 文案自己寫。版面再特別,文案是「打造卓越體驗」就還是模板。先寫幾句只有你能寫的話,再讓 AI 幫你整理句子。
- 用手機和桌機兩種寬度截圖驗收。AI 說「做好了」時,要它在 390×844 和桌機寬度各截一張圖,深淺兩種主題都看。很多模板感(擠在一起的卡片、按鈕貼著邊)只在手機上看得出來。
我踩過的坑
- 規格寫了、程式沒跟上。 規格定了新規則,舊頁面不會自己變。我用 🟡 標「已定案、尚未實作」,另外列一張「已知落差」表,改到相關檔案時順手修。
- 新增元件資料夾忘了告訴 CSS 工具。 我的公開頁 CSS 只掃描指定的資料夾,新資料夾沒加進去,那些 class 就不會產生。這條後來也寫進檢查清單。
- 只在一種主題下看。 AI 截圖驗收時常只看預設主題。清單裡要寫明「用切換鈕切,深淺都看」。
資料來源
- 1. Improving frontend design through Skills
- 2. Reduce web font size
- 3. Custom instructions with AGENTS.md
- 4. Rules
- 5. Instructions
- 6. Understanding SC 1.4.3: Contrast (Minimum)
- 7. Common workflows: Work with images
- 8. Codex CLI
- 9. Agent overview
- 10. Screenshots and Files
- 11. Work with Lovable in the project chat