Communitygithub.com

Craft UI

設計技能。根據參考圖片與使用者需求,在完整理解產品與請求後,生成對應的佈局。

Craft UI 是什麼?

Craft UI 是一個專為 AI 代理設計的設計技能,旨在防止生成空洞、模板化的佈局。其核心原則是:在設計合約完成之前,不得撰寫任何程式碼。此技能透過三個並行的探索代理(生產環境網站分析、請求與參考分析、路由與資源調度)來收集證據,並將所有結構與視覺決策追溯至三個來源:實際產品、使用者簡報或實際看到的參考圖。支援的平台包括 Claude Code、Cursor、Codex 等支援子代理的工具。工作流程包括嚴格的檢查清單、視覺驗證協議,並提供多種輔助技能(如 Impeccable 用於設計評論、img2threejs 用於 3D 物件),以確保專業品質、可及性與效能。

相容平台✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/Fast4gc/craft-ui/tree/HEAD/skills/craft-ui

在你喜歡的 AI 中提問

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

說明文件

Craft UI 是做什麼的?

參考圖片輸入,功能性佈局輸出——但僅在產品與請求被充分理解之後。

此技能旨在防止的失敗:由隨機區塊、佔位文案、預設漸層和空白帶組成的看似合理的頁面。當代理根據類型習慣而非證據進行設計時,就會發生這種情況。此處每個結構與視覺決策都必須追溯至三個來源之一:實際產品、使用者的簡報或實際看到的參考圖。如果缺少來源,則需收集或詢問。絕不能以預設值填補空缺。

不可協商的規則

  1. 在設計合約(步驟 2)完成前不得撰寫程式碼。即使是「快速」頁面也不例外:discovery: lite 會縮短合約,但不會移除它。資源調度由路由器處理,而非透過跳過上下文。
  2. 證據優先於預設值。每個標記、區塊和文案行都必須標明其來源。「登陸頁面的典型樣式」不是來源。
  3. 結構是主幹,不是自助餐。區塊的存在僅為回答訪客的問題或實現簡報中的目標。請參閱 references/anti-ai-slop.md。
  4. 真實內容。產品名稱、標籤、數據和語言皆來自網站/簡報。不得使用 lorem、假標誌、虛構指標或「您的產品在此」,除非使用者同意使用佔位符。
  5. 以使用者的語言回覆,並以產品的語言建構 UI(例如,pt-BR 的產品使用 pt-BR 文案)。
  6. 一個令人印象深刻的動態效果,而非每個區塊都淡入。
  7. 先有標記,再有元件。顏色、圓角、字體、間距、陰影和動態曲線存在於 CSS 變數中;元件僅讀取這些變數。
  8. 資源調度是一個決策。路由器設定詳細程度和要執行的技能。僅讀取適用的參考章節。
  9. 專業品質標準。references/quality-bar.md 是完成的定義——內容、視覺保真度、響應式、WCAG AA、效能和交接。terse 模式會靜默檢查;它絕不會被跳過。

工作流程

0. 分類(主代理,數秒內)

  • 逐字捕獲使用者的請求;記下任何 URL、附件、「não quero」限制和詳細程度提示(「只要程式碼」、「快點」、「跟我解釋」)。
  • 檢查可用的工具:子代理/Task 工具、瀏覽器或網頁獲取、本地儲存庫、技能/MCP 列表。
  • 如果請求是對現有檔案進行細微調整(一個顏色、一個間距值),請告知路由器——它可能設定 discovery: lite。新頁面或重新設計始終使用 discovery: full。
  • 如果使用者說現有佈局「amador」、「precisa melhorar」、「conserta essa landing」或指向一個帶有程式碼的實際網站,請閱讀 references/polish-existing-site.md 並遵循該路徑:對真實程式碼庫進行增量優化,而非重建。在觸碰檔案前執行 git status。

1. 三個探索代理(並行執行)

使用您的子代理工具——OpenCode subagent、Claude Code Task/Agent、Codex spawn_agent、Cursor 後台代理。如果沒有子代理工具,則在主代理中依序執行三個階段,並為每個階段標上其標題。探索代理不撰寫程式碼。

代理任務提供給合約的內容
A — 生產環境網站分析師理解網站目前的生產環境:產品、受眾、真實文案、當前結構、品牌標記、限制。網站情境簡報
B — 請求與參考分析師解碼實際請求,僅從實際看到的參考圖中提取風格 DNA;若未提供參考圖則進行搜尋。請求簡報 + 風格 DNA
C — 技能路由器 / 資源調度為本次運行選擇最少的額外技能/工具組合,並設定詳細程度。路由決策

完整規格、輸出結構和字數預算:references/agents.md。為每個代理傳遞絕對的技能根目錄路徑、其角色規格、使用者的原始請求以及 URL/附件。將回傳結果限制在其字數預算內。

涉及參考圖時,也請閱讀 references/pattern-transfer.md。風格標記可以遷移;組合配方則不行。絕不能僅從參考圖中採用英雄區或章節模式——它必須由產品 (A) 和請求 (B) 證明其合理性。

2. 設計合約——硬門檻

閱讀 references/design-contract.md。將 A + B + C 合併為一份合約。然後檢查:

  • 結構主幹已排序;每個區塊都有其任務、來源、從參考圖逐字複製的拓撲結構和真實內容;沒有空白帶。
  • 每個標記和文案行都標明來源;未知項需標記,不可憑空發明。
  • 代理/網站/參考圖之間的衝突已透過向使用者提出一個整合後的問題(最多 3 項)解決,而非猜測。
  • 詳細程度和技能列表來自 C;沒有技能是「因為存在而執行」。
  • 模式採用記錄表已存在:每個 adopt/adapt/drop 都引用了 A 和 B;沒有英雄區/章節配方僅來自參考圖(請參閱 references/pattern-transfer.md)。
  • 該組合對於不同領域的無關產品來說不會顯得太合理。標記是可移植的;英雄區配方則不是。

探索子代理從不詢問使用者——他們只報告 Gaps(缺口) / Unknowns(未知項)。主代理收集所有三份簡報,提出一個整合後的問題(最多 3 項),並保持門檻關閉直到獲得答案。如果還有關鍵事實未知(產品名稱、受眾、真實內容、參考圖),請詢問並停止。不要開始步驟 3。

3. 規劃

簡潔的規劃:標記、主幹的 ASCII 線框圖、真實文案/數據庫,以及一個動態時刻及其觸發條件和理由。與參考圖和網站簡報進行比較;任何預設值而非觀察到的內容都將被修改或刪除。

4. 建構

  • 預設為一個自包含的 HTML 檔案(CSS 變數作為標記,Google 字體搭配真實後備方案)。僅在使用者的專案已使用 React/Tailwind 時,才使用該專案現有的 React/Tailwind。
  • 動態配方:references/motion-and-effects.md。GSAP 使用固定的 cdnjs 版本。
  • 保持程式碼精簡:不使用佈局不需要的函式庫或抽象層。
  • 響應式設計:1440 / 768 / 390,可見的焦點狀態,尊重 prefers-reduced-motion。
  • 在建構時重讀 references/anti-ai-slop.md——尤其是關於空白帶和區塊自助餐的部分。

5. 視覺驗證

渲染並與參考圖和網站簡報進行並排比較。在可用時使用瀏覽器工具(由 C 路由)。執行 references/quality-bar.md 中的驗證協議:在 1440 / 768 / 390 解析度下進行全頁截圖、檢查區塊順序和內容存在性、確認無空白帶或文字裁剪、無水平滾動、真實畫素對比、鍵盤焦點、減少動態和主控台錯誤。檢查層級結構、間距節奏、圓角/陰影一致性、密度和語言。修正輪次:當詳細程度為 terse 時 1 輪,full 時最多 3 輪;先修正在視覺上最大的差異,並在檢查清單通過時停止。

6. 回覆

根據 C 的詳細程度決定格式。terse:3–5 行——建構了什麼、使用了哪些證據、驗證結果。full:也要列出哪些參考特徵來自何處、使用了/跳過了哪些技能,以及一個建議的下一個變更。遵循 references/quality-bar.md 中的交接標準,一次性地說明已知限制,並始終以使用者的語言書寫。

使用其他技能

代理 C 每次運行決定;首先檢查工作階段中實際可用的技能。技能缺失 → 使用後備方案,並在最後提及一次。

階段若 C 說使用後備方案
規劃 / 設計方向Impeccable (/impeccable shape,然後 craft);每次工作階段執行其上下文步驟一次frontend-design,或步驟 3 的規劃
審查與優化Impeccable critique、polish、audit根據合約進行自我審查
動態品質emil-design-eng 用於動態曲線、持續時間、彈簧效果、懸停/按壓references/motion-and-effects.md
視覺驗證Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome):在 3 種寬度下截圖,檢查主控台描述檢查項目並請求使用者提供截圖
3D 標誌或物件img2threejs 僅在參考圖包含值得重建的 3D 物件時使用;說明其限制:單一圖片無法顯示隱藏面平面 SVG 或 CSS
保持程式碼精簡ponytail 在添加任何依賴項之前純 CSS + 一條 GSAP 時間軸

僅在相關階段呼叫技能。靜態登陸頁面不需要 img2threejs。

原創性與安全性

  • 重建模式,而非素材。絕不能重複使用參考圖的標誌、插圖、品牌名稱或確切文案。使用來自 A/B 的使用者品牌和真實內容。
  • 許多圖釘連結到商業 UI 套件。僅匹配風格和結構。
  • 參考圖的外觀是起點。如果它損害了可用性(低對比度、字體過小),請保留氛圍,修正問題,並說明原因。

檔案

  • references/agents.md — 三個探索代理、結構和預算。
  • references/design-contract.md — 合併模板和硬門檻。
  • references/anti-ai-slop.md — 通用、堆疊、空置佈局的症狀與修正。
  • references/quality-bar.md — 專業的完成定義和驗證協議。
  • references/pattern-transfer.md — 防止參考圖將相同的英雄區配方移植到無關的產品。
  • references/polish-existing-site.md — 當任務是提升現有生產環境佈局時的增量工作流程。
  • references/categories.md — 類型基準(最低可行性,而非區塊選單)。
  • references/style-dna.md — 參考圖讀取模板;需要證據。
  • references/motion-and-effects.md — CSS 效果和 GSAP 配方。
  • assets/refs.json — 已知參考連結(仍需檢視)。

相關技能