Communitygithub.com

UI/UX Pro Max - 设计智能

适用于网页和移动应用的综合性设计指南。包含50+风格、97种调色板、57种字体配对、99条UX指南和25种图表类型,覆盖9大技术栈。可搜索数据库,提供基于优先级的推荐。

UX Pro Max - 设计智能 是什么?

该技能(UI/UX Pro Max - 设计智能)是一个面向AI代码助手(如Claude Code、Cursor)的综合性UI/UX设计指南。它通过一个可搜索的数据库,为开发者提供从色彩、排版、到交互和可访问性等全方位的设计建议。技能支持50多种设计风格(如毛玻璃、新拟态)、97种调色板、57种字体配对和25种图表类型,并针对React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter和shadcn/ui等9大技术栈给出特定实现指导。核心工作流包括:通过CLI命令分析用户需求、生成包含推理规则的完整设计系统(`--design-system`)、持久化设计系统以实现层级化检索、以及根据需要进行领域(如UX、排版)深度搜索。它特别强调可访问性(色彩对比度、焦点状态)和触摸交互(最小44x44px触摸目标),并通过预交付清单确保UI代码的专业性。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/ui-ux-pro-max

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

UX Pro Max - 设计智能 是做什么的?

适用于网页和移动应用的综合性设计指南。包含50+风格、97种调色板、57种字体配对、99条UX指南和25种图表类型,覆盖9大技术栈。可搜索数据库,提供基于优先级的推荐。

何时应用

在以下情况参考这些指南:

  • 设计新的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 - 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/ui-ux-pro-max/scripts/search.py "<产品类型> <行业> <关键词>" --design-system [-p "项目名称"]

该命令:

  1. 并行搜索5个领域(product, style, color, landing, typography)
  2. 应用ui-reasoning.csv中的推理规则以选择最佳匹配
  3. 返回完整设计系统:图案、风格、颜色、排版、效果
  4. 包含应避免的反模式

示例:

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

步骤 2b: 持久化设计系统 (主文件 + 覆盖模式)

为了在会话间进行层级检索来保存设计系统,请添加--persist:

python3 skills/ui-ux-pro-max/scripts/search.py "<查询>" --design-system --persist -p "项目名称"

这会创建:

  • design-system/MASTER.md — 包含所有设计规则的全局事实源
  • design-system/pages/ — 页面特定覆盖规则的文件夹

使用页面特定覆盖:

python3 skills/ui-ux-pro-max/scripts/search.py "<查询>" --design-system --persist -p "项目名称" --page "dashboard"

这还会创建:

  • design-system/pages/dashboard.md — 与主文件不同的页面特定规则

层级检索如何工作:

  1. 构建特定页面时(例如“结账”),首先检查design-system/pages/checkout.md
  2. 如果页面文件存在,其规则覆盖主文件
  3. 如果不存在,则仅使用design-system/MASTER.md

上下文感知检索提示:

我正在构建[页面名称]页面。请阅读design-system/MASTER.md。
同时检查design-system/pages/[页面名称].md是否存在。
如果页面文件存在,优先使用其规则。
如果不存在,则仅使用主文件的规则。
现在,生成代码...

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

获取设计系统后,使用领域搜索以获取更多细节:

python3 skills/ui-ux-pro-max/scripts/search.py "<关键词>" --domain <领域> [-n <最大结果数>]

何时使用详细搜索:

需要领域示例
更多风格选项style--domain style "glassmorphism dark"
图表推荐chart--domain chart "实时仪表盘"
UX最佳实践ux--domain ux "animation accessibility"
替代字体typography--domain typography "优雅奢华"
着陆页结构landing--domain landing "hero social-proof"

步骤 4: 技术栈指南 (默认: html-tailwind)

获取特定于实现的推荐最佳实践。如果用户未指定技术栈,默认使用html-tailwind。

python3 skills/ui-ux-pro-max/scripts/search.py "<关键词>" --stack html-tailwind

可用技术栈: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose


搜索参考

可用领域

领域用途示例关键词
product产品类型推荐SaaS, 电商, 作品集, 医疗, 美容, 服务
styleUI风格, 颜色, 效果毛玻璃, 极简主义, 深色模式, 粗野主义
typography字体配对, Google Fonts优雅, 俏皮, 专业, 现代
color按产品类型的调色板saas, ecommerce, healthcare, beauty, fintech, service
landing页面结构, CTA策略首屏, 首屏中心型, 评价, 定价, 社会证明
chart图表类型, 库推荐趋势, 比较, 时间线, 漏斗, 饼图
ux最佳实践, 反模式动画, 可访问性, z-index, 加载
reactReact/Next.js性能瀑布流, 打包, suspense, memo, 重渲染, 缓存
webWeb界面指南aria, 焦点, 键盘, 语义化, 虚拟化
promptAI提示词, CSS关键词(风格名称)

可用技术栈

技术栈侧重点
html-tailwindTailwind工具类, 响应式, 可访问性 (默认)
react状态, 钩子, 性能, 模式
nextjsSSR, 路由, 图片, API路由
vueComposition API, Pinia, Vue Router
svelteRunes, 存储, SvelteKit
swiftui视图, 状态, 导航, 动画
react-native组件, 导航, 列表
flutter组件, 状态, 布局, 主题
shadcnshadcn/ui组件, 主题化, 表单, 模式
jetpack-compose组合项, 修饰符, 状态提升, 重组

示例工作流程

用户请求: "为专业护肤服务制作着陆页"

步骤 1: 分析需求

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

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

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

输出: 包含图案、风格、颜色、排版、效果和反模式的完整设计系统。

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

# 获取动画和可访问性的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: 技术栈指南

python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind

然后: 综合设计系统 + 详细搜索结果并实现设计。


输出格式

--design-system标志支持两种输出格式:

# 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 - 搜索"动画"、"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-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 下响应正常
  • 移动端无水平滚动

可访问性

  • 所有图片包含alt文本
  • 表单输入包含标签
  • 颜色不是唯一的指示符
  • 遵守 prefers-reduced-motion

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相关技能