Communitygithub.com

Craft

用於設計、建立、模擬或重新設計一個或多個頁面、畫面、流程或UI元素,或當使用者執行 /craft 指令時使用。

Craft 是什麼?

Craft 是視覺設計的入口技能,能將「設計定價頁面」之類的請求轉化為完整且經過審查的設計。它會從專案的簡報 (DESIGN.md) 開始,涵蓋所有狀態,僅在方向不明確時提供選項,僅使用設計系統中的元件,並在展示前自我檢查。此技能支援 Claude Code、Cursor 等開發工具,並會依序呼叫 craft-setup、craft-states、craft-explore、craft-system、craft-sync 和 craft-critique 等子技能來完成工作。使用者必須先確認範圍,技能會確保設計與程式碼保持一致,並將所有決策記錄到 DESIGN.md 中,以利後續追蹤。

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

在你喜歡的 AI 中提問

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

說明文件

Craft 是做什麼的?

概述

這是製作任何視覺設計的總入口。它能將「設計定價頁面」轉化為一個完整且經過審查的設計。它會從專案的簡報出發,涵蓋所有狀態,僅在方向不明確時提供選項,只使用設計系統中的既有元件,並在展示前檢查自己的作品。它會在固定時間點呼叫其他設計技能,而不是取代它們。

使用時機

  • 「設計 / 建立 / 模擬 / 重新設計 <頁面、畫面、流程、元素>」,使用 /craft(在 Claude Code 外掛中為 /craft:craft)。
  • 同時設計多個頁面(例如:「設計入門流程:歡迎頁、註冊頁、驗證頁」)。

不該使用時機

  • 使用者已經精確描述的小修改(一個值、一個標籤、一個尺寸):直接進行修改。
  • 僅要求審查(「這個有什麼問題?」):請使用 craft-critique。僅要求提供選項:請使用 craft-explore。

開始之前

  • 如果在 references/adapters/ 中沒有與你的工具匹配的轉接器,請在你的工具中執行相同的操作,並說明哪些是手動對應的。如果完全沒有設計工具,請使用 HTML 進行建置(html.md)。如果你只有圖片,請說明從圖片中讀取的值是估算值。

停止點是真實存在的

停止點代表:在你的回合結束時提出問題並等待。你隨時可以這樣做,即使在一次性或無頭會話中,你最後的訊息就是問題。永遠不要因為會話「等不及」或「為了節省來回次數」而替使用者決定停止點。 自己決定只會把原本五秒鐘就能回答的問題變成數小時的重做。

步驟

  1. 背景脈絡。
    • 讀取專案根目錄下的 DESIGN.md。如果缺少該檔案,或沒有「Product」區段(僅為同步記錄)→ 必需的子技能:craft-setup,然後再回到這裡。
    • 讀取設計系統(tokens、元件、指南)以及與此頁面相關的畫面。
    • 當簡報與程式碼不一致時(例如簡報說青綠色,但 tokens 說藍色):遵循程式碼,用一句話說明,將衝突新增至 DESIGN.md 的「開放問題」中,並提議修正其中錯誤的一方。切勿在頁面自身的 CSS 中覆蓋 tokens。
    • 當設計工具的指南與程式碼不同,且存在 design-sync.json 時,不要認為指南過時。根據以下規則進行分類:程式碼已變更 → 在繪製前提議重新整理指南;指南已變更 → 這是使用者正在等待匯出的變更,因此請根據指南繪製,並提及待處理的匯出。
  2. 用文字定義範圍。 列出要製作的每個頁面或元素,以及它們各自的用途和下一個動作。
    • 模稜兩可的詞彙需給出一個明確的解釋(例如:「定價頁面 = 烘焙坊的價格清單,而非訂閱方案」)。
    • 當項目不只一個,或請求不明確時,請停止並確認清單。 如果只有一個明確的項目,則繼續進行。
  3. 對於每個項目,依序執行:
    1. 必需的子技能:craft-states。 先取得其書面狀態清單及其中包含的停止點。
    2. 方向開放嗎? 只有在使用者徵求意見,或兩種結構上不同的版面配置都合理,且簡報和系統都未做出選擇時 → 必需的子技能:craft-explore,然後再繪製狀態。對於多個頁面,請在範圍停止點詢問哪個頁面(如果有的話)需要選項;預設情況下,不要為每個頁面都執行一輪選項。然後,根據選擇的方向繪製狀態。如果畫面遵循現有模式,則直接進行繪製。
    3. 繪製主要狀態,然後是其他狀態,僅使用系統中的元件和 tokens。如果遇到新東西(元件、色彩、比例中沒有的尺寸)→ 必需的子技能:craft-system(新增模式),然後再使用。如果某個元件存在於程式碼中但未在工具中繪製(索引中標記為「僅限程式碼」)→ 必需的子技能:craft-sync(單一元件的匯入),先僅繪製該元件。如果使用者拒絕匯入(請參閱 DESIGN.md),請先詢問一次;如果他們仍然拒絕,請直接在版面上使用程式碼中的值進行建置,並加以註記。切勿繪製外觀相近的替代品,也切勿在頁面中硬編碼新的值。
    4. 必需的子技能:craft-critique 在自我檢查模式下對每個版面執行:轉譯它,修正其在本次任務範圍內發現的問題,然後再次轉譯。
  4. 結尾。
    • 使用以下摘要展示結果。
    • 將決策附加到 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。
「這個會話不能停下來等答案,所以我來自己做決定並列出它們」在你的回合結束時提出問題就是停止。這樣做,不要建置任何超出第一個開放停止點的東西。
「為了節省一次來回,我把兩個停止點放在同一條訊息裡」可以,但之後你必須停止。提出兩個問題,不要建置任何東西,然後等待。

Individual skills in this repo

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

相關技能