設計設定
概述
在第一個畫面之前,先確認產品是什麼、為誰而做、應該感覺如何、以及絕對不能看起來像什麼。將這些內容寫入 DESIGN.md,這份簡報將成為後續所有設計決策的首要參考。提問,而非發明:由 agent 憑空創造的品牌只是一種猜測,使用者最終得逐一修正。閱讀現有資料,逐一訪談使用者,撰寫簡報,暫停等待批准,然後才建立基礎架構。
使用時機
- 設計任務且專案根目錄沒有
DESIGN.md。 - 「設定設計」、「定義我們的樣式 / 品牌 / 指南」、
/craft-setup(/craft:craft-setupin the Claude Code plugin)。
不應使用時機
DESIGN.md已存在且任務是設計:使用craft。- 只修改一個 Token 或一項指南:使用
craft-system。
步驟
- 先閱讀。 README、文件、現有的 CSS 或 Token、設計檔案、品牌資料夾、任何舊的
DESIGN.md草稿。記錄下它們已經回答了哪些問題。如果程式碼中已有設計系統(UI 套件、Token 檔案、元件庫),請說明其數量,並在簡報的品牌區段寫入「Design system source:<path>」。在第 6 步中,提供匯入設計工具的選項,而非從頭建立基礎;已回答的品牌問題將被跳過。有兩個 UI 套件 → 先詢問哪一個是來源,再跳過品牌問題。永遠不問檔案已回答的問題。 用一行話確認即可(例如:「你的 README 說只有 pt-BR 且成員超過 60 歲,所以我會設計 18px 文字和 48px 觸控點」)。 - 訪談,每次一則訊息。 依序遵循訪談指引:產品、受眾與語調、情緒、品牌、參考資料、限制。
- 盡可能提供 3–5 個選項加上「其他」。
- 跳過任何已回答的問題。
- 當答案足以設計第一個畫面時就停止。六個好答案勝過十五個。
- 參考資料是必需的。 要求提供 2–5 個他們喜歡的產品、網站或圖片。針對每個參考,詢問取用什麼以及避免什麼。如果是你可以開啟的連結或圖片,先觀察並描述你所看到的,再提問。
- 撰寫
DESIGN.md於專案根目錄,使用範本,包含全部八個區段:產品、受眾與語調、情緒、品牌、參考資料、限制、決策記錄、開放問題。- 盡量使用他們的用語。
- 任何你推測而未被確認的內容,放入開放問題,不要當作事實寫入簡報。
- 暫停並展示
DESIGN.md給使用者。 修改直到他們批准。 - 基礎架構。
- 程式碼中已有設計系統: 提供匯入選項。如果同意,必要子技能:
craft-sync(匯入)。它會顯示庫存清單並詢問要繪製哪些元件。如果拒絕,在決策記錄中記錄「<日期> — 匯入至 <工具> 已拒絕」。即使使用者說「跳過」,仍提供此選項:因為這關乎設計工具,而非簡報。 - 程式碼中無系統: 必要子技能:
craft-system以建立模式建立基礎(Token、字體、間距、互動規則)。它有自身的批准暫停點。 - 現有的 Token 和樣式是起點:擴展它們,未經詢問不要重新命名或移動。
- 程式碼中已有設計系統: 提供匯入選項。如果同意,必要子技能:
如果使用者說「跳過」或「直接設計」
不要繼續提問。根據你閱讀的內容和他們說的話,撰寫一份精簡的 DESIGN.md:
- 每個空白都變成開放問題;
- 每個假設都標記為「(assumed)」。
一句話說明哪些假設最重要。「跳過」放棄了訪談和簡報的批准暫停,但絕不跳過第 6 步:
- 程式碼中有設計系統 → 仍然詢問那個匯入問題(「現在匯入到 <工具>?我會顯示所有元件,你挑選要繪製的」),然後繼續;
- 還沒有 Token → 基礎架構步驟及其暫停點仍會執行,因為
craft只能使用系統中的元素來繪製。
然後繼續執行他們所要求的任務。
開始之前
- 如果
references/adapters/中沒有與你的工具匹配的轉接器,請在你的工具中執行相同的動作,並說明你手動對應了哪些項目。如果完全沒有設計工具,則使用 HTML 構建 (html.md)。如果你只有圖片,請說明從圖片讀取的值是估計值。 - 在所有工具中,
DESIGN.md都是儲存庫中的純 Markdown 檔案。只有選用的參考展板存在於設計工具中。
規則
| 規則 | 原因 |
|---|---|
| 每次一則訊息,附帶選項 | 一堆問題只會被快速瀏覽並半答 |
| 先閱讀再提問;絕不問檔案已回答的問題 | 問 README 裡有的內容,等於告訴對方你沒看 |
| 不發明品牌:顏色、字型和情緒來自他們,或標記為「(assumed)」 | 發明的品牌是一種猜測,他們得逐個畫面修正 |
| 參考資料必須附帶取用/避免說明 | 「我喜歡 Stripe」沒用;「取用平靜的間距,避免漸層」才是規則 |
| 明確詢問「絕對不要的樣子」 | 避免什麼比追求什麼更能快速縮小設計範圍 |
| 設定過程中不重新設計現有檔案 | 設定的目的是記錄決策;修改他們的 CSS 是他們尚未要求的設計任務 |
| 設定過程中不繪製畫面 | 畫面來自 craft,在簡報和基礎架構批准之後 |
完成條件
DESIGN.md 已批准,包含其八個區段,且基礎架構已確定:透過 craft-system 建立並批准,或(若程式碼中有系統)透過 craft-sync 匯入,或匯入被拒絕並記錄。在「跳過」之後:DESIGN.md 已撰寫並標記其假設,基礎架構已存在(已批准,或已在專案中),且原始任務已繼續進行。
常見錯誤
| 想法 | 事實 |
|---|---|
| 「我選個好看的調色盤和字型,他們可以改」 | 如果他們不知道你做了決定,就無從改起。提問,或標記為「(assumed)」。 |
| 「趁現在順便 mock 主要畫面」 | 那是 craft 的工作,在批准之後。設定在簡報和基礎架構就結束。 |
| 「一次問完六個問題以節省時間」 | 每次一則,附帶選項。對他們來說回覆更快。 |
| 「他們的 Token 很亂,我來重構」 | 擴展它們。重構是另一個需批准的獨立變更。 |
| 「沒給參考資料,跳過那個區段」 | 要求提供。如果他們沒有,提供三個符合情緒的參考,並詢問每個參考的取用與避免。 |