Communitygithub.com

carmahhawwari/ui-design-brain

使用來自 60 多個真實介面元件的模式與最佳實踐,產生符合設計系統慣例、而非通用 AI 風格的生產級 UI。當使用者要求建構網頁、儀表板、表單、導航等介面時,使用此技能以確保產出現代、極簡、SaaS 品質的結果。

ui-design-brain 是什麼?

這項技能提供一個由 60 多個 UI 元件模式組成的精選知識庫,這些模式源自 component.gallery,並融入了最佳實踐、佈局指南與使用規則。它用真實的設計系統知識取代了通用型猜測,當你需要產生任何前端程式碼時(例如 React、HTML/CSS 或 Tailwind UI),都應先查閱此技能以選擇正確的元件並遵循其最佳實踐。此技能支援多種風格方向(如 Modern SaaS、Apple-level Minimal、Enterprise / Corporate 等),並強調約束、排版層級與可及性。它記錄了完整的設計哲學(包含核心原則與品質標準)以及一套逐步的工作流程,從辨識所需元件、套用最佳實踐、選擇設計方向到產生符合生產標準的程式碼,最後還列出常見的反模式以供避免。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add carmahhawwari/ui-design-brain

在你喜歡的 AI 中提問

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

說明文件

UI 設計腦 (UI Design Brain)

此技能提供一個來自 component.gallery 的 60 多個 UI 元件模式的精選知識庫,並融入了最佳實踐、佈局指南與使用規則。它用真實的設計系統知識取代了通用型猜測,當你產生介面時將不再依賴泛泛的假設。

在撰寫任何 UI 程式碼之前,請先諮詢此技能以選擇正確的元件並遵循其最佳實踐。請閱讀 components.md 以取得完整參考。

何時使用此技能

每當使用者要求建立、設計或產生以下內容時,請套用此技能:

  • 網頁、登陸頁面、行銷網站
  • SaaS 儀表板、管理後台、設定頁面
  • 表單、資料表格、導航結構
  • 模態框、抽屜、彈出面板或覆蓋模式
  • 任何 React、HTML/CSS 或 Tailwind UI 元件

設計理念

每個產生的介面都應感覺 現代、極簡且可以投入生產 — 而非像個樣板。

核心原則

  1. 節制勝於裝飾。 更少的元素,更高的精緻度。留白本身就是一種特色。
  2. 排版承載層級。 將獨特的展示字體與乾淨的正文字體搭配。最大化標題與標籤之間的字重對比。
  3. 一個強烈的色彩亮點。 首先使用中性色調(溫暖的米白、接近黑色的深色、柔和的中間色調)。引入一個自信的強調色。如果某個設計能出現在海報或書封上,它很可能就是永恆的。
  4. 間距即結構。 使用 8 像素網格。較緊的間距用於分組相關元素;寬敞的間距則讓主視覺內容得以呼吸。
  5. 可及性不容妥協。 符合 WCAG AA 對比度標準。需要焦點指示器。使用語意化 HTML。支援鍵盤導航。
  6. 避免通用 AI 美學。 避免:紫色配白色漸層、Inter/Roboto 預設字體、平均分佈的卡片網格,以及千篇一律的佈局。每個介面都應根據其特定情境來設計。

品質標準

輸出成果應符合你對頂級 SaaS 公司資深產品設計師的期望:

  • 乾淨的視覺韻律,帶有刻意的不對稱性
  • 明顯的互動提示(懸停、焦點、啟用狀態)
  • 優雅的邊緣情況(空狀態、載入中、錯誤)
  • 響應式設計,且無斷點人工製品

工作流程

步驟 1 — 辨識元件

閱讀使用者的請求,判斷需要哪些 UI 元件。參考 components.md,根據元件名稱或別名找到每個元件。

常見對應:

  • "導航" → 頁首、導航、麵包屑、分頁標籤
  • "表單" → 表單、文字輸入、選取框、核取方塊、單選按鈕、按鈕
  • "資料顯示" → 表格、卡片、列表、徽章、大頭貼
  • "回饋" → 警示、訊息提示、模態框、旋轉圖示、進度條、空狀態
  • "輸入" → 文字輸入、文字區域、選取框、組合框、日期選擇器、檔案上傳、滑桿
  • "覆蓋層" → 模態框、抽屜、彈出面板、工具提示、下拉選單

步驟 2 — 套用最佳實踐

對於介面中的每個元件,遵循參考資料中的最佳實踐。廣泛適用的關鍵規則如下:

佈局

  • 單列表單 — 掃描更快
  • 重複行(列表、表格)中保持一致的垂直通道
  • 圖示和操作使用固定寬度的預留位置,即使為空
  • 卡片:媒體 → 標題 → 元資料 → 操作層級

互動

  • 按鈕:以動詞為主的標籤("儲存變更",而非"提交"),每個區段一個主要按鈕
  • 模態框:始終提供 X、取消和 Escape 關閉;鎖定焦點;關閉時歸還焦點
  • 訊息提示:4-6 秒自動關閉,允許手動關閉,最新的疊在最上面
  • 切換開關:僅即時生效 — 在需要點擊儲存的表單中使用核取方塊

排版與間距

  • 嚴格的標題層級(h1 → h2 → h3),每個頁面一個 h1
  • 在行動裝置上,觸控目標最小 44 像素
  • 標籤位於輸入框上方(垂直表單)或旁邊(水平表單)
  • 佔位符文字用作格式提示,絕不可取代標籤

狀態

  • 空狀態:插圖 + 有用的標題 + 主要行動呼籲按鈕
  • 載入中:骨架螢幕 > 旋轉圖示(在 300 毫秒延遲後顯示)
  • 驗證:在失焦時進行行內驗證,而非每次按鍵
  • 停用元素:視覺上可區分,但仍應可讀

步驟 3 — 選擇設計方向

選擇最符合使用者意圖的風格預設,若不確定則詢問:

現代 SaaS(預設)

  • 中性色調,一個強烈的強調色
  • 8 像素網格,大量留白
  • 乾淨、專業、寬敞

Apple 級極簡

  • 近乎單色,溫暖的灰色
  • 大型字體層級,展示文字採用緊湊字距
  • 大量留白,微互動(150–250 毫秒 ease-out)

企業 / 公司風格

  • 資訊密集,區域劃分明確
  • 緊湊的間距尺度(4/8/12/16/24 像素)
  • 穩健的表單處理,完全可鍵盤導航

創意 / 作品集風格

  • 大膽、富有表現力,強烈的視覺個性
  • 不對稱佈局,戲劇性的尺寸對比
  • 編輯風格的排版,鮮明的強調色

資料儀表板風格

  • 資料密集,針對可掃描性最佳化
  • 跨列保持一致的垂直對齊
  • 清晰的指標層級:KPI → 趨勢 → 細節

步驟 4 — 產生程式碼

按照以下規則撰寫可投入生產的程式碼:

技術棧:       React + Tailwind CSS(除非使用者另有指定)
間距:         使用 Tailwind 間距尺度(p-2, gap-4 等),基於 8px 網格
顏色:         使用 CSS 變數或 Tailwind 設定以確保色板一致性
排版:         Tailwind 文字工具;透過 Google Fonts 使用富有表現力的字體搭配
狀態:         為所有互動元素實作 hover、focus、active、disabled 狀態
響應式:       行動優先;在 375、768、1440 像素寬度下測試
可及性:       語意化 HTML、必要時使用 ARIA、焦點管理

元件快速參考

以下是 15 個最常用元件。完整的 60 多個元件參考(含最佳實踐、別名和佈局範例)請參閱 components.md。

元件使用時機關鍵規則
Button觸發操作以動詞為主的標籤;每個區段一個主要按鈕
Card代表一個實體媒體 → 標題 → 元資料 → 操作;陰影或邊框,二選一
Modal需要集中注意力鎖定焦點;使用 X + 取消 + Escape 關閉
Navigation頁面/區段連結最多 5–7 個項目;明確的啟用狀態
Table結構化資料固定標題欄;數字靠右對齊;可排序的欄位
Tabs切換面板2–7 個分頁;啟用指示器;在行動裝置上轉為手風琴
Form收集輸入單欄;標籤在上方;失焦時進行行內驗證
Toast簡短確認4–6 秒自動關閉;破壞性操作提供復原功能
Alert重要狀態語意顏色 + 圖示;最多兩句話
Drawer次要面板右側用於詳細資訊,左側用於導航;桌面上 320–480 像素
Search input尋找內容Cmd/Ctrl+K 快捷鍵;防抖 200–300 毫秒
Empty state無資料插圖 + 標題 + 行動呼籲按鈕;正向表述
Skeleton載入中的佔位符匹配實際佈局形狀;閃爍動畫
Badge狀態/元資料標籤1–2 個詞;狀態使用藥丸形狀;色彩數量有限
Dropdown menu操作/導航選項7±2 個項目;破壞性操作放在最後,以紅色顯示

應避免的反模式

切勿產生以下內容 — 它們代表通用、低品質的 UI:

  • 彩虹徽章 — 每個狀態都用不同亮色,且無語意意義
  • 模態框內嵌模態框 — 複雜流程應使用頁面或抽屜
  • 不附說明的停用提交按鈕 — 始終指出缺少什麼
  • 為可預測的佈局使用旋轉圖示 — 改用骨架螢幕
  • 「點擊這裡」連結 — 連結文字必須描述目的地
  • 桌面版漢堡選單 — 空間允許時使用可見導航
  • 自動輪播 — 讓使用者控制導航
  • 僅使用佔位符的表單欄位 — 始終使用可見標籤
  • 同等權重的按鈕 — 建立主要/次要/第三層級
  • 過小的文字(< 12 像素) — 正文文字最小 14 像素,建議 16 像素

相關技能