ui-ux-pro-max
对比查看原文与翻译
🇺🇸
原文
英文🇨🇳
翻译
中文UI/UX Pro Max - Design Intelligence
UI/UX Pro Max - 设计智能工具
Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
面向网页与移动应用的综合性设计指南。涵盖9种技术栈,包含50+种设计风格、97套配色方案、57组字体搭配、99条UX设计准则以及25种图表类型。具备可搜索的数据库与基于优先级的推荐功能。
When to Apply
适用场景
Reference these guidelines when:
- Designing new UI components or pages
- Choosing color palettes and typography
- Reviewing code for UX issues
- Building landing pages or dashboards
- Implementing accessibility requirements
在以下场景中可参考本指南:
- 设计新的UI组件或页面
- 选择配色方案与排版
- 评审代码中的UX问题
- 构建着陆页或仪表盘
- 实现无障碍设计要求
Rule Categories by Priority
按优先级划分的规则类别
| Priority | Category | Impact | Domain |
|---|---|---|---|
| 1 | Accessibility | CRITICAL | |
| 2 | Touch & Interaction | CRITICAL | |
| 3 | Performance | HIGH | |
| 4 | Layout & Responsive | HIGH | |
| 5 | Typography & Color | MEDIUM | |
| 6 | Animation | MEDIUM | |
| 7 | Style Selection | MEDIUM | |
| 8 | Charts & Data | LOW | |
| 优先级 | 类别 | 影响程度 | 领域 |
|---|---|---|---|
| 1 | 无障碍设计 | 关键 | |
| 2 | 触摸与交互 | 关键 | |
| 3 | 性能优化 | 高 | |
| 4 | 布局与响应式设计 | 高 | |
| 5 | 排版与配色 | 中 | |
| 6 | 动画设计 | 中 | |
| 7 | 风格选择 | 中 | |
| 8 | 图表与数据展示 | 低 | |
Quick Reference
快速参考
1. Accessibility (CRITICAL)
1. 无障碍设计(关键)
- - Minimum 4.5:1 ratio for normal text
color-contrast - - Visible focus rings on interactive elements
focus-states - - Descriptive alt text for meaningful images
alt-text - - aria-label for icon-only buttons
aria-labels - - Tab order matches visual order
keyboard-nav - - Use label with for attribute
form-labels
- - 普通文本的对比度最低需达到4.5:1
color-contrast - - 交互元素需有可见的焦点环
focus-states - - 有意义的图片需添加描述性替代文本
alt-text - - 纯图标按钮需添加aria-label
aria-labels - - 标签顺序需与视觉顺序一致
keyboard-nav - - 表单输入框需搭配带for属性的label标签
form-labels
2. Touch & Interaction (CRITICAL)
2. 触摸与交互(关键)
- - Minimum 44x44px touch targets
touch-target-size - - Use click/tap for primary interactions
hover-vs-tap - - Disable button during async operations
loading-buttons - - Clear error messages near problem
error-feedback - - Add cursor-pointer to clickable elements
cursor-pointer
- - 触摸目标的最小尺寸为44x44px
touch-target-size - - 主要交互操作使用点击/触摸
hover-vs-tap - - 异步操作期间禁用按钮
loading-buttons - - 在问题附近显示清晰的错误提示
error-feedback - - 为可点击元素添加cursor-pointer样式
cursor-pointer
3. Performance (HIGH)
3. 性能优化(高)
- - Use WebP, srcset, lazy loading
image-optimization - - Check prefers-reduced-motion
reduced-motion - - Reserve space for async content
content-jumping
- - 使用WebP格式、srcset属性与懒加载
image-optimization - - 检测prefers-reduced-motion设置
reduced-motion - - 为异步加载内容预留空间
content-jumping
4. Layout & Responsive (HIGH)
4. 布局与响应式设计(高)
- - width=device-width initial-scale=1
viewport-meta - - Minimum 16px body text on mobile
readable-font-size - - Ensure content fits viewport width
horizontal-scroll - - Define z-index scale (10, 20, 30, 50)
z-index-management
- - 设置width=device-width initial-scale=1
viewport-meta - - 移动端正文文本最小为16px
readable-font-size - - 确保内容适配视口宽度,无横向滚动
horizontal-scroll - - 定义z-index层级(10, 20, 30, 50)
z-index-management
5. Typography & Color (MEDIUM)
5. 排版与配色(中)
- - Use 1.5-1.75 for body text
line-height - - Limit to 65-75 characters per line
line-length - - Match heading/body font personalities
font-pairing
- - 正文文本行高设置为1.5-1.75
line-height - - 每行文本限制在65-75个字符
line-length - - 标题与正文字体风格需匹配
font-pairing
6. Animation (MEDIUM)
6. 动画设计(中)
- - Use 150-300ms for micro-interactions
duration-timing - - Use transform/opacity, not width/height
transform-performance - - Skeleton screens or spinners
loading-states
- - 微交互动画时长设置为150-300ms
duration-timing - - 使用transform/opacity属性,而非width/height
transform-performance - - 使用骨架屏或加载动画
loading-states
7. Style Selection (MEDIUM)
7. 风格选择(中)
- - Match style to product type
style-match - - Use same style across all pages
consistency - - Use SVG icons, not emojis
no-emoji-icons
- - 设计风格需与产品类型匹配
style-match - - 所有页面保持统一风格
consistency - - 使用SVG图标,而非emoji
no-emoji-icons
8. Charts & Data (LOW)
8. 图表与数据展示(低)
- - Match chart type to data type
chart-type - - Use accessible color palettes
color-guidance - - Provide table alternative for accessibility
data-table
- - 图表类型需与数据类型匹配
chart-type - - 使用符合无障碍要求的配色方案
color-guidance - - 为图表提供表格形式的替代方案以满足无障碍要求
data-table
How to Use
使用方法
Search specific domains using the CLI tool below.
使用下方的CLI工具搜索特定领域的内容。
Prerequisites
前置要求
Check if Python is installed:
bash
python3 --version || python --versionIf Python is not installed, install it based on user's OS:
macOS:
bash
brew install python3Ubuntu/Debian:
bash
sudo apt update && sudo apt install python3Windows:
powershell
winget install Python.Python.3.12检查Python是否已安装:
bash
python3 --version || python --version若未安装Python,请根据操作系统进行安装:
macOS:
bash
brew install python3Ubuntu/Debian:
bash
sudo apt update && sudo apt install python3Windows:
powershell
winget install Python.Python.3.12How to Use This Skill
本工具使用流程
When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
当用户提出UI/UX相关需求(设计、构建、创建、实现、评审、修复、改进)时,请遵循以下流程:
Step 1: Analyze User Requirements
步骤1:分析用户需求
Extract key information from user request:
- Product type: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
- Style keywords: minimal, playful, professional, elegant, dark mode, etc.
- Industry: healthcare, fintech, gaming, education, etc.
- Stack: React, Vue, Next.js, or default to
html-tailwind
从用户请求中提取关键信息:
- 产品类型:SaaS、电商平台、作品集、仪表盘、着陆页等
- 风格关键词:极简、活泼、专业、优雅、深色模式等
- 行业领域:医疗、金融科技、游戏、教育等
- 技术栈:React、Vue、Next.js,默认使用
html-tailwind
Step 2: Generate Design System (REQUIRED)
步骤2:生成设计系统(必填)
Always start with to get comprehensive recommendations with reasoning:
--design-systembash
python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]This command:
- Searches 5 domains in parallel (product, style, color, landing, typography)
- Applies reasoning rules from to select best matches
ui-reasoning.csv - Returns complete design system: pattern, style, colors, typography, effects
- Includes anti-patterns to avoid
Example:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"始终以命令开头,获取包含推理依据的全面推荐:
--design-systembash
python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]该命令将:
- 并行搜索5个领域(产品、风格、配色、着陆页、排版)
- 应用中的推理规则选择最佳匹配项
ui-reasoning.csv - 返回完整的设计系统:模式、风格、配色、排版、效果
- 包含需要避免的反模式
示例:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"Step 2b: Persist Design System (Master + Overrides Pattern)
步骤2b:保存设计系统(主文件+覆盖文件模式)
To save the design system for hierarchical retrieval across sessions, add :
--persistbash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"This creates:
- — Global Source of Truth with all design rules
design-system/MASTER.md - — Folder for page-specific overrides
design-system/pages/
With page-specific override:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"This also creates:
- — Page-specific deviations from Master
design-system/pages/dashboard.md
How hierarchical retrieval works:
- When building a specific page (e.g., "Checkout"), first check
design-system/pages/checkout.md - If the page file exists, its rules override the Master file
- If not, use exclusively
design-system/MASTER.md
Context-aware retrieval prompt:
I am building the [Page Name] page. Please read design-system/MASTER.md.
Also check if design-system/pages/[page-name].md exists.
If the page file exists, prioritize its rules.
If not, use the Master rules exclusively.
Now, generate the code...如需保存设计系统以支持跨会话层级检索,添加参数:
--persistbash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"此命令将创建:
- — 包含所有设计规则的全局基准文件
design-system/MASTER.md - — 存放页面专属覆盖规则的文件夹
design-system/pages/
添加页面专属覆盖规则:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"同时会创建:
- — 与主文件不同的页面专属规则
design-system/pages/dashboard.md
层级检索工作原理:
- 当构建特定页面(如"结账页")时,首先检查
design-system/pages/checkout.md - 若该页面文件存在,其规则将覆盖主文件中的对应规则
- 若不存在,则仅使用中的规则
design-system/MASTER.md
上下文感知检索提示词:
我正在构建[Page Name]页面。请阅读design-system/MASTER.md文件。
同时检查design-system/pages/[page-name].md是否存在。
若页面文件存在,优先使用其规则。
若不存在,则仅使用主文件规则。
现在,请生成代码...Step 3: Supplement with Detailed Searches (as needed)
步骤3:补充详细搜索(按需使用)
After getting the design system, use domain searches to get additional details:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]When to use detailed searches:
| Need | Domain | Example |
|---|---|---|
| More style options | | |
| Chart recommendations | | |
| UX best practices | | |
| Alternative fonts | | |
| Landing structure | | |
获取设计系统后,可使用领域搜索获取更多细节:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]详细搜索的适用场景:
| 需求 | 领域 | 示例 |
|---|---|---|
| 更多风格选项 | | |
| 图表推荐 | | |
| UX最佳实践 | | |
| 替代字体选项 | | |
| 着陆页结构 | | |
Step 4: Stack Guidelines (Default: html-tailwind)
步骤4:技术栈专属指南(默认:html-tailwind)
Get implementation-specific best practices. If user doesn't specify a stack, default to .
html-tailwindbash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwindAvailable stacks: , , , , , , , , ,
html-tailwindreactnextjsvuesvelteswiftuireact-nativefluttershadcnjetpack-compose获取针对特定技术栈的最佳实践。若用户未指定技术栈,默认使用。
html-tailwindbash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind支持的技术栈:, , , , , , , , ,
html-tailwindreactnextjsvuesvelteswiftuireact-nativefluttershadcnjetpack-composeSearch Reference
搜索参考
Available Domains
支持的领域
| Domain | Use For | Example Keywords |
|---|---|---|
| Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
| UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
| Font pairings, Google Fonts | elegant, playful, professional, modern |
| Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
| Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
| Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
| Best practices, anti-patterns | animation, accessibility, z-index, loading |
| React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
| Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
| AI prompts, CSS keywords | (style name) |
| 领域 | 用途 | 示例关键词 |
|---|---|---|
| 产品类型推荐 | SaaS, e-commerce, portfolio, healthcare, beauty, service |
| UI风格、配色、效果 | glassmorphism, minimalism, dark mode, brutalism |
| 字体搭配、Google Fonts | elegant, playful, professional, modern |
| 按产品类型推荐配色方案 | saas, ecommerce, healthcare, beauty, fintech, service |
| 页面结构、CTA策略 | hero, hero-centric, testimonial, pricing, social-proof |
| 图表类型、库推荐 | trend, comparison, timeline, funnel, pie |
| 最佳实践、反模式 | animation, accessibility, z-index, loading |
| React/Next.js性能优化 | waterfall, bundle, suspense, memo, rerender, cache |
| 网页界面指南 | aria, focus, keyboard, semantic, virtualize |
| AI提示词、CSS关键词 | (style name) |
Available Stacks
支持的技术栈
| Stack | Focus |
|---|---|
| Tailwind utilities, responsive, a11y (DEFAULT) |
| State, hooks, performance, patterns |
| SSR, routing, images, API routes |
| Composition API, Pinia, Vue Router |
| Runes, stores, SvelteKit |
| Views, State, Navigation, Animation |
| Components, Navigation, Lists |
| Widgets, State, Layout, Theming |
| shadcn/ui components, theming, forms, patterns |
| Composables, Modifiers, State Hoisting, Recomposition |
| 技术栈 | 重点 |
|---|---|
| Tailwind工具类、响应式设计、无障碍设计(默认) |
| 状态管理、Hooks、性能优化、设计模式 |
| SSR、路由、图片处理、API路由 |
| 组合式API、Pinia、Vue Router |
| Runes、状态存储、SvelteKit |
| 视图、状态、导航、动画 |
| 组件、导航、列表 |
| 组件、状态、布局、主题 |
| shadcn/ui组件、主题、表单、设计模式 |
| 可组合函数、修饰符、状态提升、重组 |
Example Workflow
示例流程
User request: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
用户请求: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"(越南语:为专业护肤服务制作着陆页)
Step 1: Analyze Requirements
步骤1:分析需求
- Product type: Beauty/Spa service
- Style keywords: elegant, professional, soft
- Industry: Beauty/Wellness
- Stack: html-tailwind (default)
- 产品类型:美容/SPA服务
- 风格关键词:优雅、专业、柔和
- 行业领域:美容/健康
- 技术栈:html-tailwind(默认)
Step 2: Generate Design System (REQUIRED)
步骤2:生成设计系统(必填)
bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"Output: Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"输出: 包含模式、风格、配色、排版、效果及反模式的完整设计系统。
Step 3: Supplement with Detailed Searches (as needed)
步骤3:补充详细搜索(按需)
bash
undefinedbash
undefinedGet UX guidelines for animation and accessibility
获取动画与无障碍设计的UX指南
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
Get alternative typography options if needed
如需其他排版选项
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
undefinedpython3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
undefinedStep 4: Stack Guidelines
步骤4:技术栈指南
bash
python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwindThen: Synthesize design system + detailed searches and implement the design.
bash
python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind后续操作: 整合设计系统与详细搜索结果,完成设计实现。
Output Formats
输出格式
The flag supports two output formats:
--design-systembash
undefined--design-systembash
undefinedASCII box (default) - best for terminal display
ASCII框格式(默认)- 适用于终端显示
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
Markdown - best for documentation
Markdown格式 - 适用于文档
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
---python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
---Tips for Better Results
提升搜索效果的技巧
- Be specific with keywords - "healthcare SaaS dashboard" > "app"
- Search multiple times - Different keywords reveal different insights
- Combine domains - Style + Typography + Color = Complete design system
- Always check UX - Search "animation", "z-index", "accessibility" for common issues
- Use stack flag - Get implementation-specific best practices
- Iterate - If first search doesn't match, try different keywords
- 关键词需具体 - "医疗SaaS仪表盘" 优于 "应用"
- 多次搜索 - 不同关键词可挖掘不同信息
- 组合领域搜索 - 风格+排版+配色=完整设计系统
- 务必检查UX - 搜索"animation"、"z-index"、"accessibility"排查常见问题
- 使用技术栈参数 - 获取针对特定技术栈的最佳实践
- 迭代优化 - 若首次搜索结果不符,尝试更换关键词
Common Rules for Professional UI
专业UI设计通用规则
These are frequently overlooked issues that make UI look unprofessional:
以下是常被忽略但会影响UI专业性的问题:
Icons & Visual Elements
图标与视觉元素
| Rule | Do | Don't |
|---|---|---|
| No emoji icons | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |
| Stable hover states | Use color/opacity transitions on hover | Use scale transforms that shift layout |
| Correct brand logos | Research official SVG from Simple Icons | Guess or use incorrect logo paths |
| Consistent icon sizing | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 禁止使用emoji图标 | 使用SVG图标(Heroicons、Lucide、Simple Icons) | 使用🎨 🚀 ⚙️等emoji作为UI图标 |
| 稳定的悬停状态 | 使用颜色/透明度过渡效果 | 使用会导致布局偏移的缩放变换 |
| 正确的品牌Logo | 从Simple Icons获取官方SVG | 猜测或使用错误的Logo路径 |
| 统一的图标尺寸 | 使用固定viewBox(24x24)搭配w-6 h-6样式 | 随机混合不同尺寸的图标 |
Interaction & Cursor
交互与光标
| Rule | Do | Don't |
|---|---|---|
| Cursor pointer | Add | Leave default cursor on interactive elements |
| Hover feedback | Provide visual feedback (color, shadow, border) | No indication element is interactive |
| Smooth transitions | Use | Instant state changes or too slow (>500ms) |
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 添加光标指针 | 为所有可点击/悬停的卡片添加 | 交互元素保留默认光标 |
| 悬停反馈 | 提供视觉反馈(颜色、阴影、边框) | 无任何交互提示 |
| 平滑过渡 | 使用 | 状态瞬间变化或过渡过慢(>500ms) |
Light/Dark Mode Contrast
明暗模式对比度
| Rule | Do | Don't |
|---|---|---|
| Glass card light mode | Use | Use |
| Text contrast light | Use | Use |
| Muted text light | Use | Use gray-400 or lighter |
| Border visibility | Use | Use |
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 浅色模式玻璃卡片 | 使用 | 使用 |
| 浅色模式文本对比度 | 使用 | 使用 |
| 浅色模式弱化文本 | 最低使用 | 使用gray-400或更浅的颜色 |
| 边框可见性 | 浅色模式使用 | 使用 |
Layout & Spacing
布局与间距
| Rule | Do | Don't |
|---|---|---|
| Floating navbar | Add | Stick navbar to |
| Content padding | Account for fixed navbar height | Let content hide behind fixed elements |
| Consistent max-width | Use same | Mix different container widths |
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 悬浮导航栏 | 添加 | 将导航栏固定在 |
| 内容内边距 | 预留固定导航栏的高度空间 | 内容被固定导航栏遮挡 |
| 统一的最大宽度 | 使用统一的 | 混合使用不同的容器宽度 |
Pre-Delivery Checklist
交付前检查清单
Before delivering UI code, verify these items:
交付UI代码前,请验证以下项目:
Visual Quality
视觉质量
- No emojis used as icons (use SVG instead)
- All icons from consistent icon set (Heroicons/Lucide)
- Brand logos are correct (verified from Simple Icons)
- Hover states don't cause layout shift
- Use theme colors directly (bg-primary) not var() wrapper
- 未使用emoji作为图标(改用SVG)
- 所有图标来自统一的图标库(Heroicons/Lucide)
- 品牌Logo正确(已通过Simple Icons验证)
- 悬停状态不会导致布局偏移
- 直接使用主题颜色(bg-primary)而非var()包装器
Interaction
交互体验
- All clickable elements have
cursor-pointer - Hover states provide clear visual feedback
- Transitions are smooth (150-300ms)
- Focus states visible for keyboard navigation
- 所有可点击元素均添加了
cursor-pointer - 悬停状态提供清晰的视觉反馈
- 过渡效果平滑(150-300ms)
- 键盘导航的焦点状态可见
Light/Dark Mode
明暗模式
- Light mode text has sufficient contrast (4.5:1 minimum)
- Glass/transparent elements visible in light mode
- Borders visible in both modes
- Test both modes before delivery
- 浅色模式文本对比度达标(最低4.5:1)
- 玻璃/透明元素在浅色模式下可见
- 边框在两种模式下均可见
- 交付前已测试两种模式
Layout
布局设计
- Floating elements have proper spacing from edges
- No content hidden behind fixed navbars
- Responsive at 375px, 768px, 1024px, 1440px
- No horizontal scroll on mobile
- 浮动元素与边缘有合适的间距
- 无内容被固定导航栏遮挡
- 在375px、768px、1024px、1440px分辨率下均为响应式
- 移动端无横向滚动
Accessibility
无障碍设计
- All images have alt text
- Form inputs have labels
- Color is not the only indicator
- respected
prefers-reduced-motion
- 所有图片均添加了替代文本
- 表单输入框均搭配了label标签
- 未仅使用颜色作为状态指示
- 已遵循设置
prefers-reduced-motion