Communitygithub.com

minicoohei/ai-agent-camp

UI/UX 設計指南。支援50種樣式、97種調色板、57種字體搭配、9種技術堆疊。透過「UI設計」「設計系統建立」「畫面審查」等請求觸發。

ai-agent-camp 是什麼?

此技能是一個全面的 UI/UX 設計智慧助手,專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計。它提供了一個包含 50 多種樣式、97 種調色板、57 種字體搭配、99 條 UX 準則和 25 種圖表類型的可搜尋資料庫,涵蓋 9 種常見的技術堆疊(如 React、Vue、Next.js、SwiftUI、Flutter 等)。主要用途是當使用者提出設計相關請求(如「UI 設計」、「UX 審查」或「建立登陸頁面」)時,透過 CLI 工具自動生成完整的設計系統,包括樣式、色彩、字體、效果以及反模式建議。它支援優先級驅動的推薦(從無障礙性、互動性等關鍵項目到圖表等低優先級項目),並能以 Master/Override 模式持久化設計系統,實現跨會話的一致設計。此技能特別強調無障礙性(如色彩對比 4.5:1、焦點狀態)和互動設計(如觸控目標 44x44px),並提供了詳細的搜尋參考與工作流程範例。

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

在你喜歡的 AI 中提問

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

說明文件

觸發關鍵字

「UI設計」「UX審查」「設計」「登陸頁面」「畫面設計」

對應關鍵字:

  • 動作:plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check
  • 專案類型:website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte
  • 元素:button, modal, navbar, sidebar, card, table, form, chart
  • 樣式:glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design
  • 主題:color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient
  • 整合:shadcn/ui MCP 用於元件搜尋與範例

UI/UX Pro Max - 設計智慧

Web 與行動應用程式的全面設計指南。包含 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 - 使用 label 及 for 屬性

2. 觸控與互動 (關鍵)

  • touch-target-size - 觸控目標最小 44x44 像素
  • 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-300 毫秒
  • 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 個領域(product、style、color、landing、typography)
  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:持久化設計系統 (Master + Overrides 模式)

若要將設計系統儲存以支援跨會話的階層式檢索,請加上 --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 — 頁面特定偏離 Master 的規則

階層式檢索的運作方式:

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

情境感知檢索提示:

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

步驟 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, e-commerce, portfolio, healthcare, beauty, service
styleUI 樣式、色彩、效果glassmorphism, minimalism, dark mode, brutalism
typography字體搭配、Google Fontselegant, playful, professional, modern
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 關鍵字(style name)

可用技術堆疊

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

範例工作流程

使用者請求:「建立專業護膚服務的登陸頁面」

步驟 1:分析需求

  • 產品類型:美容/水療服務
  • 樣式關鍵字:優雅、專業、柔和
  • 產業:美容/健康
  • 技術堆疊: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. 關鍵字要具體 - "healthcare SaaS dashboard" 優於 "app"
  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-300 毫秒)
  • 鍵盤導覽的焦點狀態可見

淺色/深色模式

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

版面

  • 浮動元素與邊緣有適當間距
  • 無內容隱藏在固定導覽列後方

Individual skills in this repo

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

相關技能