Communitygithub.com

vurakit/agentup

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。元素:按钮、模态框、导航栏、侧边栏、卡片、表格、表单、图表。风格:玻璃拟态、粘土拟态、极简主义、粗野主义、新拟态、Bento 网格、深色模式、响应式、拟物化、扁平设计。主题:调色板、可访问性、动画、布局、排版、字体搭配、间距、悬停、阴影、渐变。集成:shadcn/ui MCP 用于组件搜索和示例。

agentup 是什么?

这是一个专为 AI 智能体(如 Claude Code、Cursor、Codex)设计的 UI/UX 设计技能。它提供了一套全面的设计指南,涵盖 50 多种视觉风格、97 种配色方案、57 种字体搭配、99 条 UX 最佳实践和 25 种图表类型,支持 9 种主流技术栈(React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind CSS、shadcn/ui)。该技能通过优先级排序的规则库(从关键的可访问性和交互,到中等优先级的排版和动画,以及低优先级的图表)指导智能体做出设计决策。其核心工作流程是:首先分析用户需求(产品类型、风格、行业和技术栈),然后通过 `--design-system` 命令生成包含模式、风格、颜色、排版和效果的综合设计系统,并可选择通过 `--persist` 选项持久化设计系统以实现跨会话的层次化检索。之后,可以通过针对特定领域(如 `style`、`typography`、`ux`)的详细搜索进行补充,并使用技术栈标志(`--stack`)获取实现特定的最佳实践。该技能还包含一个交付前检查清单,涵盖视觉质量、交互、亮/暗模式、布局和可访问性,确保 UI 代码的专业性。主要平台支持包括 CLI 工具,通过 Python 脚本运行,提供 ASCII 和 Markdown 两种输出格式。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vurakit/agentup/tree/HEAD/skills/frontend

在你喜欢的 AI 中提问

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

文档

UI/UX Pro Max - 设计智能

适用于 Web 和移动应用的全面设计指南。包含 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/agentup-frontend/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

此命令:

  1. 并行搜索 5 个领域(产品、风格、颜色、落地页、排版)
  2. 应用来自 ui-reasoning.csv 的推理规则以选择最佳匹配
  3. 返回完整的设计系统:模式、风格、颜色、排版、效果
  4. 包含应避免的反模式

示例:

python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

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

要保存设计系统以实现跨会话的层次化检索,请添加 --persist:

python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name"

这将创建:

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

使用页面特定覆盖:

python3 skills/agentup-frontend/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:补充详细搜索(根据需要)

获取设计系统后,使用领域搜索获取更多详细信息:

python3 skills/agentup-frontend/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。

python3 skills/agentup-frontend/scripts/search.py "<keyword>" --stack html-tailwind

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


搜索参考

可用领域

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

可用技术栈

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

示例工作流程

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

步骤 1:分析需求

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

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

python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

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

步骤 3:补充详细搜索(根据需要)

# 获取动画和可访问性的 UX 指南
python3 skills/agentup-frontend/scripts/search.py "animation accessibility" --domain ux

# 如果需要,获取备选排版选项
python3 skills/agentup-frontend/scripts/search.py "elegant luxury serif" --domain typography

步骤 4:技术栈指南

python3 skills/agentup-frontend/scripts/search.py "layout responsive form" --stack html-tailwind

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


输出格式

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

# ASCII 框(默认)- 最适合终端显示
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system

# Markdown - 最适合文档
python3 skills/agentup-frontend/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 图标
稳定的悬停状态悬停时使用颜色/透明度过渡使用会导致布局偏移的缩放变换
正确的品牌标志从 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 下响应式
  • 移动端无水平滚动

可访问性

  • 所有图片都有替代文本
  • 表单输入有标签
  • 颜色不是唯一指示符
  • 尊重 prefers-reduced-motion

相关技能