返回 Skills Library
设计 来源:GitHub 协议:MIT 协议已标注

ui-ux-pro-max

面向 Web、移动端和品牌资产的 UI/UX 设计知识库与多 skill 工具包。

103.4K GitHub stars 2026-07-09 星标同步 2026-07-09 收录时间
#ui#ux#design-system#multi-platform

快速判断

一句判断

适合把“设计知识检索 + 前端 UI 实现 + 品牌资产”合并到一个 Agent 工作流。

面向 Web、移动端和品牌资产的 UI/UX 设计知识库与多 skill 工具包。

读原文顺序

  1. 先读 README 开头,判断仓库解决的问题。
  2. 再看能力结构或包含内容,确认是否需要整体安装。
  3. 最后看安装、许可证和维护说明。

需要为网站、dashboard、SaaS、移动 app 或组件设计建立 UI/UX 方向时。

需要快速查询风格、配色、字体、产品类型、UX 准则、图表或技术栈建议时。

适合把“设计知识检索 + 前端 UI 实现 + 品牌资产”合并到一个 Agent 工作流;仓库内容较重,建议在明确设计任务时使用,避免所有前端小改都套用。

策展备注: 适合把“设计知识检索 + 前端 UI 实现 + 品牌资产”合并到一个 Agent 工作流;仓库内容较重,建议在明确设计任务时使用,避免所有前端小改都套用。

预览 · README.md

中文为 README 译文;English 保留 GitHub README 原文。

UI UX Pro Max

<p align="center"> <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> | <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.md">🇺🇸 English</a> </p>

<p align="center"> <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/releases"><img src="https://img.shields.io/github/v/release/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=blue" alt="GitHub Release"></a> <img src="https://img.shields.io/badge/reasoning_rules-161-green?style=for-the-badge" alt="161 条推理规则"> <img src="https://img.shields.io/badge/UI_styles-67-purple?style=for-the-badge" alt="67 种 UI 风格"> <img src="https://img.shields.io/badge/python-3.x-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.x"> <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=green" alt="License"></a> </p>

<p align="center"> <a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/v/ui-ux-pro-max-cli?style=flat-square&logo=npm&label=CLI" alt="npm"></a> <a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/dm/ui-ux-pro-max-cli?style=flat-square&label=downloads" alt="npm downloads"></a> <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/stargazers"><img src="https://img.shields.io/github/stars/nextlevelbuilder/ui-ux-pro-max-skill?style=flat-square&logo=github" alt="GitHub stars"></a> <a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-支持开发-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal"></a> </p>

一个为跨多平台和框架构建专业 UI/UX 提供设计智能的 AI 技能。

<p align="center"> <a href="https://uupm.cc"> <img src="screenshots/website.png" alt="UI UX Pro Max" width="800"> </a> </p>

<p align="center"> <b>如果这个项目对你有帮助,请考虑支持:</b><br><br> <a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-捐赠-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal 捐赠"></a> </p>

<p align="center"> <i>其他项目</i><br> <a href="https://nextlevelbuilder.io">NextLevelBuilder.io</a> | <a href="https://goclaw.sh">GoClaw.sh</a> | <a href="https://claudekit.cc">ClaudeKit.cc</a> | <a href="https://tose.sh">TOSE.sh</a> </p>

v2.0 新特性

智能设计系统生成

v2.0 的旗舰特性是设计系统生成器——一个 AI 驱动的推理引擎,可在数秒内分析你的项目需求并生成完整、定制化的设计系统。

+----------------------------------------------------------------------------------------+
|  目标:Serenity Spa - 推荐设计系统                                                      |
+----------------------------------------------------------------------------------------+
|                                                                                        |
|  模式:以 Hero 为中心 + 社交证明                                                         |
|     转化:情感驱动,带信任元素                                                          |
|     CTA:首屏展示,客户评价后重复                                                         |
|     版块:                                                                              |
|       1. 主视觉区 (Hero)                                                                |
|       2. 服务                                                                           |
|       3. 客户评价                                                                        |
|       4. 预约                                                                           |
|       5. 联系我们                                                                        |
|                                                                                        |
|  风格:柔和 UI 进化版 (Soft UI Evolution)                                              |
|     关键词:柔和阴影、微妙深度、 calming、高级质感、有机形状                             |
|     适用:健康、美容、生活方式品牌、高端服务                                             |
|     性能:优秀 | 无障碍:WCAG AA                                                        |
|                                                                                        |
|  配色:                                                                                |
|     主色:    #E8B4B8 (柔和粉)                                                         |
|     辅色:    #A8D5BA (鼠尾草绿)                                                       |
|     CTA:     #D4AF37 (金色)                                                           |
|     背景:    #FFF5F5 (暖白)                                                           |
|     文字:    #2D3436 (炭灰)                                                           |
|     备注: calming 配色,金色点缀增添奢华感                                            |
|                                                                                        |
|  字体:Cormorant Garamond / Montserrat                                                 |
|     调性:优雅、 calming、精致                                                          |
|     适用:奢侈品牌、健康、美容、编辑类                                                  |
|     Google Fonts: https://fonts.google.com/share?selection.family=...                   |
|                                                                                        |
|  关键效果:                                                                            |
|     柔和阴影 + 平滑过渡 (200-300ms) + 细腻悬停状态                                      |
|                                                                                        |
|  避免 (反模式):                                                                       |
|     亮霓虹色 + 生硬动画 + 深色模式 + AI 紫/粉渐变 (银行业)                              |
|                                                                                        |
|  交付前检查清单:                                                                      |
|     [ ] 不使用表情符号作为图标 (使用 SVG: Heroicons/Lucide)                            |
|     [ ] 所有可点击元素有 cursor-pointer                                                 |
|     [ ] 悬停状态带平滑过渡 (150-300ms)                                                 |
|     [ ] 浅色模式:文字对比度至少 4.5:1                                                |
|     [ ] Focus 状态对键盘导航可见                                                       |
|     [ ] 尊重 prefers-reduced-motion 偏好                                             |
|     [ ] 响应式:375px、768px、1024px、1440px                                          |
|                                                                                        |
+----------------------------------------------------------------------------------------+

设计系统生成的工作原理

┌─────────────────────────────────────────────────────────────────┐
│  1. 用户请求                                                     │
│     "为我的美容院搭建落地页"                                      │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  2. 多域搜索 (5 个并行搜索)                                       │
│     • 产品类型匹配 (161 个分类)                                  │
│     • 风格推荐 (67 种风格)                                        │
│     • 配色方案选择 (161 套配色)                                   │
│     • 落地页模式 (24 种模式)                                      │
│     • 字体配对 (57 种组合)                                        │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  3. 推理引擎                                                     │
│     • 匹配产品 → UI 分类规则                                      │
│     • 应用风格优先级 (BM25 排序)                                  │
│     • 过滤行业反模式                                              │
│     • 处理决策规则 (JSON 条件)                                    │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  4. 完整设计系统输出                                             │
│     模式 + 风格 + 配色 + 字体 + 效果                              │
│     + 避免的反模式 + 交付前检查清单                               │
└─────────────────────────────────────────────────────────────────┘

161 条行业特定推理规则

推理引擎包含针对以下领域的专门规则:

分类示例
科技与 SaaSSaaS、微 SaaS、B2B 服务、开发者工具 / IDE、AI/聊天机器人平台、网络安全平台
金融金融科技/加密货币、银行、保险、个人财务追踪、发票与账单工具
医疗健康医疗诊所、药房、牙科、兽医、心理健康、用药提醒
电子商务综合电商、奢侈品、二手交易平台 (P2P)、订阅盒、外卖配送
服务美容/水疗、餐饮、酒店、法律、家政服务、预约与预订
创意作品集、代理公司、摄影、游戏、音乐流媒体、照片/视频编辑器
生活方式习惯追踪、食谱与烹饪、冥想、天气、日记、情绪追踪
新兴技术Web3/NFT、空间计算、量子计算、自动驾驶无人机编队

每条规则包括:

  • 推荐模式 - 落地页结构
  • 风格优先级 - 最匹配的 UI 风格
  • 配色氛围 - 适合行业的调色板
  • 字体氛围 - 匹配品牌个性的字体
  • 关键效果 - 动画与交互
  • 反模式 - 不要做哪些(例如银行业的"AI 紫/粉渐变")

功能特性

  • 67 种 UI 风格 - 玻璃拟态、粘土拟态、极简主义、粗野主义、新拟态、便当盒网格、深色模式、AI 原生 UI 等
  • 161 套配色方案 - 与 161 种产品类型 1:1 对齐的行业专属调色板
  • 57 种字体配对 - 精选字体组合,含 Google Fonts 导入
  • 25 种图表类型 - 适用于仪表板和分析场景的推荐
  • 22 种技术栈 - React、Next.js、Astro、Vue、Nuxt.js、Nuxt UI、Svelte、SwiftUI、React Native、Flutter、HTML+Tailwind、shadcn/ui、Jetpack Compose、Angular、Laravel、Three.js、JavaFX、WPF、WinUI 3、UWP、Avalonia、Uno Platform
  • 99 条 UX 指南 - 最佳实践、反模式与无障碍规则
  • 161 条推理规则 - 行业特定的设计系统生成(v2.0 新增)

可用风格 (67)

<details> <summary><b>通用风格 (49)</b></summary>

#风格最适用于
1极简主义 & 瑞士风格企业应用、仪表板、文档
2新拟态 (Neumorphism)健康/养生应用、冥想平台
3玻璃拟态 (Glassmorphism)现代 SaaS、金融仪表板
4粗野主义 (Brutalism)设计作品集、艺术项目
53D & 超写实主义游戏、产品展示、沉浸式体验
6活力 & 块状创业公司、创意机构、游戏
7深色模式 (OLED)夜间模式应用、编程平台
8无障碍 & 伦理设计政府、医疗、教育
9粘土拟态 (Claymorphism)教育应用、儿童应用、SaaS
10极光 UI (Aurora UI)现代 SaaS、创意机构
11复古未来主义游戏、娱乐、音乐平台
12扁平设计Web 应用、移动应用、初创 MVP
13拟物化传统应用、游戏、高端产品
14液态玻璃高端 SaaS、高端电商
15动效驱动作品集网站、叙事平台
16微交互移动应用、触摸屏 UI
17包容性设计公共服务、教育、医疗
18零界面语音助手、AI 平台
19柔和 UI 进化版现代企业应用、SaaS
20新粗野主义Z 世代品牌、创业公司、Figma 风格
21便当盒网格仪表板、产品页面、作品集
22Y2K 美学时尚品牌、音乐、Z 世代
23赛博朋克 UI游戏、科技产品、加密货币应用
24有机亲生物健康应用、可持续品牌
25AI 原生 UIAI 产品、聊天机器人、Copilot
26孟菲斯设计创意机构、音乐、年轻品牌
27蒸汽波音乐平台、游戏、作品集
28维度分层仪表板、卡片布局、模态框
29夸张极简主义时尚、建筑、作品集
30动态字体主视觉区、营销网站
31视差叙事品牌故事、产品发布
32瑞士现代主义 2.0企业网站、建筑、编辑类
33HUD / 科幻 FUI科幻游戏、太空科技、网络安全
34像素艺术独立游戏、复古工具、创意
35便当网格产品特性、仪表板、个人
36空间 UI (VisionOS)空间计算应用、VR/AR
37电子墨水 / 纸张阅读应用、数字报纸
38Z 世代混沌 / 极繁主义Z 世代生活方式、音乐艺术家
39仿生 / 有机 2.0可持续科技、生物科技、健康
40反精致 / 原始美学创意作品集、艺术家网站
41触感数字 / 可变形 UI现代移动应用、趣味品牌
42自然提炼健康品牌、可持续产品
43交互式光标设计创意作品集、交互式
44语音优先多模态语音助手、无障碍应用
453D 产品预览电商、家具、时尚
46渐变网格 / 极光进化主视觉区、背景、创意
47编辑网格 / 杂志新闻网站、博客、杂志
48色差 / RGB 分离音乐平台、游戏、科技
49复古模拟 / 胶片摄影、音乐/黑胶品牌

</details>

<details> <summary><b>落地页风格 (8)</b></summary>

#风格最适用于
1主视觉中心设计具有强烈视觉识别度的产品
2转化优化型潜在客户生成、销售页面
3功能丰富展示SaaS、复杂产品
4极简直接型简单产品、应用
5社交证明聚焦服务、B2C 产品
6交互产品演示软件、工具
7信任与权威型B2B、企业、咨询
8叙事驱动型品牌、代理公司、非营利

</details>

<details> <summary><b>BI/分析仪表板风格 (10)</b></summary>

#风格最适用于
1密集数据仪表板复杂数据分析
2热力图风格地理/行为数据
3高管仪表板高管摘要
4实时监控运维、DevOps
5钻取分析详细探索
6对比分析仪表板并排对比
7预测分析预测、ML 洞察
8用户行为分析UX 研究、产品分析
9财务仪表板财务、会计
10销售智能仪表板销售团队、CRM

</details>

💎 基础版与高级版对比

许多用户询问开源版与高级版之间的差异。以下是详细的对比,帮助你选择适合自己工作流的版本。

🟢 基础版(本仓库)

  • 完全开源: 适合个人开发者、爱好者及标准项目。
  • 核心 UI/UX 智能: 完整支持 67 种 UI 风格、161 种产品类型、配色方案和精选字体配对。
  • 智能推荐: 内置 BM25 搜索引擎,提供高精度的设计匹配。
  • 跨平台支持: 提供针对 13+ 主流框架(React、Vue、Tailwind、iOS、Android 等)的技术栈专属指南。
  • 设计系统生成: 通过 CLI 即时生成定制化的 UI 规则、模式与逻辑。

🟡 高级版

  • 扩展的品牌设计能力: 超越 UI/UX 范畴,涵盖品牌标识生成、Logo 设计、企业识别系统 (CIP)、横幅、演示文稿幻灯片及自定义图标设计。
  • 高级资产生成: 深度集成 AI 图像生成能力,创建真实视觉素材而非占位符。
  • 企业级架构: 更全面、可扩展的设计令牌 (Design Token) 架构,面向大规模团队部署。
  • 优先支持: 为需要不间断完整设计工作流的团队和专业人士提供专属技术支持。

👉 如需了解升级到高级版的更多详情,请访问 uupm.cc

安装

使用 Claude Marketplace (Claude Code)

通过两条命令直接在 Claude Code 中安装:

/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill

使用 CLI (推荐)

# 全局安装 CLI
npm install -g ui-ux-pro-max-cli

# 进入你的项目
cd /path/to/your/project

# 为你的 AI 助手安装
uipro init --ai claude      # Claude Code
uipro init --ai cursor      # Cursor
uipro init --ai windsurf    # Windsurf
uipro init --ai antigravity # Antigravity
uipro init --ai copilot     # GitHub Copilot
uipro init --ai kiro        # Kiro
uipro init --ai codex       # Codex CLI
uipro init --ai qoder       # Qoder
uipro init --ai roocode     # Roo Code
uipro init --ai gemini      # Gemini CLI
uipro init --ai trae        # Trae
uipro init --ai opencode    # OpenCode
uipro init --ai continue    # Continue
uipro init --ai codebuddy   # CodeBuddy
uipro init --ai droid       # Droid (Factory)
uipro init --ai kilocode    # KiloCode
uipro init --ai warp        # Warp
uipro init --ai augment     # Augment
uipro init --ai all         # 所有助手

npm 包名为 ui-ux-pro-max-cli;它仍然安装 uipro 命令。旧版 uipro-cli 已过时,不应用于当前资源。

全局安装(适用于所有项目)

uipro init --ai claude --global   # 安装到 ~/.claude/skills/
uipro init --ai cursor --global   # 安装到 ~/.cursor/skills/

其他 CLI 命令

uipro versions              # 列出可用版本
uipro update                # 从已安装的 CLI 包刷新技能文件
uipro init --offline        # 兼容性标志;安装捆绑模板
uipro uninstall             # 移除技能(自动检测平台)
uipro uninstall --ai claude # 移除特定平台
uipro uninstall --global    # 移除全局安装

前置要求

搜索脚本需要 Python 3.x。

# 检查是否已安装 Python
python3 --version

# macOS
brew install python3

# Ubuntu/Debian
sudo apt update && sudo apt install python3

# Windows
winget install Python.Python.3.12

使用方式

技能模式 (自动激活)

支持: Claude Code、Cursor、Windsurf、Antigravity、Codex CLI、Continue、Gemini CLI、OpenCode、Qoder、CodeBuddy、Droid (Factory)、KiloCode、Warp、Augment

当你请求 UI/UX 工作时,技能会自动激活。只需自然地聊天:

为我的 SaaS 产品搭建一个落地页

Trae:先切换到 SOLO 模式。技能会在 UI/UX 请求时激活。

工作流模式 (斜杠命令)

支持: Kiro、GitHub Copilot、Roo Code、KiloCode

使用斜杠命令调用技能:

/ui-ux-pro-max 为我的 SaaS 产品搭建一个落地页

示例提示词

为我的 SaaS 产品搭建一个落地页

创建一个医疗健康分析仪表板

设计一个带深色模式的作品集网站

为电商制作一个移动应用 UI

搭建一个带深色主题的金融科技银行应用

工作原理

  1. 你提出请求 - 请求任何 UI/UX 任务(构建、设计、创建、实现、审查、修复、改进)
  2. 生成设计系统 - AI 使用推理引擎自动生成完整的设计系统
  3. 智能推荐 - 根据你的产品类型和需求,找到最佳匹配的风格、配色和字体
  4. 代码生成 - 使用正确的颜色、字体、间距和最佳实践实现 UI
  5. 交付前检查 - 针对常见 UI/UX 反模式进行验证

支持的技术栈

该技能为以下技术栈提供特定指南:

分类技术栈
Web (HTML)HTML + Tailwind (默认)
React 生态React、Next.js、shadcn/ui
Vue 生态Vue、Nuxt.js、Nuxt UI
AngularAngular
PHPLaravel (Blade、Livewire、Inertia.js)
其他 WebSvelte、Astro、Three.js
桌面端JavaFX
iOSSwiftUI
AndroidJetpack Compose
跨平台React Native、Flutter

只需在提示词中提到你偏好的技术栈,或让它默认使用 HTML + Tailwind。

设计系统命令 (高级)

如需直接访问设计系统生成器:

注意:如果你通过 Continue 安装,将下面命令中的 .claude/skills/ 替换为 .continue/skills/。对于 Droid (Factory),使用 .factory/skills/

# 生成带 ASCII 输出的设计系统
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"

# 生成带 Markdown 输出
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown

# 特定领域搜索
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart

# 特定技术栈指南
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx

持久化设计系统 (主配置 + 覆盖模式)

将设计系统保存到文件,实现跨会话的层级检索

# 生成并持久化到 design-system/MASTER.md
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"

# 同时创建页面特定的覆盖文件
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"

这会创建 design-system/ 文件夹结构:

design-system/
├── MASTER.md           # 全局唯一真相源 (颜色、字体、间距、组件)
└── pages/
    └── dashboard.md    # 页面特定覆盖 (仅与主配置的偏差)

层级检索工作原理:

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

上下文感知检索提示词:

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

架构与贡献

对于用户

代码库已重构为使用基于模板的生成系统。所有平台特定文件 (.cursor/.windsurf/.kiro/.factory/ 等) 现在由 CLI 动态生成。

始终使用 CLI 安装:

npm install -g ui-ux-pro-max-cli
uipro init --ai <platform>

这确保你获得随已安装 CLI 包捆绑的最新模板,以及适用于 AI 助手的正确文件结构。发布新版本时请先更新 npm 包。

对于贡献者

如果你想为这个项目做贡献:

# 1. 克隆仓库
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill

# 2. 理解结构
src/ui-ux-pro-max/           # 唯一真相源 (数据、脚本、模板)
cli/                         # CLI 安装器 (从模板生成文件)
.claude/                     # Claude Code 技能的本地开发/测试
.factory/                    # Droid (Factory) 技能的本地开发/测试

# 3. 在 src/ui-ux-pro-max/ 中修改
# - data/*.csv              → 数据库文件
# - scripts/*.py            → 搜索引擎与设计系统
# - templates/              → 平台特定模板

# 4. 同步到 CLI 并本地测试
cd cli
npm run sync:assets
npm run check:assets

# 5. 构建并测试 CLI
bun run build
node dist/index.js init --ai claude --offline  # 在临时文件夹中测试

# 6. 创建 PR (永远不要直接推送到 main)
git checkout -b feat/your-feature
git commit -m "feat: description"
git push -u origin feat/your-feature
gh pr create

详细的开发指南请参见 CLAUDE.md

自动化发布

本仓库使用 semantic-release 配合约定式提交 (Conventional Commits) 自动创建 GitHub 发布:

  • dev 分支创建 beta GitHub 预发布,如 2.6.0-beta.1
  • main 分支创建官方稳定版 GitHub 发布,如 2.6.0

发布说明和 CHANGELOG.md 根据约定式提交信息生成。在发布准备期间,版本号会在 skill.json.claude-plugin/plugin.json.claude-plugin/marketplace.jsoncli/package.jsoncli/package-lock.json 之间同步。

使用以下提交类型以获得正确的版本号升级:

  • fix: -> 补丁版本发布
  • feat: -> 次版本发布
  • feat!:BREAKING CHANGE: -> 主版本发布

发布工作流使用默认的 GITHUB_TOKEN 创建 GitHub 发布,并使用仓库的 NPM_TOKEN 密钥将 ui-ux-pro-max-cli 发布到 npm。

故障排查

uipro: unknown command 'uninstall'unknown command 'update'

你安装的 ui-ux-pro-max-cli 版本已过时。请更新后重试:

npm install -g ui-ux-pro-max-cli@latest
uipro uninstall

uipro uninstall 提示 "No installed AI skill directories detected"

技能安装在与运行命令不同的目录中。可以:

# 方案 A — 切换到最初安装它的项目根目录
cd /path/to/your/project
uipro uninstall

# 方案 B — 移除全局安装
uipro uninstall --global

# 方案 C — 手动移除
rm -rf .claude/skills/ui-ux-pro-max   # Claude Code
rm -rf .cursor/skills/ui-ux-pro-max   # Cursor
rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf
rm -rf .agents/skills/ui-ux-pro-max   # Antigravity

这是 v2.5.1 之前版本的已知问题。仓库内部使用了符号链接,某些安装工具无法处理。解决办法: 改用 CLI 安装器:

npm install -g ui-ux-pro-max-cli
uipro init --ai claude

或等待下一个已修复此问题的版本发布。

npm install -g ui-ux-pro-max-cli 失败,提示权限错误

# macOS/Linux — 使用 Node 版本管理器(推荐)或 sudo
sudo npm install -g ui-ux-pro-max-cli

# 或使用 npx 而不全局安装
npx ui-ux-pro-max-cli init --ai claude

运行设计系统命令时找不到 Python

搜索脚本需要 Python 3.x。请根据你的操作系统安装:

brew install python3        # macOS
sudo apt install python3    # Ubuntu/Debian
winget install Python.Python.3.12  # Windows

设计系统输出被截断 / 字段不完整

使用 --max-length 标志增加(或取消)截断限制:

python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --max-length 0
#                                                                               ^ 0 = 不限制

---

Star 历史

Star History Chart

许可证

本项目采用 MIT 许可证 授权。

兼容的智能体

本技能可与以下工具配合使用: