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 | 无障碍设计 | 关键 | |
| 2 | 触摸与交互 | 关键 | |
| 3 | 性能优化 | 高 | |
| 4 | 布局与响应式设计 | 高 | |
| 5 | 排版与配色 | 中 | |
| 6 | 动画设计 | 中 | |
| 7 | 风格选择 | 中 | |
| 8 | 图表与数据展示 | 低 | |
快速参考
1. 无障碍设计(关键)
- - 普通文本的对比度最低需达到4.5:1
color-contrast - - 交互元素需有可见的焦点环
focus-states - - 有意义的图片需添加描述性替代文本
alt-text - - 纯图标按钮需添加aria-label
aria-labels - - 标签顺序需与视觉顺序一致
keyboard-nav - - 表单输入框需搭配带for属性的label标签
form-labels
2. 触摸与交互(关键)
- - 触摸目标的最小尺寸为44x44px
touch-target-size - - 主要交互操作使用点击/触摸
hover-vs-tap - - 异步操作期间禁用按钮
loading-buttons - - 在问题附近显示清晰的错误提示
error-feedback - - 为可点击元素添加cursor-pointer样式
cursor-pointer
3. 性能优化(高)
- - 使用WebP格式、srcset属性与懒加载
image-optimization - - 检测prefers-reduced-motion设置
reduced-motion - - 为异步加载内容预留空间
content-jumping
4. 布局与响应式设计(高)
- - 设置width=device-width initial-scale=1
viewport-meta - - 移动端正文文本最小为16px
readable-font-size - - 确保内容适配视口宽度,无横向滚动
horizontal-scroll - - 定义z-index层级(10, 20, 30, 50)
z-index-management
5. 排版与配色(中)
- - 正文文本行高设置为1.5-1.75
line-height - - 每行文本限制在65-75个字符
line-length - - 标题与正文字体风格需匹配
font-pairing
6. 动画设计(中)
- - 微交互动画时长设置为150-300ms
duration-timing - - 使用transform/opacity属性,而非width/height
transform-performance - - 使用骨架屏或加载动画
loading-states
7. 风格选择(中)
- - 设计风格需与产品类型匹配
style-match - - 所有页面保持统一风格
consistency - - 使用SVG图标,而非emoji
no-emoji-icons
8. 图表与数据展示(低)
- - 图表类型需与数据类型匹配
chart-type - - 使用符合无障碍要求的配色方案
color-guidance - - 为图表提供表格形式的替代方案以满足无障碍要求
data-table
使用方法
使用下方的CLI工具搜索特定领域的内容。
前置要求
检查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.12本工具使用流程
当用户提出UI/UX相关需求(设计、构建、创建、实现、评审、修复、改进)时,请遵循以下流程:
步骤1:分析用户需求
从用户请求中提取关键信息:
- 产品类型:SaaS、电商平台、作品集、仪表盘、着陆页等
- 风格关键词:极简、活泼、专业、优雅、深色模式等
- 行业领域:医疗、金融科技、游戏、教育等
- 技术栈:React、Vue、Next.js,默认使用
html-tailwind
步骤2:生成设计系统(必填)
始终以命令开头,获取包含推理依据的全面推荐:
--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"步骤2b:保存设计系统(主文件+覆盖文件模式)
如需保存设计系统以支持跨会话层级检索,添加参数:
--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是否存在。
若页面文件存在,优先使用其规则。
若不存在,则仅使用主文件规则。
现在,请生成代码...步骤3:补充详细搜索(按需使用)
获取设计系统后,可使用领域搜索获取更多细节:
bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]详细搜索的适用场景:
| 需求 | 领域 | 示例 |
|---|---|---|
| 更多风格选项 | | |
| 图表推荐 | | |
| UX最佳实践 | | |
| 替代字体选项 | | |
| 着陆页结构 | | |
步骤4:技术栈专属指南(默认:html-tailwind)
获取针对特定技术栈的最佳实践。若用户未指定技术栈,默认使用。
html-tailwindbash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind支持的技术栈:, , , , , , , , ,
html-tailwindreactnextjsvuesvelteswiftuireact-nativefluttershadcnjetpack-compose搜索参考
支持的领域
| 领域 | 用途 | 示例关键词 |
|---|---|---|
| 产品类型推荐 | 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) |
支持的技术栈
| 技术栈 | 重点 |
|---|---|
| Tailwind工具类、响应式设计、无障碍设计(默认) |
| 状态管理、Hooks、性能优化、设计模式 |
| SSR、路由、图片处理、API路由 |
| 组合式API、Pinia、Vue Router |
| Runes、状态存储、SvelteKit |
| 视图、状态、导航、动画 |
| 组件、导航、列表 |
| 组件、状态、布局、主题 |
| shadcn/ui组件、主题、表单、设计模式 |
| 可组合函数、修饰符、状态提升、重组 |
示例流程
用户请求: "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-systembash
# 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提升搜索效果的技巧
- 关键词需具体 - "医疗SaaS仪表盘" 优于 "应用"
- 多次搜索 - 不同关键词可挖掘不同信息
- 组合领域搜索 - 风格+排版+配色=完整设计系统
- 务必检查UX - 搜索"animation"、"z-index"、"accessibility"排查常见问题
- 使用技术栈参数 - 获取针对特定技术栈的最佳实践
- 迭代优化 - 若首次搜索结果不符,尝试更换关键词
专业UI设计通用规则
以下是常被忽略但会影响UI专业性的问题:
图标与视觉元素
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 禁止使用emoji图标 | 使用SVG图标(Heroicons、Lucide、Simple Icons) | 使用🎨 🚀 ⚙️等emoji作为UI图标 |
| 稳定的悬停状态 | 使用颜色/透明度过渡效果 | 使用会导致布局偏移的缩放变换 |
| 正确的品牌Logo | 从Simple Icons获取官方SVG | 猜测或使用错误的Logo路径 |
| 统一的图标尺寸 | 使用固定viewBox(24x24)搭配w-6 h-6样式 | 随机混合不同尺寸的图标 |
交互与光标
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 添加光标指针 | 为所有可点击/悬停的卡片添加 | 交互元素保留默认光标 |
| 悬停反馈 | 提供视觉反馈(颜色、阴影、边框) | 无任何交互提示 |
| 平滑过渡 | 使用 | 状态瞬间变化或过渡过慢(>500ms) |
明暗模式对比度
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 浅色模式玻璃卡片 | 使用 | 使用 |
| 浅色模式文本对比度 | 使用 | 使用 |
| 浅色模式弱化文本 | 最低使用 | 使用gray-400或更浅的颜色 |
| 边框可见性 | 浅色模式使用 | 使用 |
布局与间距
| 规则 | 正确做法 | 错误做法 |
|---|---|---|
| 悬浮导航栏 | 添加 | 将导航栏固定在 |
| 内容内边距 | 预留固定导航栏的高度空间 | 内容被固定导航栏遮挡 |
| 统一的最大宽度 | 使用统一的 | 混合使用不同的容器宽度 |
交付前检查清单
交付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