Impeccable：让AI设计更出色的设计语言

这是什么

Impeccable 是一个为 AI 编码代理（coding agent）提供前端设计指导的开源项目，主语言 JavaScript，GitHub 上获得 45907 星。它本质上是一套可安装的技能（skill），包含 1 个统一入口命令、23 个设计相关命令、浏览器实时迭代能力，以及 46 条确定性检测规则（detector rules）——这些规则不依赖 LLM 运行，无需 API key。项目起源于 Anthropic 的 frontend-design 技能（最初为 Claude 设计），创始人 pbakaus 在此基础上重构，使其适用于 Cursor、Claude Code、Gemini CLI、Codex CLI、Grok Build、GitHub Copilot、Trae、Rovo Dev、Qoder 等几乎所有主流 AI 编码工具。安装后，开发者通过 /impeccable <command> <target> 与 AI 共享一套设计语汇，避免 AI 生成千篇一律的 SaaS 模板风格。

解决的问题

当前 AI 编码代理在生成前端界面时，几乎都基于相同的 SaaS 模板训练，导致输出高度同质化：无论什么项目，AI 都倾向使用 Inter 字体、紫色到蓝色的渐变、卡片嵌套卡片、彩色背景上放灰色文字、每个标题上方加一个圆角方形图标。这些“AI 痕迹”（tells）让项目失去品牌个性，开发者需要反复手动调整提示词才能获得差异化设计。Impeccable 通过一套结构化的设计上下文和确定性规则，从根本上消除这种模板化输出，让 AI 理解项目的品牌、受众与视觉语言，而非依赖默认的“通用好看”模式。

核心功能

1. 一键初始化设计上下文
   /impeccable init 会引导开发者回答两个问题：界面是品牌类（marketing, landing, portfolio）还是产品类（app UI, dashboard, tool），然后自动生成 PRODUCT.md 和 DESIGN.md 两个文件。后续所有命令读取这两个文件中的设计上下文，包括目标受众、品牌/产品赛道、语气、反参考（anti-references）、颜色、字体、组件等。

2. 23 个设计命令
   提供一套共享设计语汇，例如 polish（最终润色）、audit（审计问题）、critique（设计评审）、distill（简化复杂度）、animate（添加动画）、bolder（增强视觉权重）、quieter（减弱视觉权重）等。所有命令通过 /impeccable 入口调用，也支持别名固定（/impeccable pin audit 创建 /audit 快捷方式）。

3. 46 条确定性检测规则 + LLM 评审检查
   规则由 CLI 或浏览器扩展执行，无需 LLM 介入，不消耗 API 额度。它们检查常见的 UI 反模式，例如“不要使用过度使用的字体（Arial、Inter、系统默认）”“不要在彩色背景上使用灰色文字”“不要使用纯黑/纯灰（总是加一点色相）”“不要把所有内容都包裹在卡片中或嵌套卡片”“不要使用弹跳/弹性缓动（显得过时）”。同时，LLM 评审命令（如 critique）会基于上下文做更深层的 UX 分析。

4. 浏览器实时迭代
   支持 live-mode，在浏览器端实时预览并应用修改，方便设计师和开发者即时调整。

5. 多工具一键安装与更新
   npx impeccable install 自动检测 Cursor、Claude Code、Codex 等工具的项目目录，支持 --providers 和 --scope 参数跳过交互。npx impeccable update 刷新现有安装。对于团队，支持通过 Git 子模块（submodule）将 Impeccable 纳入版本控制，保持技能定义与项目同步。

6. 工作文件管理
   运行时生成 .impeccable/ 目录，包含截图、会话状态、缓存和每开发者配置。项目提供了明确的 .gitignore 建议，区分哪些文件应忽略（如 *.png、config.local.json）、哪些应保留（如 config.json、design.json、critique/*.md）。

亮点 / 与同类相比

• 确定性规则与 LLM 评审结合：大多数同类工具（如纯提示词模板）完全依赖 LLM 的输出，但 LLM 有时会忽略规则或产生幻觉。Impeccable 的 46 条规则在 CLI 层面独立运行，不依赖 LLM，确保基础规范被强制执行；LLM 评审则用于更高层次的审美和 UX 评估。这种“规则引擎 + AI 辅助”的设计使其更可靠。
• 跨工具统一体验：无论是 Cursor、Claude Code、Gemini CLI 还是 Codex，Impeccable 都提供相同的命令和规则。开发者无需为每个工具学习不同的提示词语法，只需熟悉 /impeccable 即可。
• 设计上下文优先：与传统 AI 提示词库不同，Impeccable 强制要求项目先定义设计上下文（通过 init），从而让 AI 的每个输出都基于品牌特性和用户需求，而非通用模板。这从根本上解决了“AI 设计看起来都一样”的问题。
• 轻量无侵入：安装只需一个 npx 命令，不依赖外部服务，规则离线运行，不产生额外 API 成本。对团队协作友好，子模块方式可确保所有成员使用同一版本。

适合谁用 / 上手

适合人群：

• 频繁使用 AI 编码代理（Claude Code、Cursor、Gemini CLI、Codex CLI 等）生成前端界面的开发者或设计师。
• 希望 AI 生成的设计具有品牌辨识度，而非千篇一律 SaaS 模板的团队。
• 需要统一设计规范、减少重复审查的多人协作项目。
• 对 AI 生成的前端质量有较高要求，愿意投入少量初始化时间换取长期一致性的人。

上手步骤：

1. 在项目根目录运行 npx impeccable install，工具会自动检测当前支持的工具（如 Cursor、Claude Code 等）并安装技能文件。
2. 在 AI 编码工具中执行 /impeccable init，回答两个问题（品牌类 vs 产品类），生成 PRODUCT.md 和 DESIGN.md。
3. 使用命令：/impeccable audit 审计当前界面，/impeccable polish 润色，/impeccable critique 做设计评审。
4. 若需专注特定区域，可加参数，如 /impeccable audit the header。
5. 对常用命令可固定别名：/impeccable pin audit 后直接用 /audit。
6. 浏览器扩展支持实时迭代，在浏览器中预览调整效果。

详细文档见 impeccable.style。