Communitygithub.com

UI 設計

在設計、建置或審查任何 UI 畫面或元件(網頁或行動裝置)之前載入:佈局、間距、字體、色彩、陰影、按鈕、表單、卡片、圖示、導覽、圖像、文案、動畫、無障礙、空狀態/錯誤狀態。每個畫面都遵循的規則都在這裡,每個主題對應一個參考檔案:僅讀取任務會觸及到的檔案。

UI 設計 是什麼?

此技能提供一套全面的 UI 設計規則系統,旨在作為開發者在建置或審查任何 UI 畫面或元件(網頁或行動裝置)時的指導方針。這些規則源自《UI 設計原則》一書,並補充了無障礙標準(WCAG)和業界慣例。其主要功能是提供一個結構化的參考架構,內含多個 Markdown 檔案,每個主題(如 tokens、佈局、排版、色彩、按鈕、表單、卡片、圖示、導覽、圖像、文案、動畫、無障礙、系統及狀態、檢查清單)各有一個檔案。技能的核心原則是優先使用專案倉庫既有的設計系統(如 Tailwind 設定、CSS 變數、shadcn/MUI 主題),僅在需要時才填補空白,且絕不會引入一組衝突的 tokens。它明確了衝突解決的優先順序(可用性 > 無障礙 > 一致性 > 簡潔性 > 美觀),並提供一個快速路徑:先確定品牌個性,建立 tokens,以灰階優先進行佈局,為每個元件和畫面狀態進行設計,最後使用檢查清單進行審查。此技能支援 Claude Code、Cursor、Codex 等 AI 代理平台,透過結構化的規則和參考檔案,確保輸出兼具一致性、可用性與無障礙性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

UI 設計:建立介面的規則

這些規則濃縮自 Michael Filipiuk 的《UI 設計原則》(2021 年版)。此檔案包含適用於每個畫面的規則。references/ 資料夾(位於此檔案旁)則存放各主題的詳細內容,每個主題一個檔案;僅讀取你的任務會觸及到的檔案。

無標籤的規則皆來自該書。(WCAG) 標記該書未提及的無障礙標準。(convention) 標記為填補缺口而加入的常見業界慣例值。(derived) 標記使用該書自有方法計算出的值。書中的 1 pt 等於 1 CSS px 等於 1 iOS pt 等於 1 Android dp。

專案倉庫的設計系統優先

如果專案倉庫已有 tokens 或主題(如 Tailwind 設定、CSS 變數、shadcn/MUI 主題、components/ui/ 函式庫),請使用它們。此技能僅用來補充它們未定義的部分。

  • 切勿在專案倉庫的 tokens 旁引入第二組 tokens。
  • 重複使用現有元件,而不是建立一個並行的元件。
  • 當專案倉庫本身違反了以下任一規則(例如對比度不足、按鈕高度為 32 px),請保留專案倉庫的值,並回報此衝突。請勿靜默地覆蓋它。

規則衝突時的優先順序: 可用性 > 無障礙 > 一致性 > 簡潔性 > 美觀。

快速路徑

  1. 先確定個性: 基於品牌和受眾,選擇活潑、中性或嚴肅 (references/personality-and-copy.md)。切勿根據個人品味。
  2. 畫面之前先有 tokens: 從專案倉庫或 references/tokens.md 取得色彩、字體級數和間距級數。禁止使用這些範圍之外的值。
  3. 灰階優先: 先確保層級、佈局和間距正確,然後只在有必要的地方加入色彩。
  4. 元件需具備所有狀態(預設、懸停、按下、焦點、禁用、錯誤、成功),且每個畫面需具備所有狀態(空、載入中、錯誤、404)。
  5. 在報告完成之前: 針對你所建置的內容,檢查 references/checklist.md。如果可以截圖,請檢查截圖,而不是檢查程式碼。

不容妥協的原則

  1. 間距必須來自級數。 行動裝置使用 4 pt 級數,網頁使用 8 pt 級數。禁止使用 5、13 或 22 px 的值。
  2. 內文文字大小為 16–17 px。 任何文字都不得低於 10 px,建議使用 12 px 或更大。切勿對小號文字使用 Light 字重。
  3. 使用一種字體, 預設為無襯線字體。約使用 5 種大小。
  4. 文字或陰影切勿使用 #000000。 請使用深色帶灰調的顏色,例如 #1F1F1F。
  5. 使用一種主要色彩, 僅應用於必須突出的元素。如果所有東西都突出,那就等於什麼都沒突出。
  6. 對比度: 內文文字需達到 4.5:1,大號文字和 UI 元件需達到 3:1 (WCAG)。
  7. 切勿僅使用色彩來傳達意義。 錯誤訊息、成功訊息和連結也需搭配圖示、文字、字重或底線。
  8. 每個點擊或觸碰目標至少為 44×44, 即使可見的圖示較小。
  9. 按鈕高度為 40–60 px, 每組僅一個主要按鈕。當按鈕成對出現時,主要按鈕在右側。按鈕標籤需精確說明將發生的動作。
  10. 輸入框務必有可見的標籤。 僅有預留文字不算標籤。使用單欄式表單搭配內嵌驗證,且絕不應清除使用者已輸入的內容。
  11. 陰影應柔和(較大的 Y 軸偏移、較大的模糊值、5–10% 不透明度),且僅用於互動式或浮起的元素。
  12. 圖示來自同一套件, 風格一致,具有相同的筆畫寬度和圓角。不為人熟知的圖示需附上標籤。
  13. 動畫用於提供反饋, 持續時間低於 1000 毫秒,並使用緩動函數(絕不應是線性)。
  14. 不要使用 Lorem Ipsum。 撰寫真實、簡短、人性化的文案。錯誤訊息應說明如何解決問題。對話框應指明物件及其後果。
  15. 相同事物,相同外觀,相同行為,需在不同畫面間保持一致。遵循平台模式來決定行為。

該讀取哪個參考檔案

任務觸及到請讀取
新專案或新主題,選擇數值tokens.md(間距、字體級數、色彩角色、圓角、陰影、動畫、入門 CSS)
頁面或畫面佈局、網格、間距、層級layout.md
文字樣式、標題、段落typography.md
調色盤、深色模式、陰影、漸層color-and-depth.md
按鈕和行動呼籲按鈕buttons.md
表單、輸入框、下拉選單、核取方塊、驗證forms.md
卡片、項目列表cards.md
圖示icons.md
分頁列、頂部導覽、側邊欄、連結navigation.md
照片、插圖、空狀態和 404 藝術imagery.md
品牌感受、按鈕標籤、對話框、錯誤訊息、語氣personality-and-copy.md
轉場、懸停、載入、反饋motion.md
對比度、替代文字、目標大小、說明文字accessibility.md
要重複使用的元件、狀態、空/404 畫面、設計系統system-and-states.md
審查完成的畫面checklist.md

所有路徑均位於此技能的 references/ 資料夾下。

相關技能