UI UX Pro Max 驱动的现代前端 UI 工作流指南

执行后，CLI 会自动在你的项目中创建对应的配置文件和共享目录，例如（示意）：

• 对于 Cursor：
  • .cursor/commands/ui-ux-pro-max.md
  • .shared/ui-ux-pro-max/
• 对于 Windsurf：
  • .windsurf/workflows/ui-ux-pro-max.md
  • .shared/ui-ux-pro-max/

这些文件定义了命令入口、提示词模板以及设计知识库在本地的检索方式。

3.3 锁定与更新版本（团队协作建议）

在团队协作场景下，建议显式指定版本，确保所有人基于同一套设计规则：

• 指定版本初始化：

uipro init --ai all --version v1.2.0

• 查看可用版本：

uipro versions

• 更新到最新版本：

uipro update

这样可以避免「你生成的 UI 和我生成的 UI 风格不一致」的问题。

四、工作原理：一句话需求是怎么变成完整 UI 的？

为了更好地理解如何在实践中使用，先看一下 UI UX Pro Max 在背后做了什么。

4.1 设计决策流程拆解

当你在 AI 助手中使用 UI UX Pro Max 时，大致会经历以下流程：

1. 你发出需求
   • 例如："为一个 B2B SaaS 产品设计官网首页，要求简洁、现代、强调转化率，技术栈 React + Tailwind。"
2. 技能被触发
   • 在 Cursor / Windsurf 等中通常是调用 /ui-ux-pro-max 命令；在 Claude 中可以直接自然语言对话，由技能自动参与。
3. 设计知识检索
   • 在本地设计数据库中检索：
     • 哪种 UI 风格适合 B2B SaaS？（如 Minimalism + Clean）
     • 哪套配色更符合行业预期？（偏蓝灰、强调可信度与专业感）。
     • 标题与正文用哪种字体组合？（例如无衬线 + 高可读性字体）。
     • 需要注意哪些 UX 规则？（如清晰 CTA、对比度、信息层级）。
4. 生成设计系统 + 代码草稿
   • 输出包括：
     • 颜色变量命名与使用建议。
     • 字体与字号层级。
     • 布局结构（导航、Hero 区、Feature 区、社交证明、价格、页脚等）。
     • 基于指定技术栈的代码实现（如 React + Tailwind）。

你可以把它理解为：在写代码之前，AI 先帮你做了一轮系统化的「设计评审 + 方案制定」，再根据方案给出实现。

4.2 不同助手中的调用方式

常见工具中的调用方式大致如下：

• Claude Code：直接在对话中描述需求，不需要特别命令，只要技能配置已经启用。
• Cursor / Windsurf / Antigravity：在命令面板或编辑器中使用：/ui-ux-pro-max Build a landing page for my SaaS product using React and Tailwind
• GitHub Copilot、Kiro 等：使用对应的「命令」或「prompt preset」入口，通常名称中会包含 ui-ux-pro-max。

五、实战一：用 React + Tailwind 做一个 SaaS Landing Page

这一节将通过一个完整案例，演示如何从一句话需求出发，让 UI UX Pro Max 帮你生成一个可直接使用的 SaaS 落地页骨架。

5.1 准备一个 React + Tailwind 项目

先创建一个简单的 React 项目（以 Vite 为例）：

npm create vite@latest saas-landing -- --template react
cd saas-landing
npm install

安装 Tailwind CSS（简略步骤，具体可按官方文档）：

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p

在 tailwind.config.js 中启用基本配置，在 index.css 中引入 Tailwind 基础层。完成后，运行开发服务器确认环境正常：

npm run dev

5.2 在项目中初始化 UI UX Pro Max（Cursor 示例）

如果你使用的是 Cursor，确保前面已经执行过：

uipro init --ai cursor

此时项目根目录下应该已经存在：

• .cursor/commands/ui-ux-pro-max.md
• .shared/ui-ux-pro-max/

接下来，在 Cursor 中打开该项目，按下命令面板（如 Ctrl+Shift+P），找到或直接输入命令：

/ui-ux-pro-max

5.3 编写实际 prompt：给 AI 一份「设计需求文档」

在编辑器或聊天窗口中输入类似 prompt：

/ui-ux-pro-max 帮我设计一个 B2B SaaS 产品的官网首页，要求：

• 风格：Minimalism + Clean，现代感强
• 目标：引导用户注册试用（主 CTA）、展示产品核心功能和客户案例
• 受众：中大型企业的产品经理和技术负责人
• 技术栈：React + Tailwind

请先给出：推荐的 UI 风格说明与理由、颜色方案（含主色、辅色、背景色、强调色），并给出 Tailwind 写法示例、字体与排版层级建议、页面模块结构草图（Hero、Features、Testimonials、Pricing、FAQ、Footer 等）。最后输出一个完整的 React 组件示例（使用 Tailwind），包含上述模块。

UI UX Pro Max 会在内部选择合适的 UI 风格和 SaaS 行业配色，并结合 98 条 UX 指南来组织页面结构。

5.4 分析 AI 输出的设计方案

你可能会得到类似这样的结构性回答（这里用简化版说明思路）：

• 设计风格选择：选择 Minimalism + Clean 风格，配合浅色背景与高对比 CTA 按钮。
• 颜色方案：
  • 主色：偏蓝（传达专业与可信度）
  • 辅色：灰度用于文字与分割线
  • 强调色：用于按钮 hover 或关键指标。
• 排版层级：
  • H1：页面主标题（24–32px，字重粗）
  • H2：模块标题（20–24px，中等字重）
  • Body：14–16px，行高适中。
• 页面模块结构：
  • Hero：包含主标题、副文案、主 CTA、次 CTA、产品截图/插画。
  • Features：3–6 个核心功能卡片，每个包含图标、标题、简短描述。
  • Social Proof / Logos：客户 Logo 或推荐语。
  • Pricing：简化的价格卡片，突出推荐方案。
  • FAQ：常见问题折叠列表。
  • Footer：版权信息、链接等。

5.5 接入生成的 React + Tailwind 代码

在项目中创建 src/pages/LandingPage.jsx，将 AI 生成的组件粘贴进去，比如：

import React from "react";

export default function LandingPage() {
  return (
    <div className="min-h-screen bg-slate-50 text-slate-900">
      {/* Hero 区 */}
      <header className="mx-auto flex max-w-5xl flex-col items-center px-4 pt-16 pb-12 text-center">
        <p className="mb-4 text-sm font-semibold uppercase tracking-wide text-blue-600">
          B2B SaaS for Product Teams
        </p>
        <h1 className="mb-4 text-4xl font-bold tracking-tight sm:text-5xl">
          用一套面板，看懂整个产品生命周期
        </h1>
        <p className="mb-8 max-w-2xl text-base text-slate-600 sm:text-lg">
          将分散在各个系统里的指标集中到一个仪表盘，帮助你的团队更快发现问题、验证假设、推动决策落地。
        </p>
        <div className="flex flex-col gap-3 sm:flex-row">
          <button className="rounded-lg bg-blue-600 px-6 py-3 text-sm font-semibold text-white shadow-lg shadow-blue-600/30 transition hover:bg-blue-700">
            免费试用 14 天
          </button>
          <button className="rounded-lg border border-slate-300 px-6 py-3 text-sm font-semibold text-slate-800 transition hover:bg-white">
            预约产品演示
          </button>
        </div>
      </header>
      {/* Features 区 */}
      <section className="mx-auto max-w-5xl px-4 pb-16">
        <h2 className="mb-6 text-center text-2xl font-semibold tracking-tight">
          三大模块，覆盖关键场景
        </h2>
        <div className="grid gap-6 md:grid-cols-3">
          {/* Feature Card 示例 */}
          <div className="rounded-xl bg-white p-6 shadow-sm shadow-slate-200">
            <h3 className="mb-2 text-base font-semibold text-slate-900">
              实时指标总览
            </h3>
            <p className="text-sm text-slate-600">
              从激活、留存到转化，一屏掌握关键指标，支持自定义视图和告警阈值。
            </p>
          </div>
          {/* 其余卡片略 */}
        </div>
      </section>
      {/* 其他模块略：Testimonials、Pricing、FAQ、Footer */}
    </div>
  );
}

再在路由或入口文件中引入这个页面。这段代码只是示意，你可以在实际使用时让 UI UX Pro Max 输出更完整的版本（包括 Testimonials、Pricing、FAQ 等模块）。

5.6 在此基础上二次调整与迭代

真正的实践价值在于「循环迭代」：

• 让 AI 微调风格：增加一点 Glassmorphism 或暗色模式版本。
• 让 AI 调整信息层级：强化主 CTA 可见性、减少干扰元素。
• 让 AI 检查 UX 细节：是否需要滚动到折叠内容的引导？表单验证与错误提示是否清晰？

你可以多次向 UI UX Pro Max 提问，例如：

这版设计在移动端的可用性上有哪些问题？帮我给出改进建议，并直接修改对应 React + Tailwind 代码。

通过这样的方式，让 UI/UX 从一开始就是「可对话、可迭代」的。

六、实战二：医疗数据仪表盘（React + Charts）

第二个案例展示 UI UX Pro Max 在「图表密集型后台」场景中的作用。场景设定为：医疗数据分析平台的管理员仪表盘。

6.1 需求与约束描述

在 AI 助手中调用 UI UX Pro Max，给出如下一份需求说明：

帮我设计一个医疗数据分析后台的主仪表盘页面，场景：

• 用户：医院管理者 / 医疗运营人员
• 数据：患者量、床位占用率、手术排班、急诊等待时间等
• 目标：快速发现负载压力和异常情况
• 风格：偏冷色、强调安全感与稳定性
• 技术栈：React + Tailwind + 某个图表库（例如 Recharts 或 Chart.js）

请：推荐配色与字体方案，强调医疗行业特色；设计主仪表盘布局（顶部指标卡片 + 多个图表模块）；根据不同数据类型选择合适的图表类型；输出一个包含布局结构的 React 组件示例（图表处可使用占位容器）。

UI UX Pro Max 会参考其内置的行业配色和 24 种图表类型建议，选择适合医疗场景的色板与可视化方式。

6.2 布局与图表选择示例

典型设计决策可能包括：

• 顶部使用指标卡片（KPI Cards）：今日入院人数、床位占用率、平均等待时间等。
• 中间使用折线图 + 柱状图：
  • 折线图：展示过去 30 天的急诊流量趋势。
  • 柱状图：展示科室间资源占用对比。
• 下方使用表格和提醒列表：异常告警、即将超负荷的科室、待处理任务。

这些选择对应了 UI UX Pro Max 中对「趋势」「对比」「列表」等不同信息类型的可视化规则。

6.3 实现一个布局骨架（React + Tailwind）

示例组件（去掉具体图表实现，用占位 Div）：

import React from "react";

export default function MedicalDashboard() {
  return (
    <div className="min-h-screen bg-slate-950 text-slate-50">
      <div className="mx-auto max-w-6xl px-4 py-8">
        {/* 顶部标题与筛选 */}
        <header className="mb-6 flex flex-col justify-between gap-4 sm:flex-row sm:items-center">
          <div>
            <h1 className="text-2xl font-semibold tracking-tight">医疗运营仪表盘</h1>
            <p className="mt-1 text-sm text-slate-400">实时监控医院运行状态，及时发现负载与风险。</p>
          </div>
          <div className="flex gap-3">
            <button className="rounded-lg bg-emerald-500 px-4 py-2 text-xs font-semibold text-slate-950 hover:bg-emerald-400">
              今日概览
            </button>
            <button className="rounded-lg border border-slate-600 px-4 py-2 text-xs font-semibold text-slate-200 hover:bg-slate-900">
              导出报表
            </button>
          </div>
        </header>
        {/* 顶部 KPI 卡片 */}
        <section className="mb-6 grid gap-4 sm:grid-cols-2 lg:grid-cols-4">
          <KpiCard label="今日入院人数" value="128" trend="+12%" />
          <KpiCard label="床位占用率" value="82%" trend="+5%" />
          <KpiCard label="平均等待时间" value="34 min" trend="-8%" />
          <KpiCard label="急诊告警" value="5" trend="+2" />
        </section>
        {/* 中部图表区 */}
        <section className="mb-6 grid gap-4 lg:grid-cols-3">
          <div className="col-span-2 rounded-xl bg-slate-900 p-4">
            <h2 className="mb-2 text-sm font-semibold text-slate-200">过去 30 天急诊流量趋势</h2>
            <div className="h-64 rounded-md bg-slate-800/60">{/* TODO: 在这里嵌入折线图组件 */}</div>
          </div>
          <div className="rounded-xl bg-slate-900 p-4">
            <h2 className="mb-2 text-sm font-semibold text-slate-200">科室床位占用对比</h2>
            <div className="h-64 rounded-md bg-slate-800/60">{/* TODO: 在这里嵌入柱状图组件 */}</div>
          </div>
        </section>
        {/* 底部表格及告警列表 */}
        <section className="grid gap-4 lg:grid-cols-3">
          <div className="col-span-2 rounded-xl bg-slate-900 p-4">
            <h2 className="mb-2 text-sm font-semibold text-slate-200">异常告警</h2>
            <div className="h-64 rounded-md bg-slate-800/60">{/* TODO: 表格或列表组件 */}</div>
          </div>
          <div className="rounded-xl bg-slate-900 p-4">
            <h2 className="mb-2 text-sm font-semibold text-slate-200">待处理任务</h2>
            <div className="h-64 rounded-md bg-slate-800/60">{/* TODO: 任务列表组件 */}</div>
          </div>
        </section>
      </div>
    </div>
  );
}

function KpiCard({ label, value, trend }) {
  return (
    <div className="flex flex-col justify-between rounded-xl bg-slate-900 p-4">
      <span className="text-xs font-medium text-slate-400">{label}</span>
      <div className="mt-2 flex items-baseline justify-between">
        <span className="text-2xl font-semibold">{value}</span>
        <span className="text-xs text-emerald-400">{trend}</span>
      </div>
    </div>
  );
}

这样的布局骨架可以由 UI UX Pro Max 根据你的需求生成或大幅简化后手工微调，你只需要在标记位置接入实际的图表组件与数据源即可。

七、与传统'手动抄设计'的方式对比

从实际开发体验来看，引入 UI UX Pro Max 会显著改变你的工作流程。下面用表格对比一下传统方式与使用 UI UX Pro Max 的差异。

八、实践建议与常见坑

在真实项目中使用 UI UX Pro Max，有几个实战向建议：

• 把它当成「高质量起点」，而不是最终稿：尤其在复杂业务和高度品牌化的产品中，仍然需要设计师或产品参与最终审定。
• 明确需求越详细，效果越好：包含：受众、场景、业务目标、品牌调性、已有组件约束等信息，AI 才能更好地决策风格与布局。
• 注意可访问性与本地化：虽然设计库内有可访问性相关规则，但在关键场景（表单、对比度、键盘导航）上建议进行人工复核。
• 团队内统一版本与约定：使用 uipro init --version ... 为项目锁定同一版本，避免不同成员的设计出现风格分裂。

九、结语：让工程师也能'带设计思维写代码'

在以往的工作流中，「设计」和「实现」往往是两个相对割裂的阶段：先出稿，再写代码。而在 UI UX Pro Max 这类 AI 技能的加持下，工程师可以在写代码的同时参与到更上游的设计决策中，用聊天的方式慢慢磨出一套适合业务的 UI/UX 方案。

如果你已经在使用 Claude Code、Cursor、Windsurf 或 GitHub Copilot，不妨花十几分钟把 UI UX Pro Max 接入到现有项目中，挑一个正在开发的页面，用这套「会设计的 AI 技能」重做一次 UI，感受一下从「能跑」到「好用又好看」之间的差距。