Communitygithub.com

UI/UX Pro Max - 設計智慧系統

整合 50 種樣式、97 組調色盤、57 種字體搭配與 9 種技術堆疊的設計指南,協助開發者與設計師快速產出高品質 UI/UX。

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

這是一個專為網頁與行動應用程式打造的綜合性設計指南技能。它包含超過 50 種 UI 樣式(如玻璃擬態、極簡主義)、97 組色彩調色盤、57 種字體搭配、99 條 UX 最佳實踐以及 25 種圖表類型,並全面支援 React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind CSS 與 shadcn/ui 等 9 種技術堆疊。此技能的核心能力在於能透過 CLI 工具進行優先級導向的搜尋與建議:使用者只需輸入產品類型、產業與風格關鍵字,系統便會從多個領域(產品、樣式、色彩、排版、登陸頁)平行檢索,並根據內建的推理規則回傳完整的設計系統,包含模式、樣式、色彩、字體與效果,甚至提供反模式以避免常見設計錯誤。此外,它支援 `--persist` 參數來持久化設計系統為 MASTER.md 與頁面級覆蓋檔案,實現跨 session 的分層檢索。此工具對所有從事 UI/UX 開發的工程師與 AI 代理極具價值,能顯著加速從需求分析到最終程式碼產出的設計流程,並確保一致性與可存取性。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/ui-ux-pro-max

在你喜歡的 AI 中提問

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

說明文件

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

適用於網頁與行動應用程式的綜合設計指南。包含超過 50 種樣式、97 組調色盤、57 種字體搭配、99 條 UX 準則,以及橫跨 9 種技術堆疊的 25 種圖表類型。可搜尋的資料庫,並提供基於優先級的建議。

何時套用

在以下情況參考這些準則:

  • 設計新的 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 "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

此命令會:

  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:持久化設計系統 (主檔案 + 覆寫模式)

若要儲存設計系統以便跨 session 進行分層檢索,請加上 --persist:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"

這會建立:

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

搭配頁面特定覆寫:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"

這也會建立:

  • design-system/pages/dashboard.md — 與主檔案的頁面特定差異

分層檢索的運作方式:

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

上下文感知的檢索提示:

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

步驟 3:補充詳細搜尋 (依需求)

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

python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]

何時使用詳細搜尋:

需求領域範例
更多樣式選項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 "<keyword>" --stack html-tailwind

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


搜尋參考

可用領域

領域用途範例關鍵字
product產品類型建議SaaS、電子商務、作品集、醫療保健、美容、服務
styleUI 樣式、色彩、效果glassmorphism、極簡主義、深色模式、野獸派
typography字體搭配、Google Fonts優雅、活潑、專業、現代
color依產品類型的調色盤SaaS、電子商務、醫療保健、美容、金融科技、服務
landing頁面結構、CTA 策略hero、hero-centric、推薦、定價、社交證明
chart圖表類型、函式庫建議趨勢、比較、時間軸、漏斗、圓餅圖
ux最佳實踐、反模式動畫、無障礙、z-index、載入
reactReact/Next.js 效能waterfall、bundle、suspense、memo、rerender、cache
web網頁介面準則aria、focus、keyboard、semantic、virtualize
promptAI 提示、CSS 關鍵字(樣式名稱)

可用堆疊

堆疊重點
html-tailwindTailwind 工具類、響應式、無障礙 (預設)
react狀態、鉤子、效能、模式
nextjsSSR、路由、圖片、API 路由
vueComposition API、Pinia、Vue Router
svelteRunes、Stores、SvelteKit
swiftui視圖、狀態、導航、動畫
react-native元件、導航、列表
flutter小部件、狀態、版面、主題
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 - 搜尋「動畫」、「z-index」、「無障礙」以取得常見問題
  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

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相關技能