Communitygithub.com

設計設定 (craft-setup)

當專案根目錄尚無 DESIGN.md,且請求涉及設計、建立頁面、畫面或元素,或要求設定設計、樣式、品牌或指南時使用。

設計設定 (craft-setup) 是什麼?

此技能用於在專案中建立設計基礎。它首先引導開發者或設計師閱讀現有檔案(如 README、CSS、Token 檔案等),並透過逐一提問來訪談使用者,了解產品定義、目標受眾、品牌調性、參考資料與限制條件。技能會強制要求提供 2-5 個參考產品或網站,並針對每個參考詢問「取用什麼」與「避免什麼」,以確保設計決策有依據。訪談結束後,技能會根據模板產生 `DESIGN.md`,包含產品、受眾與語調、情緒、品牌、參考資料、限制、決策記錄與開放問題等八個區段。接著技能會判斷程式碼中是否已存在設計系統(如 UI 套件或 Token 檔案),若無則自動叫用 `craft-system` 建立基礎元素(Token、字體、間距、互動規則),若有則提供 `craft-sync` 匯入選項。此技能支援任何能操作檔案與 Markdown 的工具,若無設計工具則可回退至 HTML 實作。關鍵原則是「先讀後問、不發明品牌」,所有未經確認的推測都必須標記為「(assumed)」並列入開放問題。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設計設定

概述

在第一個畫面之前,先確認產品是什麼、為誰而做、應該感覺如何、以及絕對不能看起來像什麼。將這些內容寫入 DESIGN.md,這份簡報將成為後續所有設計決策的首要參考。提問,而非發明:由 agent 憑空創造的品牌只是一種猜測,使用者最終得逐一修正。閱讀現有資料,逐一訪談使用者,撰寫簡報,暫停等待批准,然後才建立基礎架構。

使用時機

  • 設計任務且專案根目錄沒有 DESIGN.md。
  • 「設定設計」、「定義我們的樣式 / 品牌 / 指南」、/craft-setup (/craft:craft-setup in the Claude Code plugin)。

不應使用時機

  • DESIGN.md 已存在且任務是設計:使用 craft。
  • 只修改一個 Token 或一項指南:使用 craft-system。

步驟

  1. 先閱讀。 README、文件、現有的 CSS 或 Token、設計檔案、品牌資料夾、任何舊的 DESIGN.md 草稿。記錄下它們已經回答了哪些問題。如果程式碼中已有設計系統(UI 套件、Token 檔案、元件庫),請說明其數量,並在簡報的品牌區段寫入「Design system source: <path>」。在第 6 步中,提供匯入設計工具的選項,而非從頭建立基礎;已回答的品牌問題將被跳過。有兩個 UI 套件 → 先詢問哪一個是來源,再跳過品牌問題。永遠不問檔案已回答的問題。 用一行話確認即可(例如:「你的 README 說只有 pt-BR 且成員超過 60 歲,所以我會設計 18px 文字和 48px 觸控點」)。
  2. 訪談,每次一則訊息。 依序遵循訪談指引:產品、受眾與語調、情緒、品牌、參考資料、限制。
    • 盡可能提供 3–5 個選項加上「其他」。
    • 跳過任何已回答的問題。
    • 當答案足以設計第一個畫面時就停止。六個好答案勝過十五個。
  3. 參考資料是必需的。 要求提供 2–5 個他們喜歡的產品、網站或圖片。針對每個參考,詢問取用什麼以及避免什麼。如果是你可以開啟的連結或圖片,先觀察並描述你所看到的,再提問。
  4. 撰寫 DESIGN.md 於專案根目錄,使用範本,包含全部八個區段:產品、受眾與語調、情緒、品牌、參考資料、限制、決策記錄、開放問題。
    • 盡量使用他們的用語。
    • 任何你推測而未被確認的內容,放入開放問題,不要當作事實寫入簡報。
  5. 暫停並展示 DESIGN.md 給使用者。 修改直到他們批准。
  6. 基礎架構。
    • 程式碼中已有設計系統: 提供匯入選項。如果同意,必要子技能: 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 很亂,我來重構」擴展它們。重構是另一個需批准的獨立變更。
「沒給參考資料,跳過那個區段」要求提供。如果他們沒有,提供三個符合情緒的參考,並詢問每個參考的取用與避免。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能