Craft 是做什麼的?
概述
這是製作任何視覺設計的總入口。它能將「設計定價頁面」轉化為一個完整且經過審查的設計。它會從專案的簡報出發,涵蓋所有狀態,僅在方向不明確時提供選項,只使用設計系統中的既有元件,並在展示前檢查自己的作品。它會在固定時間點呼叫其他設計技能,而不是取代它們。
使用時機
- 「設計 / 建立 / 模擬 / 重新設計 <頁面、畫面、流程、元素>」,使用
/craft(在 Claude Code 外掛中為/craft:craft)。 - 同時設計多個頁面(例如:「設計入門流程:歡迎頁、註冊頁、驗證頁」)。
不該使用時機
- 使用者已經精確描述的小修改(一個值、一個標籤、一個尺寸):直接進行修改。
- 僅要求審查(「這個有什麼問題?」):請使用
craft-critique。僅要求提供選項:請使用craft-explore。
開始之前
- 如果在
references/adapters/中沒有與你的工具匹配的轉接器,請在你的工具中執行相同的操作,並說明哪些是手動對應的。如果完全沒有設計工具,請使用 HTML 進行建置(html.md)。如果你只有圖片,請說明從圖片中讀取的值是估算值。
停止點是真實存在的
停止點代表:在你的回合結束時提出問題並等待。你隨時可以這樣做,即使在一次性或無頭會話中,你最後的訊息就是問題。永遠不要因為會話「等不及」或「為了節省來回次數」而替使用者決定停止點。 自己決定只會把原本五秒鐘就能回答的問題變成數小時的重做。
步驟
- 背景脈絡。
- 讀取專案根目錄下的
DESIGN.md。如果缺少該檔案,或沒有「Product」區段(僅為同步記錄)→ 必需的子技能:craft-setup,然後再回到這裡。 - 讀取設計系統(tokens、元件、指南)以及與此頁面相關的畫面。
- 當簡報與程式碼不一致時(例如簡報說青綠色,但 tokens 說藍色):遵循程式碼,用一句話說明,將衝突新增至
DESIGN.md的「開放問題」中,並提議修正其中錯誤的一方。切勿在頁面自身的 CSS 中覆蓋 tokens。 - 當設計工具的指南與程式碼不同,且存在
design-sync.json時,不要認為指南過時。根據以下規則進行分類:程式碼已變更 → 在繪製前提議重新整理指南;指南已變更 → 這是使用者正在等待匯出的變更,因此請根據指南繪製,並提及待處理的匯出。
- 讀取專案根目錄下的
- 用文字定義範圍。 列出要製作的每個頁面或元素,以及它們各自的用途和下一個動作。
- 模稜兩可的詞彙需給出一個明確的解釋(例如:「定價頁面 = 烘焙坊的價格清單,而非訂閱方案」)。
- 當項目不只一個,或請求不明確時,請停止並確認清單。 如果只有一個明確的項目,則繼續進行。
- 對於每個項目,依序執行:
- 必需的子技能:
craft-states。 先取得其書面狀態清單及其中包含的停止點。 - 方向開放嗎? 只有在使用者徵求意見,或兩種結構上不同的版面配置都合理,且簡報和系統都未做出選擇時 → 必需的子技能:
craft-explore,然後再繪製狀態。對於多個頁面,請在範圍停止點詢問哪個頁面(如果有的話)需要選項;預設情況下,不要為每個頁面都執行一輪選項。然後,根據選擇的方向繪製狀態。如果畫面遵循現有模式,則直接進行繪製。 - 繪製主要狀態,然後是其他狀態,僅使用系統中的元件和 tokens。如果遇到新東西(元件、色彩、比例中沒有的尺寸)→ 必需的子技能:
craft-system(新增模式),然後再使用。如果某個元件存在於程式碼中但未在工具中繪製(索引中標記為「僅限程式碼」)→ 必需的子技能:craft-sync(單一元件的匯入),先僅繪製該元件。如果使用者拒絕匯入(請參閱DESIGN.md),請先詢問一次;如果他們仍然拒絕,請直接在版面上使用程式碼中的值進行建置,並加以註記。切勿繪製外觀相近的替代品,也切勿在頁面中硬編碼新的值。 - 必需的子技能:
craft-critique在自我檢查模式下對每個版面執行:轉譯它,修正其在本次任務範圍內發現的問題,然後再次轉譯。
- 必需的子技能:
- 結尾。
- 使用以下摘要展示結果。
- 將決策附加到
DESIGN.md的「決策記錄」中(日期、決策、原因)。 - 將所有已解答的問題從「開放問題」中移出。
結尾摘要(最終訊息的格式)
製作:<頁面/元素> — <位置:檔案或版面>
決策:<每個決策一行,附上原因>(也記錄於 DESIGN.md 的「決策記錄」中)
系統變更:<已新增或變更的元件/tokens> — 影響:<受影響的畫面>
自我檢查修正:<在您看到之前 craft-critique 修正了什麼>
開放問題:<使用者仍需決定的事項>
規則
| 規則 | 原因 |
|---|---|
每次都先檢查 DESIGN.md | 沒有簡報,每個畫面都會發明自己的風格 |
| 當項目不只一個時,必須在開始工作前確認範圍 | 基於錯誤解讀而建立的三個頁面,等於浪費三個頁面 |
在繪製前先透過 craft-states 列出狀態清單 | 快樂路徑只是眾多狀態中的一個 |
| 僅在方向開放時才提供選項 | 在已解決的模式上提供選項,會浪費使用者的注意力 |
僅使用系統中的元件和 tokens;新增的必須透過 craft-system | 頁面中的硬編碼值是偏離的起點 |
| 程式碼優於過時的簡報;記錄差異,不要覆蓋 | Tokens 才是最終上線的內容;簡報應透過決策更新,而非默默修改 |
| 展示前先進行自我檢查 | 使用者應該審查設計,而不是抓錯誤 |
決策必須記錄到 DESIGN.md | 下次會話的設計會從這些記錄開始,而非依靠記憶 |
完成條件
當確認範圍內的每個項目都已繪製完其狀態並完成自我檢查、所有系統變更都已透過 craft-system 處理、已給出結尾摘要,且 DESIGN.md 的「決策記錄」已更新。
常見錯誤
| 想法 | 實際情況 |
|---|---|
| 「三個頁面很清楚了,我直接做就好」 | 先確認清單。這只花一條訊息的時間。 |
| 「我這裡把按鈕做成 52px;token 說 44,但這個目標族群需要更大」 | 這是系統層級的決策。透過 craft-system 提出,然後在整個專案中使用。 |
| 「簡報說青綠色,所以我要覆蓋這個頁面 CSS 中的藍色」 | 程式碼是對的。標記衝突並詢問,不要在本機修補 tokens。 |
| 「我先展示,他們會告訴我哪裡有問題」 | 先用 craft-critique 進行自我檢查,並說明它修正了什麼。 |
| 「決策都在我的訊息裡了,這樣就夠了」 | 訊息會滾動消失。請將它們附加到 DESIGN.md。 |
| 「這個會話不能停下來等答案,所以我來自己做決定並列出它們」 | 在你的回合結束時提出問題就是停止。這樣做,不要建置任何超出第一個開放停止點的東西。 |
| 「為了節省一次來回,我把兩個停止點放在同一條訊息裡」 | 可以,但之後你必須停止。提出兩個問題,不要建置任何東西,然後等待。 |