这个项目能做什么

# ux-skill — 面向 AI 编程工具的设计智能引擎 ux-skill 是一个**设计智能引擎**，旨在让 AI 生成的 UI 独具特色，而非千篇一律。它可集成到 17 种 AI 编程工具中，包括 Claude Code、Cursor、Windsurf、GitHub Copilot、Gemini CLI、Codex 等。该引擎免费、采用 MIT 许可、可离线运行，且从不调用 LLM。 ## 主要特性 - **确定性 7 轴合成器**：将设计简报编译为全新的设计令牌（warmth、contrast、density、geometry、formality、motion、type personality），而非从模板中挑选。 - **152 条反 AI 套路 linter 规则**：基于正则表达式的确定性规则，可在 CI 中运行，并在出现 Critical/High 问题时以非零状态退出。 - **160 个品牌规范**：为 Apple、Stripe、Linear、Figma、Tesla、BMW、Notion、Spotify、Airbnb、Vercel、Supabase、Cursor、Raycast、Claude 等品牌提供的真实 DESIGN.md 规范。 - **12 个可查询 JSON 清单**：84 种风格、176 个调色板、70 组字体搭配、148 个组件、184 个行业、35 种图表类型、57 个动效预设、112 条 UX 法则、152 条反模式规则、25 个技术栈，以及 160 个品牌规范。 - **25 条斜杠命令**：涵盖 discovery、generation、audit、lint、polish、fix loop、case-study、workshop、copy、motion、a11y、dashboard 和 conductor 命令。 - **5 个子代理**：前端工程师、动效工程师、文案撰写者、研究综合者和设计系统架构师。 - **18 个 MCP 工具**：包括 ux_synthesize、ux_decisions_query 和 ux_decisions_stats。 - **支持 17 种 IDE**：同一引擎，针对不同 IDE 使用不同的粘合层。 - **离线且确定性**：不调用 LLM，相同输入始终产生相同输出。 ## 安装 提供三种安装路径： ### 路径 1 — Claude Code marketplace（规范方式） ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### 路径 2 — pip（通用） ```bash pip install uxskill uxskill init # 自动检测你的 IDE，安装正确的产物 uxskill stats # 打印清单计数以验证安装 uxskill lint . # 对当前目录运行 linter ``` ### 路径 3 — npx（无需 Python） ```bash npx uxskill init # 首次运行时下载 pipx + uxskill npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## 工作原理 1. **输入**：通过 `/ux-discover`（10 个字段）或 `ux recommend` 的标志提供设计简报。 2. **5 个并行搜索**：引擎跨清单并发运行五次查找（行业、风格、语气、技术栈、禁用/地区）。 3. **合并**：确定性合并器对候选进行排序并解决冲突。 4. **输出**：一份 JSON 文档，包含风格、调色板、字体搭配、动效预设、组件、品牌范例和反模式护栏。 5. **生成**：下游命令使用该推荐结果，通过子代理生成代码。 6. **验证**：`/ux-lint` 依据 152 条正则规则重新扫描生成的代码。 ## v3.1.0 亮点 - **强制品牌保真**：主色从 logo 像素读取，拒绝默认字体，evaluate 中设有硬性底线，若输出丢弃品牌色/logo 或未提供真实图像则判定失败。 - **移动优先门控**：新增 craft foundations，以及一个感知换行的门控，若出现横向滚动、导航/字标/按钮标签换行或粘性页头过高则判定失败。 - **Wow 层**：引擎为每个页面推导出 2-3 个协调的标志性时刻。 - **更锐利的 linter**：152 条规则，包括 imagery-mandatory、icon-only 检测、placeholder-token 和 100vw 规则。 - **310 个通过的测试**：离线、确定性，从不调用 LLM。 ## 架构 该引擎由以下部分组成： - **data/**：可查询的 JSON 清单（风格、调色板、字体搭配、组件、行业、图表类型、技术栈、UX 指南、动效预设、反模式、品牌）。 - **engine/**：Python 推理核心（synthesizer、decisions、recommender、linter、discovery、generator、installer、CLI）。 - **commands/**：25 条 Claude Code 斜杠命令（.md 文件）。 - **agents/**：5 个子代理（.md 文件）。 - **references/**：数据和演示页面的散文来源。 - **bin/**：npx 包装器和 linter 脚本。 - **.ux/**：每个项目的状态目录。 ## 对比 README 包含与其他 8 个 Claude UX 插件的诚实对比，指出 ux-skill 胜出之处（组件库、动效预设、反模式 linter、品牌规范、支持 17 种 IDE、25 条斜杠命令）以及落后之处（知名度、品牌认知、营销打磨）。 ## 许可证 MIT 许可证。作者：Laith Aljunaidy，安曼的设计师兼 CTO。网站：uxskill.laithjunaidy.com。GitHub：Laith0003/ux-skill。PyPI：uxskill。npm：uxskill。