ui-ux-promax

UI/UX Pro Max — 设计智能技能

来源：github.com/nextlevelbuilder/ui-ux-pro-max-skill | MIT License
版本：v2.0 | 67 UI 风格 · 161 配色方案 · 57 字体组合 · 161 推理规则 · 99 UX 准则

---

何时使用（When to Apply）

必须使用（Must Use）：

• 设计新页面（落地页、Dashboard、Admin、SaaS、移动 App）
• 创建或重构 UI 组件（按钮、弹窗、表单、表格、图表等）
• 选择配色方案、字体系统、间距规范或布局系统
• 审查 UI 代码的用户体验、无障碍性或视觉一致性
• 实现导航结构、动效或响应式行为
• 做产品级设计决策（风格、信息层级、品牌表达）
• 提升界面的感知质量、清晰度或可用性

推荐使用（Recommended）：

• UI 看起来"不够专业"但原因不明确
• 收到可用性或体验方面的反馈
• 发布前 UI 质量优化
• 跨平台设计对齐（Web / iOS / Android）
• 构建设计系统或可复用组件库

不需要使用（Skip）：

• 纯后端逻辑开发
• 仅涉及 API 或数据库设计
• 与界面无关的性能优化
• 基础设施或 DevOps 工作
• 非可视化脚本或自动化任务

---

设计系统推理引擎（v2.0 核心）

UI UX Pro Max v2.0 的核心是智能设计系统生成——基于产品关键词，5 路并行搜索后通过推理引擎输出完整设计方案。

工作流

1. 用户请求  →  "Build a landing page for my beauty spa"
2. 多域并行搜索（5路）
   • 产品类型匹配（161 类别）
   • 风格推荐（67 种风格）
   • 配色方案选择（161 套）
   • 落地页结构（24 种模式）
   • 字体组合（57 套）
3. 推理引擎
   • 产品→UI 类型规则映射
   • BM25 风格优先级排序
   • 过滤行业反模式
   • 处理 JSON 决策规则
4. 输出完整设计方案
   Pattern + Style + Colors + Typography + Effects
   + Anti-patterns to avoid + Pre-delivery checklist

设计系统输出示例（Beauty Spa）

TARGET: Serenity Spa — RECOMMENDED DESIGN SYSTEM
─────────────────────────────────────────────────
PATTERN: Hero-Centric + Social Proof
  Sections: Hero → Services → Testimonials → Booking → Contact

STYLE: Soft UI Evolution
  Keywords: Soft shadows, subtle depth, calming, premium feel, organic shapes
  Best For: Wellness, beauty, lifestyle, premium services
  Performance: Excellent | Accessibility: WCAG AA

COLORS:
  Primary:    #E8B4B8  (Soft Pink)
  Secondary:  #A8D5BA  (Sage Green)
  CTA:        #D4AF37  (Gold)
  Background: #FFF5F5  (Warm White)
  Text:       #2D3436  (Charcoal)

TYPOGRAPHY: Cormorant Garamond / Montserrat
  Mood: Elegant, calming, sophisticated

KEY EFFECTS: Soft shadows + Smooth transitions (200–300ms) + Gentle hover states

ANTI-PATTERNS TO AVOID:
  Bright neon colors · Harsh animations · Dark mode · AI purple/pink gradients

---

规则优先级矩阵

优先级	类别	影响	关键检查项	反模式
1	无障碍性	CRITICAL	对比度 4.5:1、Alt text、键盘导航、Aria 标签	移除 focus ring、仅图标按钮无标签
2	触控与交互	CRITICAL	最小 44×44px、8px+ 间距、加载反馈	仅 hover、0ms 状态切换
3	性能	HIGH	WebP/AVIF、懒加载、预留空间（CLS < 0.1）	布局抖动、累积布局偏移
4	风格选择	HIGH	匹配产品类型、一致性、SVG 图标（禁 emoji）	混搭扁平与写实、emoji 作图标
5	布局与响应式	HIGH	移动优先断点、viewport meta、禁横向滚动	固定 px 容器、禁用缩放
6	字体与配色	MEDIUM	基础 16px、行高 1.5、语义色彩 token	正文 <12px、灰色叠灰色、组件内裸 hex
7	动效	MEDIUM	150–300ms、transform/opacity only、运动表意	纯装饰性动画、animating width/height
8	表单与反馈	MEDIUM	可见标签、字段旁错误提示、提交反馈	仅 placeholder 作标签、顶部堆错误
9	导航模式	HIGH	可预测返回、底导 ≤5 项、深度链接	导航过载、返回路径中断
10	图表与数据	LOW	图例、Tooltip、无障碍配色	仅用颜色传达信息

---

快速参考（Quick Reference）

1. 无障碍性（CRITICAL）

• color-contrast — 正文最小 4.5:1（大字 3:1）
• focus-states — 交互元素可见焦点环（2–4px）
• alt-text — 有意义图片的描述性替代文字
• aria-labels — 仅图标按钮需要 aria-label
• keyboard-nav — Tab 顺序与视觉顺序一致
• form-labels — 使用带 for 属性的 label
• skip-links — 为键盘用户提供跳转到主内容的链接
• heading-hierarchy — 顺序 h1→h6，不跳级
• color-not-only — 不仅靠颜色传达信息（配合图标/文字）
• reduced-motion — 遵守 prefers-reduced-motion

2. 触控与交互（CRITICAL）

• touch-target-size — 最小 44×44pt（Apple）/ 48×48dp（Material）
• touch-spacing — 触控目标间最小 8px 间距
• hover-vs-tap — 主要交互用 click/tap，不仅依赖 hover
• loading-buttons — 异步操作期间禁用按钮并显示 spinner
• cursor-pointer — 可点击元素加 cursor-pointer（Web）
• press-feedback — 按下 150ms 内提供视觉反馈
• safe-area-awareness — 主要触控目标远离刘海、手势条

3. 性能（HIGH）

• image-optimization — WebP/AVIF + srcset + 懒加载
• image-dimension — 声明 width/height 或 aspect-ratio 防 CLS
• font-loading — font-display: swap 避免 FOIT
• bundle-splitting — 按路由/功能代码分割
• virtualize-lists — 50+ 项列表虚拟化
• main-thread-budget — 每帧 ~16ms 以内；重任务移出主线程

4. 风格选择（HIGH）

• style-match — 风格与产品类型匹配
• consistency — 所有页面使用同一风格
• no-emoji-icons — 使用 SVG 图标（Heroicons、Lucide），禁 emoji
• color-palette-from-product — 从产品/行业选择配色方案
• effects-match-style — 阴影、模糊、圆角对齐所选风格
• elevation-consistent — 卡片、弹窗、Modal 使用一致的层级/阴影

5. 布局与响应式（HIGH）

• viewport-meta — width=device-width initial-scale=1（不禁用缩放）
• mobile-first — 移动端优先设计
• breakpoint-consistency — 统一断点（375 / 768 / 1024 / 1440）
• readable-font-size — 移动端正文最小 16px
• horizontal-scroll — 禁止移动端横向滚动
• spacing-scale — 4pt/8dp 递进间距系统
• container-width — 桌面端统一 max-width（max-w-6xl / 7xl）
• z-index-management — 定义层级 z-index 规模（0/10/20/40/100/1000）

6. 字体与配色（MEDIUM）

• line-height — 正文行高 1.5–1.75
• line-length — 每行 65–75 字符
• font-pairing — 标题/正文字体气质匹配
• font-scale — 统一字号梯度（12 14 16 18 24 32）
• color-semantic — 定义语义色彩 token（primary / secondary / error / surface）
• color-dark-mode — 暗色模式使用降饱和/较亮色调变体，不做简单颜色反转
• color-accessible-pairs — 前景/背景满足 4.5:1（AA）或 7:1（AAA）

7. 动效（MEDIUM）

• duration-timing — 微交互 150–300ms；复杂过渡 ≤400ms
• transform-performance — 仅 transform/opacity，禁止动画 width/height/top/left
• loading-states — 加载超 300ms 显示骨架屏或进度指示
• easing — 进入用 ease-out，退出用 ease-in
• motion-meaning — 每个动画必须传达因果关系，非纯装饰
• exit-faster-than-enter — 退出动画约为进入时长的 60–70%
• spring-physics — 优先弹簧/物理曲线，自然感更强
• interruptible — 动画必须可中断；用户操作立即取消进行中的动画

8. 表单与反馈（MEDIUM）

• input-labels — 每个输入项有可见标签（非仅 placeholder）
• error-placement — 错误信息显示在相关字段下方
• submit-feedback — 提交后展示加载→成功/错误状态
• inline-validation — 失焦后验证（非按键时）；仅在用户完成输入后显示错误
• progressive-disclosure — 渐进式披露复杂选项
• toast-dismiss — Toast 3–5 秒后自动消失
• confirmation-dialogs — 破坏性操作前二次确认
• sheet-dismiss-confirm — 有未保存更改时确认后关闭
• undo-support — 破坏性或批量操作提供撤销

9. 导航模式（HIGH）

• bottom-nav-limit — 底部导航最多 5 项（图标+标签）
• back-behavior — 返回导航可预测且一致
• deep-linking — 所有核心页面可深度链接
• nav-state-active — 当前位置高亮显示
• adaptive-navigation — ≥1024px 偏好侧边栏；小屏用底/顶导航
• modal-escape — 弹窗/底部表单有明确的关闭/取消操作
• navigation-consistency — 所有页面导航位置保持一致

10. 图表与数据（LOW）

• chart-type — 图表类型与数据类型匹配（趋势→折线，对比→柱状，占比→饼/环）
• legend-visible — 始终显示图例，位置靠近图表
• tooltip-on-interact — hover（Web）或 tap（移动端）显示精确值
• responsive-chart — 小屏上图表自适应重排或简化
• empty-data-state — 无数据时显示有意义的空态
• no-pie-overuse — >5 个类别禁用饼/环图，改用柱状图

---

161 行业推理规则覆盖范围

领域	覆盖类型
科技 / SaaS	SaaS、Micro SaaS、B2B、开发工具、AI/Chatbot、网络安全
金融	Fintech/Crypto、银行、保险、个人财务、账单工具
医疗	诊所、药房、牙科、兽医、心理健康、用药提醒
电商	综合、奢侈品、P2P 市场、订阅盒、食品配送
服务	美容/SPA、餐厅、酒店、法律、家政、预约
创意	作品集、代理商、摄影、游戏、音乐流媒体
生活方式	习惯追踪、食谱、冥想、天气、日记、情绪追踪
新兴技术	Web3/NFT、空间计算、量子计算、无人机

每条规则包含：推荐模式 · 风格优先级 · 配色情绪 · 字体气质 · 关键效果 · 反模式（例如：银行类禁用"AI 紫粉渐变"）

---

支持的技术栈（15 种）

栈	关注点
React	状态、hooks、性能模式
Next.js	SSR、路由、API routes
Vue / Nuxt.js / Nuxt UI	Composition API、Pinia
Svelte / Astro	Runes、SvelteKit
Tailwind / HTML+CSS	默认栈，utilities、响应式
shadcn/ui	组件搜索与示例
Angular	组件、服务、RxJS
Laravel	Blade、Livewire、Inertia.js
SwiftUI	Views、State、Navigation
React Native	组件、导航、列表
Flutter	Widget、State、Theming
Jetpack Compose	Composable、Navigation

默认栈为 HTML + Tailwind CSS，在 prompt 中指定栈名即可切换。

---

使用工作流

新项目 / 新页面（Step 1 → Step 2 必选）

1. 分析需求：提取产品类型、目标用户、风格关键词、技术栈
2. 生成设计系统（REQUIRED）：输出完整 Pattern + Style + Colors + Typography + Anti-patterns
3. 补充领域搜索（按需）：深入某个维度（风格/配色/字体/UX/图表）
4. 获取栈指南（按需）：针对具体栈的最佳实践

场景→入口映射

场景	触发示例	起点
新项目 / 页面	"Build a landing page"	Step 1 → Step 2
新组件	"Create a pricing card"	Step 3（domain: style, ux）
选风格 / 配色 / 字体	"What style fits fintech?"	Step 2（设计系统）
审查现有 UI	"Review this page for UX"	Quick Reference 清单
修复 UI 问题	"Button hover is broken"	Quick Reference → 相关章节
优化改进	"Improve mobile experience"	Step 3（domain: ux, react）
深色模式	"Add dark mode support"	Step 3（domain: style "dark mode"）
图表/数据可视化	"Add analytics dashboard"	Step 3（domain: chart）
栈最佳实践	"React performance tips"	Step 4（stack search）

---

设计系统持久化（Master + Overrides 模式）

为跨会话保留设计决策，使用以下目录结构：

design-system/
├── MASTER.md           # 全局真相源（颜色、字体、间距、组件）
└── pages/
    ├── dashboard.md    # 页面级覆盖规则（仅与 Master 不同的部分）
    └── checkout.md

分层检索规则：

1. 构建特定页面时，先检查 design-system/pages/[page-name].md
2. 若页面文件存在，其规则覆盖 Master 文件
3. 若不存在，独立使用 design-system/MASTER.md

---

交付前检查清单（Pre-Delivery Checklist）

必检项（CRITICAL）

• 无障碍：正文对比度 ≥4.5:1（亮色和暗色模式分别测试）
• 触控目标：可点击元素 ≥44×44pt（iOS）/ ≥48×48dp（Android/Web）
• 无 emoji 图标（统一使用 SVG：Heroicons / Lucide）
• 所有可点击元素有 cursor-pointer
• hover/focus/active/disabled 状态可见且平滑（150–300ms）
• 焦点环可见，键盘导航可用
• prefers-reduced-motion 已考虑

布局与响应式

• 已在 375px / 768px / 1024px / 1440px 验证
• 移动端无横向滚动
• 安全区（刘海、底部手势条）已预留间距
• 滚动内容不被固定栏遮挡

设计一致性

• 全局使用语义 token（无散落 hex 值）
• 图标风格统一（描边宽度、角点半径一致）
• 阴影/层级系统统一
• 亮色和暗色模式均已测试

表单与交互

• 每个输入项有可见标签（非仅 placeholder）
• 错误信息靠近字段，说明原因和修复方法
• 长表单有自动保存或草稿保护
• 破坏性操作有二次确认

---

常见反模式（必须避免）

反模式	正确做法
emoji 作功能图标	SVG 图标（Heroicons、Lucide）
仅颜色传达状态	颜色 + 图标 + 文字三重编码
placeholder 代替 label	可见 label + placeholder 作提示
仅 hover 交互	click/tap 作主要交互
0ms 状态切换	150–300ms 过渡动画
动画 width/height	transform/opacity only
无限期不过期缓存图片	声明 width/height，防 CLS
组件内裸 hex 值	语义 token（CSS 变量/Tailwind token）
混搭图标风格	统一图标集，统一描边/填充风格
暗色模式 = 颜色反转	降饱和/较亮色调变体，独立测试对比度
仅 AI 紫粉渐变（金融/医疗）	遵循行业推理规则的配色

---

与仓库现有规则的映射

本 skill 是以下仓库规则的可执行主技能，完全兼容并增强：

仓库规则	本 skill 对应能力
frontend-ui-ux-standards.md	Quick Reference §1–§10 完整覆盖
frontend-quality-gates.md	Pre-Delivery Checklist 直接对应
frontend-engineering-standards.md	15 种栈的最佳实践指南
frontend-design-knowledge-base.md	本 skill 即设计知识库的可执行层

使用建议：

• tech-lead 在 /team-intake 或 /team-plan 阶段调用本 skill 锁定设计系统
• frontend-engineer 在实施前调用本 skill 生成设计系统，再按模式编码
• qa-engineer 在评审时使用本 skill 的 Pre-Delivery Checklist 作为评审依据