Skip to content
Back to search

ui-ux-pro-max-skill-cn

本网站是 UI/UX Pro Max 技能库的官方中文教程,完整翻译并本地化了原始 README 的所有内容,帮助中文开发者快速上手这个强大的 AI 设计技能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bbylw--ui-ux-pro-max-skill-cn/badge.svg)](/listings/bbylw--ui-ux-pro-max-skill-cn)

HTML

<a href="/listings/bbylw--ui-ux-pro-max-skill-cn"><img src="/api/listings/bbylw--ui-ux-pro-max-skill-cn/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

使用 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 codewhale   # CodeWhale
uipro init --ai zcode       # ZCode
uipro init --ai kimi        # Kimi Code
uipro init --ai amazonq     # Amazon Q Developer
uipro init --ai openclaw    # OpenClaw (.agents/skills/)
uipro init --ai autoclaw    # AutoClaw (skills/ 或 ~/.openclaw-autoclaw/skills)
uipro init --ai universal   # Universal / Agent 标准 (.agents/skills/)
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/
uipro init --ai zcode --global     # 安装到 ~/.zcode/skills/
uipro init --ai kimi --global      # 安装到 ~/.kimi-code/skills/
uipro init --ai universal --global # 安装到 ~/.agents/skills/

其他 CLI 命令

uipro versions              # 列出可用版本
uipro update                # 从已安装的 CLI 包刷新 skill 文件
uipro update --global       # 从已安装的 CLI 包刷新全局 skill 文件
uipro init --offline        # 兼容性标志;安装随包捆绑的模板
uipro init --dry-run        # 预览安装动作,不写入文件
uipro uninstall             # 移除 skill(自动检测平台)
uipro uninstall --ai claude # 移除指定平台
uipro uninstall --global    # 移除全局安装

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 731 lines
  1. # [UI UX Pro Max](https://uupm.cc)
  2. <p align="center">
  3. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.az.md">🇦🇿 Azərbaycanca</a> |
  4. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
  5. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
  6. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
  7. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文(上游官方版)</a> |
  8. <a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.md">🇺🇸 English</a>
  9. </p>
  10. <p align="center">
  11. <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>
  12. <img src="https://img.shields.io/badge/reasoning_rules-192-green?style=for-the-badge" alt="192 条推理规则">
  13. <img src="https://img.shields.io/badge/UI_styles-79_searchable-purple?style=for-the-badge" alt="79 种可检索 UI 风格">
  14. <img src="https://img.shields.io/badge/python-3.x-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.x">
  15. <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>
  16. </p>
  17. <p align="center">
  18. <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>
  19. <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>
  20. <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>
  21. <a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Support%20Development-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal"></a>
  22. </p>
  23. 一款 AI skill,为跨多种平台与框架构建专业级 UI/UX 提供设计智能。
  24. <p align="center">
  25. <a href="https://uupm.cc">
  26. <img src="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/raw/main/screenshots/website.png" alt="UI UX Pro Max" width="800">
  27. </a>
  28. </p>
  29. <p align="center">
  30. <b>如果这个项目对你有帮助,欢迎支持项目发展:</b><br><br>
  31. <a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Donate-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal Donate"></a>
  32. </p>
  33. <p align="center">
  34. <i>其他项目</i><br>
  35. <a href="https://nextlevelbuilder.io">NextLevelBuilder.io</a> | <a href="https://goclaw.sh">GoClaw.sh</a> | <a href="https://agentkit.best">AgentKit.best</a> | <a href="https://tose.sh">TOSE.sh</a>
  36. </p>
  37. ---
  38. <p align="center">
  39. <span>看看我们的新 skill:</span>
  40. <br/>
  41. <a href="https://github.com/viettranx/3dviz-pro-max" target="_blank">
  42. <picture>
  43. <source media="(prefers-color-scheme: dark)" srcset="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark-dark.svg">
  44. <img src="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark.svg" alt="3Dviz Pro Max" height="56">
  45. </picture>
  46. </a>
  47. </p>
  48. <p align="center"><b>把一个想法变成值得探索的 3D 场景。</b></p>
  49. <p align="center">
  50. <img src="https://cdn.nextlevelbuilder.io/skills/3dviz/harness-village.gif" width="800" alt="Harness Village:一个支持相机导航与生物动画的奇幻村庄">
  51. </p>
  52. <p align="center">
  53. <sub><b>视觉灵感展示,并非基准测试。</b>素材由作者提供,录制于本 skill 诞生<i>之前</i>;其界面中包含越南语。属历史影像,并非英文演示,也不是对本 skill 的运行时测试——参见<a href="https://github.com/viettranx/3dviz-pro-max/blob/main/docs/demos/README.md">媒体来源说明</a>。</sub>
  54. </p>
  55. <p align="center">
  56. 🤌 网站:<a href="https://3dviz.dev/" target="_blank">https://3dviz.dev/</a>
  57. </p>
  58. ---
  59. ## v2.0 新特性
  60. ### 智能设计系统生成
  61. v2.0 的旗舰特性是**设计系统生成器(Design System Generator)**——一个 AI 驱动的推理引擎,能够分析你的项目需求,并在数秒内生成完整、量身定制的设计系统。
  62. ```
  63. +----------------------------------------------------------------------------------------+
  64. | 目标:Serenity Spa - 推荐设计系统 |
  65. +----------------------------------------------------------------------------------------+
  66. | |
  67. | 模式:Hero 主视觉 + 社交证明 |
  68. | 转化:情感驱动,辅以信任元素 |
  69. | CTA:置于首屏,客户评价之后重复出现 |
  70. | 版块: |
  71. | 1. 主视觉 (Hero) |
  72. | 2. 服务 |
  73. | 3. 客户评价 |
  74. | 4. 预约 |
  75. | 5. 联系我们 |
  76. | |
  77. | 风格:柔和 UI 进化版 (Soft UI Evolution) |
  78. | 关键词:柔和阴影、细腻层次、宁静、高级质感、有机形状 |
  79. | 适用:健康养生、美容、生活方式品牌、高端服务 |
  80. | 性能:cost:low | 无障碍:risk:conditional;需验证具体要求 |
  81. | |
  82. | 配色: |
  83. | 主色: #E8B4B8 (柔和粉) |
  84. | 辅色: #A8D5BA (鼠尾草绿) |
  85. | CTA 色: #D4AF37 (金色) |
  86. | 背景: #FFF5F5 (暖白) |
  87. | 文字: #2D3436 (炭灰) |
  88. | 备注:宁静的配色,金色点缀营造奢华感 |
  89. | |
  90. | 字体:Cormorant Garamond / Montserrat |
  91. | 调性:优雅、宁静、精致 |
  92. | 适用:奢侈品牌、健康养生、美容、编辑类 |
  93. | Google Fonts: https://fonts.google.com/share?selection.family=... |
  94. | |
  95. | 关键效果: |
  96. | 柔和阴影 + 符合语境的过渡动画 + 细腻悬停状态 |
  97. | |
  98. | 避免 (反模式): |
  99. | 高饱和霓虹色 + 生硬动画 + 深色模式 + AI 紫/粉渐变 |
  100. | |
  101. | 交付前检查清单: |
  102. | [ ] 不用 emoji 充当图标 (使用 SVG:Heroicons/Lucide) |
  103. | [ ] 所有可点击元素设置 cursor-pointer |
  104. | [ ] 交互时长遵循平台、组件与用户偏好设置 |
  105. | [ ] 浅色模式下文字对比度不低于 4.5:1 |
  106. | [ ] 键盘导航的焦点状态清晰可见 |
  107. | [ ] 遵循 prefers-reduced-motion 偏好 |
  108. | [ ] 文本、chip 与 badge 重排时不被裁切、不破坏标签 |
  109. | [ ] 响应式断点:375px、768px、1024px、1440px |
  110. | |
  111. +----------------------------------------------------------------------------------------+
  112. ```
  113. ### 设计系统生成的工作原理
  114. ```
  115. ┌─────────────────────────────────────────────────────────────────┐
  116. │ 1. 用户请求 │
  117. │ “为我的美容水疗中心搭建一个落地页” │
  118. └─────────────────────────────────────────────────────────────────┘
  119. │
  120. ▼
  121. ┌─────────────────────────────────────────────────────────────────┐
  122. │ 2. 多域搜索 (5 路并行搜索) │
  123. │ • 产品类型匹配 (192 个分类) │
  124. │ • 风格推荐 (79 种可检索;50 种活跃) │
  125. │ • 配色方案选择 (192 套) │
  126. │ • 落地页模式 (34 种) │
  127. │ • 字体配对 (74 组) │
  128. └─────────────────────────────────────────────────────────────────┘
  129. │
  130. ▼
  131. ┌─────────────────────────────────────────────────────────────────┐
  132. │ 3. 推理引擎 │
  133. │ • 匹配产品 → UI 分类规则 │
  134. │ • 应用风格优先级 (BM25 排名) │
  135. │ • 过滤行业反模式 │
  136. │ • 处理决策规则 (JSON 条件) │
  137. └─────────────────────────────────────────────────────────────────┘
  138. │
  139. ▼
  140. ┌─────────────────────────────────────────────────────────────────┐
  141. │ 4. 完整设计系统输出 │
  142. │ 模式 + 风格 + 配色 + 字体 + 动效 │
  143. │ + 需避免的反模式 + 交付前检查清单 │
  144. └─────────────────────────────────────────────────────────────────┘
  145. ```
  146. ### 192 条行业专属推理规则
  147. 推理引擎包含针对以下领域的专门规则:
  148. | 分类 | 示例 |
  149. |------|------|
  150. | **科技与 SaaS** | SaaS、微型 SaaS、B2B 服务、开发者工具 / IDE、AI/聊天机器人平台、网络安全平台 |
  151. | **金融** | 金融科技/加密货币、银行、保险、个人财务追踪、发票与账单工具 |
  152. | **医疗健康** | 医疗诊所、药房、牙科、兽医、心理健康、用药提醒 |
  153. | **电子商务** | 综合电商、奢侈品、二手交易平台 (P2P)、订阅盒、外卖配送 |
  154. | **服务** | 美容/水疗、餐饮、酒店、法律、家政服务、预约与预订 |
  155. | **创意** | 作品集、代理公司、摄影、游戏、音乐流媒体、照片/视频编辑器 |
  156. | **生活方式** | 习惯追踪、食谱与烹饪、冥想、天气、日记、情绪追踪 |
  157. | **新兴技术** | Web3/NFT、空间计算、量子计算、自主无人机编队 |
  158. 每条规则包含:
  159. - **推荐模式** - 落地页结构
  160. - **风格优先级** - 最匹配的 UI 风格
  161. - **配色氛围** - 适合该行业的调色板
  162. - **字体氛围** - 与品牌个性匹配的字体
  163. - **关键效果** - 动画与交互
  164. - **反模式** - 不要做什么(例如银行业的“AI 紫/粉渐变”)
  165. ## 功能特性
  166. - **79 种可检索 UI 风格(50 种活跃)** - 玻璃拟态 (Glassmorphism)、粘土拟态 (Claymorphism)、极简主义、粗野主义、新拟态 (Neumorphism)、Bento 网格、深色模式、AI 原生 UI 等
  167. - **192 套配色方案** - 与 192 种产品类型 1:1 对齐的行业专属调色板
  168. - **74 组字体配对** - 精选排版组合,含 Google Fonts 导入
  169. - **25 种图表类型** - 适用于仪表盘与数据分析场景的可视化建议
  170. - **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
  171. - **119 条 UX 准则** - 最佳实践、反模式、无障碍规则、弹性文本布局、紧凑标签与可取消交互
  172. - **192 条推理规则** - 行业专属的设计系统生成(v2.0 新增)
  173. ### 弹性文本与紧凑型 UI
  174. 本节指南覆盖标题、长 token、chip、badge 以及微交互被中断等常见生产环境问题:
  175. - 标题的平衡换行属于渐进增强(progressive enhancement),并不保证某个特定单词一定落在最后一行。设计仍需在各种宽度、字体和语言环境下依靠自然换行正常工作。
  176. - 关键文本在窄视口、浏览器缩放、文字缩放和用户字距覆盖设置下必须能够重排而不被裁切。长 URL 与标识符应能安全换行。
  177. - Chip 与标签集合应支持换行,或提供可操作的 `+n` 展开入口。紧凑标签在可行时应保持完整;无法避免的截断必须为键盘、指针和触屏用户提供可访问完整值的途径。
  178. - 徽章(badge)的含义不能仅靠颜色传达。可交互 chip 需要原生语义、可见焦点和可编程状态;实时计数需要有意义的上下文。
  179. - 快速连续操作可以取消动画,但最终的语义状态、焦点和内容必须保持正确。动画时长应依据平台与组件选择,并尊重“减少动态效果”偏好。
  180. ### 风格分类体系
  181. 目录包含 **79 种可检索风格**,均带有稳定 ID 和别名:
  182. | 状态 | 数量 | 搜索行为 |
  183. |------|-----:|----------|
  184. | Active(活跃) | 50 | 参与常规推荐,并默认展示在画廊中 |
  185. | Supplemental(补充) | 29 | 仅在精确名称或明确的变体/设计系统意图下返回;可通过画廊状态筛选查看 |
  186. | Deprecated(弃用) | 9 | 不参与常规排名;旧名称会重定向到规范风格或落地页模式 |
  187. 活跃集合涵盖 43 个通用视觉家族、2 个移动端专用风格、3 个官方平台/设计系统、1 个平台材质和 1 个核心分析风格。当前的官方设计系统包括 Fluent 2、Shopify Polaris 和 Adobe Spectrum;Liquid Glass 被限定为 Apple 平台材质,Material 3 Expressive 保留为 Material 移动端变体,Spectrum 2 属于补充集。落地页结构存放在独立的 34 种模式落地页数据集中,不与视觉风格竞争 BM25 排名。
  188. 完整分类及来源元数据见 [`styles.csv`](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/src/ui-ux-pro-max/data/styles.csv)。
  189. ## 💎 基础版与高级版对比
  190. 许多用户询问开源版与高级版的区别。以下是详细对比,帮助你选择适合自己工作流的版本。
  191. ### 🟢 基础版(本仓库)
  192. * **完全开源:** 适合个人开发者、爱好者和常规项目。
  193. * **核心 UI/UX 智能:** 完整提供 79 种可检索 UI 风格(50 种活跃)、192 种产品类型、配色方案和精选字体配对。
  194. * **智能推荐:** 内置 BM25 搜索引擎,实现高精度设计匹配。
  195. * **跨平台支持:** 为 22 个主流框架(React、Vue、Tailwind、iOS、Android 等)提供栈专属指南。
  196. * **设计系统生成:** 通过 CLI 即时生成定制化的 UI 规则、模式与逻辑。
  197. ### 🟡 高级版
  198. * **扩展的品牌设计能力:** 超越 UI/UX 范畴,涵盖品牌识别生成、Logo 设计、企业识别系统 (CIP)、横幅、演示文稿幻灯片和自定义图标设计。
  199. * **高级资产生成:** 深度集成 AI 图像生成能力,创建真实视觉资产而非占位符。
  200. * **企业级架构:** 更完整、可扩展的设计 Token (Design Token) 架构,面向大规模团队部署。
  201. * **优先支持:** 为需要不间断完整设计工作流的团队和专业人士提供专属技术支持。
  202. 👉 *如需了解升级到高级版的详情,请访问 [uupm.cc](https://uupm.cc)。*
  203. ## 安装
  204. ### 使用 Claude Marketplace(Claude Code)
  205. 在 Claude Code 中用两条命令直接安装:
  206. ```
  207. /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
  208. /plugin install ui-ux-pro-max@ui-ux-pro-max-skill
  209. ```
  210. ### 使用 CLI(推荐)
  211. ```bash
  212. # 全局安装 CLI
  213. npm install -g ui-ux-pro-max-cli
  214. # 进入你的项目
  215. cd /path/to/your/project
  216. # 为你的 AI 助手安装
  217. uipro init --ai claude # Claude Code
  218. uipro init --ai cursor # Cursor
  219. uipro init --ai windsurf # Windsurf
  220. uipro init --ai antigravity # Antigravity
  221. uipro init --ai copilot # GitHub Copilot
  222. uipro init --ai kiro # Kiro
  223. uipro init --ai codex # Codex CLI
  224. uipro init --ai qoder # Qoder
  225. uipro init --ai roocode # Roo Code
  226. uipro init --ai gemini # Gemini CLI
  227. uipro init --ai trae # Trae
  228. uipro init --ai opencode # OpenCode
  229. uipro init --ai continue # Continue
  230. uipro init --ai codebuddy # CodeBuddy
  231. uipro init --ai droid # Droid (Factory)
  232. uipro init --ai kilocode # KiloCode
  233. uipro init --ai warp # Warp
  234. uipro init --ai augment # Augment
  235. uipro init --ai codewhale # CodeWhale
  236. uipro init --ai zcode # ZCode
  237. uipro init --ai kimi # Kimi Code
  238. uipro init --ai amazonq # Amazon Q Developer
  239. uipro init --ai openclaw # OpenClaw (.agents/skills/)
  240. uipro init --ai autoclaw # AutoClaw (skills/ 或 ~/.openclaw-autoclaw/skills)
  241. uipro init --ai universal # Universal / Agent 标准 (.agents/skills/)
  242. uipro init --ai all # 所有助手
  243. ```
  244. npm 包名为 `ui-ux-pro-max-cli`,安装后仍使用 `uipro` 命令。旧版 `uipro-cli` 已过时,不应继续用于获取当前资源。
  245. ### 全局安装(适用于所有项目)
  246. ```bash
  247. uipro init --ai claude --global # 安装到 ~/.claude/skills/
  248. uipro init --ai cursor --global # 安装到 ~/.cursor/skills/
  249. uipro init --ai zcode --global # 安装到 ~/.zcode/skills/
  250. uipro init --ai kimi --global # 安装到 ~/.kimi-code/skills/
  251. uipro init --ai universal --global # 安装到 ~/.agents/skills/
  252. ```
  253. ### 其他 CLI 命令
  254. ```bash
  255. uipro versions # 列出可用版本
  256. uipro update # 从已安装的 CLI 包刷新 skill 文件
  257. uipro update --global # 从已安装的 CLI 包刷新全局 skill 文件
  258. uipro init --offline # 兼容性标志;安装随包捆绑的模板
  259. uipro init --dry-run # 预览安装动作,不写入文件
  260. uipro uninstall # 移除 skill(自动检测平台)
  261. uipro uninstall --ai claude # 移除指定平台
  262. uipro uninstall --global # 移除全局安装
  263. ```
  264. ## 前置要求
  265. 搜索脚本需要 Python 3.x(仅使用标准库——脚本不安装任何东西,也不发起网络请求)。
  266. 检查是否已安装 Python:
  267. ```bash
  268. python3 --version
  269. ```
  270. 如果没有安装,请**你本人**从 [python.org](https://www.python.org/downloads/) 或通过系统包管理器(Homebrew、apt、winget)安装。这些安装步骤面向**人类用户**——使用本 skill 的 AI 代理绝不应在你的机器上安装软件,它们被要求改为向你提出请求。
  271. ## 使用方式
  272. ### Skill 模式(自动激活)
  273. **支持:** Claude Code、Cursor、Windsurf、Antigravity、Codex CLI、Continue、Gemini CLI、OpenCode、Qoder、CodeBuddy、Droid (Factory)、KiloCode、Warp、Augment、CodeWhale、ZCode、Kimi Code、Amazon Q Developer、OpenClaw、GitHub Copilot
  274. 当你提出 UI/UX 相关请求时,skill 会自动激活。像平常一样自然对话即可:
  275. ```
  276. 为我的 SaaS 产品搭建一个落地页
  277. ```
  278. > **Trae**:请先切换到 **SOLO** 模式,skill 才会对 UI/UX 请求激活。
  279. ### 工作流模式(斜杠命令)
  280. **支持:** Kiro、Roo Code、KiloCode
  281. 使用斜杠命令调用 skill:
  282. ```
  283. /ui-ux-pro-max 为我的 SaaS 产品搭建一个落地页
  284. ```
  285. ### 示例提示词
  286. ```
  287. 为我的 SaaS 产品搭建一个落地页
  288. 创建一个医疗健康分析仪表盘
  289. 设计一个带深色模式的作品集网站
  290. 为电商应用制作一个移动端 UI
  291. 搭建一个深色主题的金融科技银行应用
  292. ```
  293. ### 为现有应用换肤
  294. [安装 skill](#安装)后,在 AI 助手中打开你的应用,使用类似下面的提示词。工作流模式下请在提示词前加上 `/ui-ux-pro-max`。
  295. ```text
  296. 使用 ui-ux-pro-max skill 为我现有的 React 应用重新设计主题。
  297. 目标风格:极简主义与瑞士风格 (Minimalism & Swiss Style)。
  298. 先检查框架与样式库版本、路由、组件、样式以及现有主题 Token。
  299. 保持现有的组件结构、行为和业务逻辑不变。
  300. 复用并更新现有的语义 Token(颜色、排版、间距、圆角、阴影、交互状态);
  301. 缺失的 Token 直接补充,而不是另建一套平行主题体系。
  302. 逐个组件把硬编码样式替换为 Token 引用。
  303. 验证对比度、键盘焦点、响应式布局以及所有支持的亮色/深色模式。
  304. 最后总结改动的文件以及仍然残留的硬编码样式。
  305. ```
  306. 把 `极简主义与瑞士风格` 替换为你偏好的[目录风格](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/src/ui-ux-pro-max/data/styles.csv)或视觉方向。搜索结果只提供设计指导,不会自动改写你的应用。
  307. **主题迁移检查清单:**
  308. - **审计:** 在样式表、内联样式和工具类(如 `bg-blue-600`、`text-[#1e293b]`)中找出与主题相关的硬编码值。
  309. - **映射:** 复用应用现有样式体系中的语义角色,如 `background`、`surface`、`foreground`、`primary`、`border`、`ring`;缺失角色按其所用库已安装版本的约定补充。
  310. - **迁移:** 小批量地把硬编码值替换为 Token 引用。只修改 Token 本身,不会影响未使用这些 Token 的样式。
  311. - **验证:** 每完成一批,检查文字/UI 对比度、悬停/焦点/禁用状态、响应式布局以及每个支持的主题。
  312. ### 工作原理
  313. 1. **你提出请求** - 提出任何 UI/UX 任务(构建、设计、创建、实现、审查、修复、改进)
  314. 2. **生成设计系统** - AI 使用推理引擎自动生成完整的设计系统
  315. 3. **智能推荐** - 根据你的产品类型和需求,找出最匹配的风格、配色和排版
  316. 4. **代码生成** - 以正确的颜色、字体、间距和最佳实践实现 UI
  317. 5. **交付前检查** - 针对常见 UI/UX 反模式进行校验
  318. ### 支持的技术栈
  319. 本 skill 为以下技术栈提供专属指南:
  320. | 分类 | 技术栈 |
  321. |------|--------|
  322. | **Web (HTML)** | HTML + Tailwind(默认) |
  323. | **React 生态** | React、Next.js、shadcn/ui |
  324. | **Vue 生态** | Vue、Nuxt.js、Nuxt UI |
  325. | **Angular** | Angular |
  326. | **PHP** | Laravel (Blade、Livewire、Inertia.js) |
  327. | **其他 Web** | Svelte、Astro、Three.js |
  328. | **桌面端** | JavaFX、WPF、WinUI 3、Avalonia、Uno Platform、UWP |
  329. | **iOS** | SwiftUI |
  330. | **Android** | Jetpack Compose |
  331. | **跨平台** | React Native、Flutter |
  332. 只需在提示词中提到你偏好的技术栈,不提则默认使用 HTML + Tailwind。
  333. ## 示例
  334. ### 改造前后:运维仪表盘
  335. 一个朴素的运维仪表盘([改造前](https://skill-fixture-before.theroost.dev)),仅使用 UI UX Pro Max 为它生成的设计系统重新应用样式([改造后](https://ui-ux-pro-max-after.theroost.dev)),所用命令:`search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4`。
  336. *由社区贡献的说明性示例;并非官方演示、基准测试或运行时测试。*
  337. ## 设计系统命令(高级)
  338. 如需直接使用设计系统生成器:
  339. > 注意:如果你通过 Continue 安装,请将下面命令中的 `.claude/skills/` 替换为 `.continue/skills/`。Droid (Factory) 请使用 `.factory/skills/`。ZCode 请使用 `.zcode/skills/`。Amazon Q Developer 请使用 `.amazonq/skills/`(Amazon Q 只会自动加载 `.amazonq/rules/ui-ux-pro-max.md` 这条规则;`.amazonq/skills/` 下的数据与脚本是该规则引用的文件)。
  340. ```bash
  341. # 生成 ASCII 输出的设计系统
  342. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"
  343. # 生成 Markdown 输出的设计系统
  344. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown
  345. # 按领域搜索
  346. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
  347. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
  348. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart
  349. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux
  350. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons
  351. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons
  352. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux
  353. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux
  354. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux
  355. # 按技术栈搜索指南
  356. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
  357. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
  358. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind
  359. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
  360. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
  361. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
  362. ```
  363. Web 技术栈搜索支持版本感知。查询中未出现较旧的主版本时,只返回当前的活跃指南;明确包含旧版关键词或旧主版本(例如 `Svelte 4`、`Next.js 15`)时,只返回经过整理的遗留条目,并以 `Status` 和 `Applies To` 标注;当没有匹配的遗留指南时,搜索会直接返回空结果,而不是混合不同框架世代的内容。
  364. ### 持久化设计系统(Master + Overrides 模式)
  365. 把设计系统保存到文件,实现**跨会话的层级检索**:
  366. ```bash
  367. # 生成并持久化到 design-system/myapp/MASTER.md
  368. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"
  369. # 同时创建页面级覆盖文件
  370. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"
  371. ```
  372. 这会创建如下 `design-system/` 目录结构:
  373. ```
  374. design-system/
  375. └── myapp/ # 每个项目一个目录(-p "MyApp" 的 slug)
  376. ├── MASTER.md # 全局唯一事实源(颜色、排版、间距、组件)
  377. └── pages/
  378. └── dashboard.md # 页面级覆盖(只记录与 Master 的偏差)
  379. ```
  380. **层级检索的工作方式:**
  381. 1. 构建某个具体页面(如“结账页”)时,先检查 `design-system/[project-slug]/pages/checkout.md`
  382. 2. 如果页面文件存在,其规则**覆盖** Master 文件
  383. 3. 如果不存在,则只使用 `design-system/[project-slug]/MASTER.md`
  384. **上下文感知检索提示词:**
  385. ```
  386. 我正在构建 [页面名称] 页面。请阅读 design-system/[project-slug]/MASTER.md。
  387. 同时检查 design-system/[project-slug]/pages/[page-name].md 是否存在。
  388. 如果页面文件存在,优先遵循其规则。
  389. 如果不存在,只使用 Master 规则。
  390. 现在,生成代码……
  391. ```
  392. ## 架构与贡献
  393. ### 面向用户
  394. 代码库已重构为**基于模板的生成系统**。所有平台特定文件(`.cursor/`、`.windsurf/`、`.kiro/`、`.factory/` 等)现在都由 CLI 动态生成。
  395. **请始终通过 CLI 安装:**
  396. ```bash
  397. npm install -g ui-ux-pro-max-cli
  398. uipro init --ai <platform>
  399. ```
  400. 这样才能获得随已安装 CLI 包捆绑的最新模板,以及适用于你的 AI 助手的正确文件结构。发布新版本时,请先更新 npm 包。
  401. ### 面向贡献者
  402. 如果你想为本项目做贡献:
  403. ```bash
  404. # 1. 克隆仓库
  405. git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
  406. cd ui-ux-pro-max-skill
  407. # 2. 理解目录结构
  408. src/ui-ux-pro-max/ # 唯一事实源(数据、脚本、模板)
  409. cli/ # CLI 安装器(从模板生成文件)
  410. .claude/ # Claude Code skill 的本地开发/测试
  411. .factory/ # Droid (Factory) skill 的本地开发/测试
  412. # 3. 在 src/ui-ux-pro-max/ 中修改
  413. # - data/*.csv → 数据文件
  414. # - scripts/*.py → 搜索引擎与设计系统
  415. # - templates/ → 平台专属模板
  416. # 4. 同步到 CLI 并在本地测试
  417. cd cli
  418. npm run sync:assets
  419. npm run check:assets
  420. npm run verify:data
  421. npm run typecheck
  422. # 5. 构建并测试 CLI
  423. # `npm run build` 在可用时使用 Bun,否则在 `npm ci` 之后回退到 TypeScript 编译器输出
  424. npm run build
  425. node dist/index.js init --ai claude --offline # 在临时目录中测试
  426. node dist/index.js init --ai claude --dry-run # 预览安装动作(不写入文件)
  427. # 6. 创建 PR(切勿直接推送到 main)
  428. git checkout -b feat/your-feature
  429. git commit -m "feat: description"
  430. git push -u origin feat/your-feature
  431. gh pr create
  432. ```
  433. 详细开发指南见 [CLAUDE.md](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/CLAUDE.md)。
  434. ### 目录数据溯源与刷新
  435. 已提交的 catalog summary 目前记录了 **1,934 款已批准的 Google Fonts**,以及 **8 个待审排除项**——在没有匹配的官方 license 元数据之前,这些排除项不会被提升。图标指南保持 **105 条精选记录**(其中 100 条为直接的 Phosphor web import,其余为 React Native/回退指导);独立的 **1,512 个图标的 Phosphor 上游清单**用于校验名称、字重以及 React/SSR import,避免把整个上游包塞进搜索结果。
  436. 日常开发与 PR CI 完全不依赖网络。运行完整的离线门禁(包含快照哈希与生成计数校验):
  437. ```bash
  438. npm --prefix cli run verify:data
  439. # 或仅检查生成的 catalog summary:
  440. npm --prefix cli run validate:catalog-summary
  441. ```
  442. 刷新规范化也可以基于已提交的 fixtures 完全离线执行。输出只会写入临时候选目录,绝不替换正式数据:
  443. ```bash
  444. candidate_dir="$(mktemp -d)"
  445. python3 scripts/refresh-google-fonts.py \
  446. --api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \
  447. --metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \
  448. --existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \
  449. --overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \
  450. --output-csv "$candidate_dir/google-fonts.csv" \
  451. --license-output "$candidate_dir/google-font-licenses.json" \
  452. --metadata-revision fixture-catalogs-v1 \
  453. --verified-at 2026-08-13 --expected-count 2 --approve-changes
  454. python3 scripts/refresh-icon-catalog.py \
  455. --input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \
  456. --package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \
  457. --react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \
  458. --react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \
  459. --curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \
  460. --output "$candidate_dir/phosphor-icons-upstream.json" \
  461. --verified-at 2026-08-13 --expected-count 2
  462. ```
  463. 连接上游的实时刷新被有意隔离在 `refresh-catalogs.yml` workflow 中:每周一 03:17 UTC 定时运行,也可手动触发。把 `GOOGLE_FONTS_API_KEY` 配置为 GitHub Actions secret,然后运行并下载审核 artifact:
  464. ```bash
  465. gh workflow run refresh-catalogs.yml
  466. run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')"
  467. gh run watch "$run_id"
  468. gh run download "$run_id" --name "catalog-refresh-review-$run_id"
  469. ```
  470. 该 workflow 只读取 Google Fonts Developer API 和锁定版本的官方 Phosphor 包,把候选文件与 unified diff 写入 artifact,且只有只读仓库权限。它绝不 commit、push、开 PR 或 merge。必须先审核变更报告、排除项、license、相关性指标和离线门禁,然后才能手动把候选文件提升到 `src/ui-ux-pro-max/data/`。
  471. ## 自动化发布
  472. 本仓库使用 semantic-release 配合约定式提交(Conventional Commits)自动创建 GitHub 发布:
  473. - `dev` 分支创建 beta 预发布,如 `2.6.0-beta.1`。
  474. - `main` 分支创建正式稳定版发布,如 `2.6.0`。
  475. 发布说明和 `CHANGELOG.md` 由约定式提交信息生成。发布准备期间,版本号会在 `skill.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json`、`cli/package.json` 和 `cli/package-lock.json` 之间同步。
  476. 使用以下提交类型以获得正确的版本号升级:
  477. - `fix:` -> 补丁版本
  478. - `feat:` -> 次版本
  479. - `feat!:` 或 `BREAKING CHANGE:` -> 主版本
  480. 发布 workflow 使用默认的 `GITHUB_TOKEN` 创建 GitHub 发布,并使用仓库的 `NPM_TOKEN` secret 把 `ui-ux-pro-max-cli` 发布到 npm。
  481. ## 故障排查
  482. ### Claude Code 报错 `response exceeded the ... output token maximum`
  483. 这是 Claude Code 单次响应的输出上限,不是 UI/UX Pro Max 安装器或搜索脚本的错误。首先可以让 Claude 把任务拆成更小的步骤,并把较大的结果逐步写入文件。
  484. 如果你确实需要更大的单次响应,且当前使用的模型支持,可以在启动新会话前设置 Claude Code 的输出 Token 上限。例如:
  485. ```bash
  486. # macOS、Linux 或 WSL
  487. export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000"
  488. claude
  489. ```
  490. ```powershell
  491. # Windows PowerShell
  492. $env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "64000"
  493. claude
  494. ```
  495. Shell 环境变量只对从该 Shell 启动的程序生效,因此设置后需要重启 Claude Code。Claude Code 会把超出当前模型输出上限的值收敛到上限;具体上限因模型和提供商而异。调大该值也可能增加延迟与用量,并减少自动压缩(auto-compaction)前可用的有效上下文。参见官方 [Claude Code 环境变量参考](https://code.claude.com/docs/en/env-vars#variables)。
  496. ### `uipro: unknown command 'uninstall'` 或 `unknown command 'update'`
  497. 你安装的 `ui-ux-pro-max-cli` 版本已过时。请更新后重试:
  498. ```bash
  499. npm install -g ui-ux-pro-max-cli@latest
  500. uipro uninstall
  501. ```
  502. ### `uipro uninstall` 提示 "No installed AI skill directories detected"
  503. skill 安装在与当前执行命令不同的目录中。可以:
  504. ```bash
  505. # 方案 A — 回到最初安装它的项目根目录运行
  506. cd /path/to/your/project
  507. uipro uninstall
  508. # 方案 B — 移除全局安装
  509. uipro uninstall --global
  510. # 方案 C — 手动移除
  511. rm -rf .claude/skills/ui-ux-pro-max # Claude Code
  512. rm -rf .cursor/skills/ui-ux-pro-max # Cursor
  513. rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf
  514. rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex
  515. ```
  516. ### Claude.ai 的“上传 skill”对话框提示 "Zip contains too many files (maximum 200)"
  517. 不要上传完整的 GitHub 仓库 ZIP。它是开发用代码检出,包含源代码、CLI 资源、文档、预览和多个捆绑 skill,会超出 Claude 的 200 个文件上传限制。它不是 Claude skill 上传包,本项目目前也不提供单独用于手动上传到 Claude.ai 的 ZIP。
  518. Claude Code 请通过 Marketplace 安装:
  519. ```bash
  520. /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
  521. /plugin install ui-ux-pro-max@ui-ux-pro-max-skill
  522. ```
  523. 或使用 CLI 安装器:
  524. ```bash
  525. npx ui-ux-pro-max-cli init --ai claude
  526. ```
  527. ### Claude Marketplace 安装失败,提示 "Zip file contains a symbolic link"
  528. 这是 v2.5.1 之前版本的已知问题。仓库内部使用过符号链接,某些安装工具无法处理。**解决办法:** 改用 CLI 安装器:
  529. ```bash
  530. npm install -g ui-ux-pro-max-cli
  531. uipro init --ai claude
  532. ```
  533. 或等待下一个修复了该问题的版本发布。
  534. ### `npm install -g ui-ux-pro-max-cli` 因权限错误失败
  535. 请使用 Node 版本管理器(推荐),或完全跳过全局安装:
  536. ```bash
  537. # 用 npx 免全局安装
  538. npx ui-ux-pro-max-cli init --ai claude
  539. ```
  540. ### 运行设计系统命令时找不到 Python
  541. 搜索脚本需要 Python 3.x。请从 [python.org](https://www.python.org/downloads/) 或用系统包管理器(Homebrew、apt、winget)自行安装。AI 代理不应替你安装——它们被要求改为向你提出请求。
  542. ### 设计系统输出被截断 / 字段不完整
  543. 人类可读输出会把超过 300 字符的长字段截断。使用 `--json` 获取完整、未截断的数据:
  544. ```bash
  545. python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json
  546. ```
  547. ---
  548. ## Star 历史
  549. [![Star History Chart](https://star-history.dera.page/svg?repos=nextlevelbuilder/ui-ux-pro-max-skill&type=Date)](https://star-history.dera.page/#nextlevelbuilder/ui-ux-pro-max-skill&Date)
  550. ## 许可证
  551. 本项目基于 [MIT License](LICENSE) 开源。
  552. ## 兼容的智能体
  553. 本 skill 可与以下工具配合使用:
  554. - [Claude Code](https://claude.com/product/claude-code)
  555. - [AdaL](https://sylph.ai/) - 自进化 AI 编码智能体([文档](https://docs.sylph.ai/) | [GitHub](https://github.com/SylphAI-Inc/adal-cli))

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.