Communitygithub.com

vurakit/agentup

UI/UX 設計智慧。50 種風格、21 種色板、50 種字體配對、20 種圖表、9 種技術堆疊(React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind、shadcn/ui)。操作:規劃、建置、建立、設計、實作、審查、修復、改善、最佳化、增強、重構、檢查 UI/UX 程式碼。專案:網站、登陸頁面、儀表板、管理後台、電子商務、SaaS、作品集、部落格、手機應用程式、.html、.tsx、.vue、.svelte。元素:按鈕、模態框、導覽列、側邊欄、卡片、表格、表單、圖表。風格:玻璃擬態、黏土擬態、極簡主義、粗獷主義、新擬態、菩提格網格、深色模式、響應式設計、擬物化、扁平設計。主題:色板、無障礙性、動畫、佈局、排版、字體配對、間距、懸停效果、陰影、漸層。整合:shadcn/ui MCP 用於元件搜尋與範例。

agentup 是什麼?

此技能作為一個全面的 UI/UX 設計智慧引擎,為開發者與 AI 代理提供超過 50 種設計風格、97 種色板、57 種字體配對以及 99 個 UX 指南的資料庫。它支援多種廣泛使用的技術堆疊,包括 React、Next.js、Vue、Svelte、SwiftUI、React Native 與 Flutter,並能產生完整的設計系統輸出。使用者透過 CLI 工具下達命令,系統會根據產品類型、產業關鍵字與技術堆疊,以優先級驅動的方式提供最佳化建議,涵蓋從無障礙性與互動規則(高優先級)到動畫、圖表與風格選擇(低優先級)的所有層面。此技能能產生完整的設計系統(包含模式、風格、顏色、排版與效果),並可選擇將設計系統持久化儲存為主檔案與頁面覆蓋檔,實現跨工作階段的分層檢索。最終,它協助開發者產出專業、具備無障礙性且視覺統一的 UI 程式碼,包含交付前檢查清單,並可與 shadcn/ui MCP 整合以進行元件搜尋。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vurakit/agentup/tree/HEAD/skills/frontend

在你喜歡的 AI 中提問

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

說明文件

UI/UX Pro Max - 設計智慧

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

何時套用

請在下列情況參考這些指南:

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

按優先級分類的規則

優先級類別影響領域
1無障礙性關鍵ux
2觸控與互動關鍵ux
3效能高ux
4佈局與響應式設計高ux
5排版與顏色中排版, 顏色
6動畫中ux
7風格選擇中風格, 產品
8圖表與資料低圖表

快速參考

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 圖示,而非 emoji

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/agentup-frontend/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

此指令會:

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

範例:

python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

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

若要將設計系統儲存為跨工作階段的分層檢索,請加入 --persist:

python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name"

這會建立:

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

搭配頁面特定覆蓋:

python3 skills/agentup-frontend/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/agentup-frontend/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/agentup-frontend/scripts/search.py "<keyword>" --stack html-tailwind

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


搜尋參考

可用領域

領域用途範例關鍵字
product產品類型建議SaaS、電子商務、作品集、醫療保健、美容、服務
styleUI 風格、顏色、效果玻璃擬態、極簡主義、深色模式、粗獷主義
typography字體配對、Google Fonts優雅、活潑、專業、現代
color依產品類型的色板SaaS、電子商務、醫療保健、美容、金融科技、服務
landing頁面結構、CTA 策略英雄區、英雄為中心、見證、定價、社交證明
chart圖表類型、函式庫建議趨勢、比較、時間軸、漏斗、圓餅圖
ux最佳實務、反模式動畫、無障礙性、z-index、載入
reactReact/Next.js 效能瀑布流、打包、Suspense、memo、重新渲染、快取
web網頁介面指南aria、焦點、鍵盤、語意、虛擬化
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/agentup-frontend/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

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

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

# 取得動畫與無障礙性的 UX 指南
python3 skills/agentup-frontend/scripts/search.py "animation accessibility" --domain ux

# 若需要,取得替代排版選項
python3 skills/agentup-frontend/scripts/search.py "elegant luxury serif" --domain typography

步驟 4:技術堆疊指南

python3 skills/agentup-frontend/scripts/search.py "layout responsive form" --stack html-tailwind

然後: 綜合設計系統 + 詳細搜尋結果,並實作設計。


輸出格式

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

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

# Markdown-最適合文件
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system -f markdown

獲得更好結果的提示

  1. 關鍵字要具體 - 「醫療保健 SaaS 儀表板」優於「應用程式」
  2. 多次搜尋 - 不同關鍵字能揭示不同見解
  3. 結合多個領域 - 風格 + 排版 + 顏色 = 完整的設計系統
  4. 務必檢查 UX - 搜尋「動畫」、「z-index」、「無障礙性」以取得常見問題
  5. 使用堆疊標記 - 取得實作特定的最佳實務
  6. 迭代 - 若第一次搜尋不符合,請嘗試不同關鍵字

專業 UI 的常見規則

這些是經常被忽略、會使 UI 看起來不專業的問題:

圖示與視覺元素

規則應做不應做
不要使用 emoji 圖示使用 SVG 圖示(Heroicons、Lucide、Simple Icons)使用 emoji 如 🎨 🚀 ⚙️ 作為 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-width使用相同的 max-w-6xl 或 max-w-7xl混合使用不同容器寬度

交付前檢查清單

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

視覺品質

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

互動

  • 所有可點擊元素都有 cursor-pointer
  • 懸停狀態提供清晰的視覺回饋
  • 過渡效果平滑(150-300ms)
  • 焦點狀態在鍵盤導航時可見

淺色/深色模式

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

佈局

  • 浮動元素與邊緣有適當間距
  • 內容未隱藏在固定導覽列後方
  • 在 375px、768px、1024px、1440px 都能響應
  • 行動裝置上無水平捲動

無障礙性

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

相關技能