ui-ux-pro-max

原文🇺🇸 英文
已翻译
包含 3 个脚本检查通过 / 未检测到疑似敏感代码

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。设计元素:按钮、模态框、导航栏、侧边栏、卡片、表格、表单、图表。设计风格:glassmorphism、claymorphism、极简主义、粗野主义、neumorphism、bento grid、深色模式、响应式设计、拟物化设计、扁平化设计。相关主题:配色方案、无障碍设计、动画、布局、排版、字体搭配、间距、悬停效果、阴影、渐变。集成功能:shadcn/ui MCP 组件搜索与示例。

10.9k次下载
查看 GitHub 仓库
添加于

SKILL.md 内容

查看翻译对照 →

UI/UX Pro Max - 设计智能工具

面向网页与移动应用的综合性设计指南。涵盖9种技术栈,包含50+种设计风格、97套配色方案、57组字体搭配、99条UX设计准则以及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
    - 标签顺序需与视觉顺序一致
  • 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是否已安装:
bash
python3 --version || python --version
若未安装Python,请根据操作系统进行安装:
macOS:
bash
brew install python3
Ubuntu/Debian:
bash
sudo apt update && sudo apt install python3
Windows:
powershell
winget install Python.Python.3.12

本工具使用流程

当用户提出UI/UX相关需求(设计、构建、创建、实现、评审、修复、改进)时,请遵循以下流程:

步骤1:分析用户需求

从用户请求中提取关键信息:
  • 产品类型:SaaS、电商平台、作品集、仪表盘、着陆页等
  • 风格关键词:极简、活泼、专业、优雅、深色模式等
  • 行业领域:医疗、金融科技、游戏、教育等
  • 技术栈:React、Vue、Next.js,默认使用
    html-tailwind

步骤2:生成设计系统(必填)

始终以
--design-system
命令开头
,获取包含推理依据的全面推荐:
bash
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. 包含需要避免的反模式
示例:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

步骤2b:保存设计系统(主文件+覆盖文件模式)

如需保存设计系统以支持跨会话层级检索,添加
--persist
参数:
bash
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
    — 与主文件不同的页面专属规则
层级检索工作原理:
  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:补充详细搜索(按需使用)

获取设计系统后,可使用领域搜索获取更多细节:
bash
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
bash
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
style
UI风格、配色、效果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
react
React/Next.js性能优化waterfall, bundle, suspense, memo, rerender, cache
web
网页界面指南aria, focus, keyboard, semantic, virtualize
prompt
AI提示词、CSS关键词(style name)

支持的技术栈

技术栈重点
html-tailwind
Tailwind工具类、响应式设计、无障碍设计(默认)
react
状态管理、Hooks、性能优化、设计模式
nextjs
SSR、路由、图片处理、API路由
vue
组合式API、Pinia、Vue Router
svelte
Runes、状态存储、SvelteKit
swiftui
视图、状态、导航、动画
react-native
组件、导航、列表
flutter
组件、状态、布局、主题
shadcn
shadcn/ui组件、主题、表单、设计模式
jetpack-compose
可组合函数、修饰符、状态提升、重组

示例流程

用户请求: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"(越南语:为专业护肤服务制作着陆页)

步骤1:分析需求

  • 产品类型:美容/SPA服务
  • 风格关键词:优雅、专业、柔和
  • 行业领域:美容/健康
  • 技术栈:html-tailwind(默认)

步骤2:生成设计系统(必填)

bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
输出: 包含模式、风格、配色、排版、效果及反模式的完整设计系统。

步骤3:补充详细搜索(按需)

bash
# 获取动画与无障碍设计的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:技术栈指南

bash
python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
后续操作: 整合设计系统与详细搜索结果,完成设计实现。

输出格式

--design-system
命令支持两种输出格式:
bash
# 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专业性的问题:

图标与视觉元素

规则正确做法错误做法
禁止使用emoji图标使用SVG图标(Heroicons、Lucide、Simple Icons)使用🎨 🚀 ⚙️等emoji作为UI图标
稳定的悬停状态使用颜色/透明度过渡效果使用会导致布局偏移的缩放变换
正确的品牌Logo从Simple Icons获取官方SVG猜测或使用错误的Logo路径
统一的图标尺寸使用固定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代码前,请验证以下项目:

视觉质量

  • 未使用emoji作为图标(改用SVG)
  • 所有图标来自统一的图标库(Heroicons/Lucide)
  • 品牌Logo正确(已通过Simple Icons验证)
  • 悬停状态不会导致布局偏移
  • 直接使用主题颜色(bg-primary)而非var()包装器

交互体验

  • 所有可点击元素均添加了
    cursor-pointer
  • 悬停状态提供清晰的视觉反馈
  • 过渡效果平滑(150-300ms)
  • 键盘导航的焦点状态可见

明暗模式

  • 浅色模式文本对比度达标(最低4.5:1)
  • 玻璃/透明元素在浅色模式下可见
  • 边框在两种模式下均可见
  • 交付前已测试两种模式

布局设计

  • 浮动元素与边缘有合适的间距
  • 无内容被固定导航栏遮挡
  • 在375px、768px、1024px、1440px分辨率下均为响应式
  • 移动端无横向滚动

无障碍设计

  • 所有图片均添加了替代文本
  • 表单输入框均搭配了label标签
  • 未仅使用颜色作为状态指示
  • 已遵循
    prefers-reduced-motion
    设置