Impeccable：给 AI 编码代理补上「设计语言」的开源技能包

AI 编码代理现在能批量产出界面，但产出的界面常常长得一模一样。开源项目 Impeccable 正是冲着这个短板来的：它把设计规范拆成命令和可检测规则，让 AI 在生成前端代码时有约束可循。项目由开发者 Paul Bakaus 维护，GitHub 上 62.6k star、3.8k fork，采用 Apache 2.0 协议。

它解决什么问题

大多数 AI 模型都在同一批 SaaS 模板上训练。一旦跳过设计指引，生成结果就会出现同一套「模板痕迹」：全用 Inter 字体、紫到蓝的渐变、卡片套卡片、彩色背景上放灰字、每个标题上都顶一个圆角方形图标。

Impeccable 的起点是 Anthropic 提供给 Claude 的 frontend-design 技能，在此基础上扩展成一套完整的设计技能包。

三块核心组成

Impeccable 由三部分构成：1 个技能、23 个命令、59 条确定性检测规则。

• 技能 /impeccable：所有命令的统一入口，安装即用。
• 23 个命令：init、audit、polish、critique、distill、animate、bolder、quieter 等，覆盖从规划到收尾的完整流程。
• 59 条检测规则：由 CLI 与浏览器扩展直接运行，不依赖 LLM、也不需要 API key，用于识别 AI 生成界面里的典型问题。

一次 /impeccable init 会写入 PRODUCT.md 和 DESIGN.md，把受众、品牌定位、语气、反例、配色、字体、组件等设计上下文固定下来，供后续每个命令读取。

明确的反模式清单

技能内置了一份「不要做」清单：

• 不使用烂大街字体（Arial、Inter、系统默认）；
• 不在彩色背景上放灰色文字；
• 不使用纯黑、纯灰（始终加一点色调）；
• 不把所有内容塞进卡片，也不卡片套卡片；
• 不使用 bounce / elastic 缓动（观感显旧）。

安装与上手

从项目根目录执行：

npx impeccable install

随后在 AI 编码工具里执行 /impeccable init 即可。检测还能脱离 AI 环境独立运行：

npx impeccable detect src/

它支持的工具有 14 种，包括 Cursor、Claude Code、GitHub Copilot、Gemini CLI、Codex CLI、Grok Build、OpenCode、Pi、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Google Antigravity。

结论

AI 写代码越来越强，但「会写」和「会设计」之间还隔着一套规范。Impeccable 的做法是把设计约束落成命令与规则，让前端界面在 AI 手里也能保持一致的视觉语言。这是它 62.6k star 背后，开发者真实存在的需求。