Communitygithub.com

UI/UX Pro Max - 設計智慧

全面的 Web 與行動應用程式 UI/UX 設計指南,整合 50 多種風格、97 色調色盤、57 種字體配對及 9 大技術堆疊。

UX Pro Max - 設計智慧 是什麼?

這項技能是一個綜合性的 UI/UX 設計知識庫,專為 AI 編碼代理(如 Claude Code、Cursor 等)打造。它涵蓋了從無障礙設計、觸控互動、佈局響應式、排版色彩到動畫與樣式選擇等完整的設計準則,並以優先級劃分,確保 AI 能產出高品質的專業級 UI。此技能支援 React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter 及 Tailwind CSS 等多種主流技術堆疊,並能透過 CLI 工具進行智慧搜尋,快速取得特定情境的設計建議、字體配對與色彩組合。其核心工作流程是先使用 `--design-system` 指令自動生成完整的設計系統(包含樣式、色彩、排版等),之後可透過 `--persist` 保存設計規範,實現跨會話的層級式設計系統管理,再輔以領域特定搜尋來微調細節。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ProjectZeroDays/FreeAI_AI_Inference_Workstation/tree/HEAD/skills/ui-ux-pro-max

在你喜歡的 AI 中提問

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

說明文件

UX Pro Max - 設計智慧 是做什麼的?

全面的 Web 與行動應用程式設計指南。包含 50+ 種風格、97 個色調色盤、57 種字體配對、99 條 UX 指南以及 25 種圖表類型,橫跨 9 個技術堆疊。支援基於優先級的推薦搜尋資料庫。

何時套用

在以下情況參考這些指南:

  • 設計新的 UI 元件或頁面時
  • 選擇色調色盤與排版時
  • 審查程式碼以找出 UX 問題時
  • 建立登陸頁面或儀表板時
  • 實作無障礙需求時

按優先級分類的規則

優先級類別影響領域
1無障礙關鍵ux
2觸控與互動關鍵ux
3效能高ux
4佈局與響應式高ux
5排版與色彩中typography, color
6動畫中ux
7樣式選擇中style, product
8圖表與資料低chart

快速參考

1. 無障礙 (關鍵)

  • color-contrast - 一般文字的最小對比度為 4.5:1
  • focus-states - 可互動元素上要有明顯的焦點環
  • alt-text - 為有意義的圖片提供描述性的替代文字
  • aria-labels - 為僅有圖示的按鈕提供 aria-label
  • keyboard-nav - Tab 順序應與視覺順序一致
  • form-labels - 使用帶有 for 屬性的 <label>

2. 觸控與互動 (關鍵)

  • touch-target-size - 觸控目標最小為 44x44px
  • hover-vs-tap - 主要互動使用點擊/輕觸
  • loading-buttons - 非同步操作期間停用按鈕
  • error-feedback - 在問題附近提供明確的錯誤訊息
  • cursor-pointer - 為可點擊元素添加 cursor-pointer

3. 效能 (高)

  • image-optimization - 使用 WebP、srcset、延遲載入
  • reduced-motion - 檢查 prefers-reduced-motion
  • content-jumping - 為非同步內容預留空間

4. 佈局與響應式 (高)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - 行動裝置上主體文字最小 16px
  • horizontal-scroll - 確保內容符合視窗寬度
  • z-index-management - 定義 z-index 層級 (10, 20, 30, 50)

5. 排版與色彩 (中)

  • line-height - 主體文字使用 1.5-1.75
  • line-length - 每行限制在 65-75 個字元
  • font-pairing - 搭配標題/主體字型的風格

6. 動畫 (中)

  • duration-timing - 微互動使用 150-300ms
  • transform-performance - 使用 transform/opacity,而非 width/height
  • loading-states - 使用骨架螢幕或旋轉動畫

7. 樣式選擇 (中)

  • style-match - 樣式應符合產品類型
  • consistency - 所有頁面使用相同樣式
  • no-emoji-icons - 使用 SVG 圖示,而非表情符號

8. 圖表與資料 (低)

  • chart-type - 圖表類型應符合資料類型
  • color-guidance - 使用無障礙色調色盤
  • data-table - 為無障礙提供表格替代方案

如何使用

使用下方的 CLI 工具搜尋特定領域。


先決條件

確認 Python 是否已安裝:

python3 --version || python --version

如果 Python 未安裝,請根據使用者的作業系統安裝:

macOS:

brew install python3

Ubuntu/Debian:

sudo apt update && sudo apt install python3

Windows:

winget install Python.Python.3.12

如何使用此技能

當使用者要求 UI/UX 工作(設計、建構、建立、實作、審查、修復、改進)時,請遵循此工作流程:

步驟 1:分析使用者需求

從使用者請求中提取關鍵資訊:

  • 產品類型:SaaS、電商、作品集、儀表板、登陸頁面等
  • 風格關鍵字:極簡、活潑、專業、優雅、深色模式等
  • 產業:醫療保健、金融科技、遊戲、教育等
  • 技術堆疊:React、Vue、Next.js 或預設為 html-tailwind

步驟 2:產生設計系統 (必要)

永遠從 --design-system 開始,以獲得包含推理的全面建議:

python3 skills/ui-ux-pro-max/scripts/search.py "<產品類型> <產業> <關鍵字>" --design-system [-p "專案名稱"]

此指令會:

  1. 平行搜尋 5 個領域(產品、風格、色彩、登陸頁面、排版)
  2. 應用 ui-reasoning.csv 中的推理規則來選擇最佳配對
  3. 回傳完整的設計系統:模式、風格、色彩、排版、效果
  4. 包含應避免的反模式

範例:

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

步驟 2b:持久化設計系統 (主檔案 + 覆寫模式)

若要將設計系統儲存為跨會話的層級式檢索,請加入 --persist:

python3 skills/ui-ux-pro-max/scripts/search.py "<查詢>" --design-system --persist -p "專案名稱"

這會建立:

  • design-system/MASTER.md — 包含所有設計規則的全球單一事實來源
  • design-system/pages/ — 存放頁面特定覆寫規則的資料夾

搭配頁面特定覆寫:

python3 skills/ui-ux-pro-max/scripts/search.py "<查詢>" --design-system --persist -p "專案名稱" --page "dashboard"

這也會建立:

  • design-system/pages/dashboard.md — 該頁面偏離主檔案的規則

層級式檢索的運作方式:

  1. 在建構特定頁面(例如「結帳頁面」)時,先檢查 design-system/pages/checkout.md
  2. 如果頁面檔案存在,其規則會覆寫主檔案
  3. 如果不存在,則僅使用 design-system/MASTER.md

情境感知檢索提示:

我正在建構 [頁面名稱] 頁面。請先閱讀 design-system/MASTER.md。
同時檢查 design-system/pages/[page-name].md 是否存在。
如果頁面檔案存在,請優先採用其規則。
如果不存在,則僅使用主檔案的規則。
現在,請產生程式碼...

步驟 3:補充詳細搜尋 (視需要)

取得設計系統後,使用領域搜尋來取得額外細節:

python3 skills/ui-ux-pro-max/scripts/search.py "<關鍵字>" --domain <領域> [-n <最大結果數>]

何時使用詳細搜尋:

需求領域範例
更多樣式選項style--domain style "glassmorphism dark"
圖表建議chart--domain chart "real-time dashboard"
UX 最佳實踐ux--domain ux "animation accessibility"
替代字型typography--domain typography "elegant luxury"
登陸頁面結構landing--domain landing "hero social-proof"

步驟 4:技術堆疊指南 (預設:html-tailwind)

取得特定實作的最佳實踐。如果使用者未指定技術堆疊,請預設為 html-tailwind。

python3 skills/ui-ux-pro-max/scripts/search.py "<關鍵字>" --stack html-tailwind

可用技術堆疊:html-tailwind、react、nextjs、vue、svelte、swiftui、react-native、flutter、shadcn、jetpack-compose


搜尋參考

可用領域

領域用途範例關鍵字
product產品類型建議SaaS, 電商, 作品集, 醫療保健, 美容, 服務
styleUI 樣式、色彩、效果glassmorphism, minimalism, 深色模式, brutalism
typography字體配對、Google Fonts優雅, 活潑, 專業, 現代
color依產品類型的色調色盤saas, ecommerce, healthcare, beauty, fintech, service
landing頁面結構、CTA 策略hero, hero-centric, testimonial, pricing, social-proof
chart圖表類型、函式庫建議trend, comparison, timeline, funnel, pie
ux最佳實踐、反模式animation, accessibility, z-index, loading
reactReact/Next.js 效能waterfall, bundle, suspense, memo, rerender, cache
webWeb 介面指南aria, focus, keyboard, semantic, virtualize
promptAI 提示、CSS 關鍵字(樣式名稱)

可用技術堆疊

技術堆疊重點
html-tailwindTailwind 工具、響應式、無障礙 (預設)
react狀態、Hooks、效能、模式
nextjsSSR、路由、圖片、API 路由
vueComposition API、Pinia、Vue Router
svelteRunes、Stores、SvelteKit
swiftui檢視、狀態、導航、動畫
react-native元件、導航、列表
flutterWidget、狀態、佈局、主題化
shadcnshadcn/ui 元件、主題化、表單、模式
jetpack-composeComposable、Modifier、狀態提升、重組

範例工作流程

使用者請求: 「幫我為專業護膚服務做一個登陸頁面」

步驟 1:分析需求

  • 產品類型:美容/SPA 服務
  • 風格關鍵字:優雅、專業、柔和
  • 產業:美容/健康
  • 技術堆疊:html-tailwind (預設)

步驟 2:產生設計系統 (必要)

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

輸出: 包含模式、風格、色彩、排版、效果和反模式的完整設計系統。

步驟 3:補充詳細搜尋 (視需要)

# 獲取動畫與無障礙的 UX 指南
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux

# 如有需要,獲取替代排版選項
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography

步驟 4:技術堆疊指南

python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind

接著: 綜合設計系統和詳細搜尋結果,並實作設計。


輸出格式

--design-system 標記支援兩種輸出格式:

# ASCII 框 (預設) - 最適合終端機顯示
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - 最適合文件
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

獲得更好結果的秘訣

  1. 關鍵字要具體 - 「醫療保健 SaaS 儀表板」優於「應用程式」
  2. 多次搜尋 - 不同的關鍵字會揭示不同的見解
  3. 組合領域 - 風格 + 排版 + 色彩 = 完整的設計系統
  4. 總是檢查 UX - 搜尋 "animation"、"z-index"、"accessibility" 以找出常見問題
  5. 使用技術堆疊標記 - 取得特定實作的最佳實踐
  6. 迭代 - 如果第一次搜尋不符合,嘗試不同的關鍵字

專業 UI 的常見規則

以下是經常被忽略但會讓 UI 顯得不專業的問題:

圖示與視覺元素

規則應做不應做
不使用表情符號作為圖示使用 SVG 圖示 (Heroicons、Lucide、Simple Icons)使用 🎨 🚀 ⚙️ 等表情符號作為 UI 圖示
穩定的懸停狀態懸停時使用顏色/透明度轉場使用會改變佈局的縮放變形
正確的品牌標誌從 Simple Icons 研究官方 SVG猜測或使用錯誤的標誌路徑
一致的圖示大小使用固定 viewBox (24x24) 搭配 w-6 h-6隨機混合不同大小的圖示

互動與游標

規則應做不應做
指針游標為所有可點擊/可懸停的卡片加上 cursor-pointer在可互動元素上保留預設游標
懸停回饋提供視覺回饋 (顏色、陰影、邊框)沒有指示元素是可互動的
平滑轉場使用 transition-colors duration-200瞬間的狀態變化或速度過慢 (>500ms)

淺色/深色模式對比

規則應做不應做
玻璃卡片淺色模式使用 bg-white/80 或更高透明度使用 bg-white/10 (過於透明)
文字對比淺色文字使用 #0F172A (slate-900)主體文字使用 #94A3B8 (slate-400)
淺色模式次要文字最低使用 #475569 (slate-600)使用 gray-400 或更淺的顏色
邊框可見性淺色模式使用 border-gray-200使用 border-white/10 (不可見)

佈局與間距

規則應做不應做
浮動導航欄加上 top-4 left-4 right-4 間距將導航欄固定在 top-0 left-0 right-0
內容內邊距考慮固定導航欄的高度讓內容隱藏在固定元素後面
一致的最大寬度使用相同的 max-w-6xl 或 max-w-7xl混用不同的容器寬度

交付前檢查清單

在交付 UI 程式碼前,請驗證以下項目:

視覺品質

  • 未將表情符號用作圖示 (改用 SVG)
  • 所有圖示來自一致的圖示集 (Heroicons/Lucide)
  • 品牌標誌正確 (已從 Simple Icons 驗證)
  • 懸停狀態不會導致佈局位移
  • 直接使用主題顏色 (bg-primary) 而非 var() 包裝

互動

  • 所有可點擊元素都有 cursor-pointer
  • 懸停狀態提供明確的視覺回饋
  • 轉場動畫流暢 (150-300ms)
  • 焦點狀態對鍵盤導航可見

淺色/深色模式

  • 淺色模式文字有足夠的對比度 (最低 4.5:1)
  • 淺色模式下玻璃/透明元素可見
  • 兩種模式下邊框都可見
  • 交付前測試兩種模式

佈局

  • 浮動元素距離邊緣有適當間距
  • 沒有內容隱藏在固定導航欄後方
  • 在 375px、768px、1024px、1440px 下響應式
  • 行動裝置上無水平滾動

無障礙

  • 所有圖片都有替代文字
  • 表單輸入都有標籤
  • 顏色不是唯一的指示方式
  • 尊重 prefers-reduced-motion

相關技能