pbakaus/impeccable:给 AI agent 的设计语言,带确定性的反 slop 规则

impeccable 自称”让你的 AI 工具更会设计的设计语言”,而准确的词是”语言”。它是一个你装进 Claude Code、Cursor 等 agent 的 skill,但其区分性动作是:把 LLM 驱动的设计词汇和 41 条完全不用模型就能跑的确定性检测器配在一起。后半部分正是值得越过 README 去看的:多数设计 skill 是纯 prompt,而 impeccable 加了一层正则与规则,客观地抓特定反模式。作者是 Paul Bakaus,jQuery UI 的联合创造者、Google 技术人,所以这份设计工程的出身是真的。

它怎么运作

初始化一次:/impeccable init 问你的界面是品牌还是产品,并写出一份 PRODUCT.md 和 DESIGN.md 给 agent 提供项目上下文。之后你调用命令,每个是一个聚焦的设计动作:

• **Shape 与 craft:**写代码前规划 UX/UI,再带视觉迭代地构建。
• **Critique 与 audit:**一次 UX 评审(层级、清晰、情感共鸣)和技术检查(可访问性、性能、响应式)。
• **Polish、harden、onboard:**最终设计系统对齐、边界情况与 i18n、首次运行与空状态。
• **语气控制:**bolder、quieter、distill、delight、overdrive,把设计往某个方向推。

检测器层是差异点。它确定性地抓具体反模式(侧栏边框、紫色渐变、bounce 缓动、过窄留白、过小点击目标、糟糕的行长),并作为无需 API key 的 CLI 运行。

安装

# 推荐,自动检测你的工具
npx impeccable skills install

# Claude Code 插件
/plugin marketplace add pbakaus/impeccable

支持的宿主含 Cursor、Claude Code、OpenCode、Gemini CLI、Codex CLI、VS Code Copilot、Kiro 等。CLI 也能独立用:

npx impeccable detect src/                  # 扫描目录
npx impeccable detect https://example.com   # 经无头浏览器扫描 URL
npx impeccable detect --fast --json .       # 仅正则,JSON 输出

那个 --fast 路径让它对 CI 友好:确定性的反模式检测,无模型调用、无 key。

适合与不适合

适合:想让 agent 产出有品味 UI、又想要一个客观护栏防常见 slop 的开发者,以及能把 impeccable detect 接进 pre-commit 或 CI 的团队。不太适合:你想要一个现成设计系统数据库来生成(另一个工具做得更好,见下),或你只想要一行品味推一把。impeccable 对一套设计语言、对抓特定错误很有主见。

横向对比

项目	路子	Stars(2026-06)
pbakaus/impeccable	设计语言 + 41 条确定性检测器	~37k
nextlevelbuilder/ui-ux-pro-max-skill	数据库驱动的系统生成器	~90k
Leonxlnx/taste-skill	通用品味推一把	更轻
nexu-io/open-design	开源设计系统工具	更广

最锋利的对照是和 ui-ux-pro-max-skill:那个从策展数据库生成设计系统,而 impeccable 编码一套设计语言并加确定性检测。想要生成,选那个;想要词汇加客观护栏防坏输出,选 impeccable。项目把自己定位成 Anthropic 自家 frontend-design skill 的演进,检测器是新贡献。

issue 里的坑

发版频繁,开放 issue 很实际:

• Live 模式在 Vite 项目里可能触发无限页面重载(#183),其 steer chat 还可能从页面自有的表单字段抢走焦点(#241)。
• 一个请求恢复 zip 安装(#194)反映了部分用户对 npx 路径的摩擦。
• 对更多技术栈(Blazor、Flutter,#236)和 monorepo 支持(#202)的功能请求,说明当前范围是 web 前端优先。

规律是:检测和评审扎实,而 live 模式和安装手感仍在沉淀。要最可靠、确定性的价值,用 CLI 检测器。

FAQ

impeccable 免费吗? 是。impeccable 是 Apache-2.0 许可的开源项目,可作为 skill 安装,也能作为独立 CLI 运行。

impeccable 需要 API key 吗? CLI 检测器完全不用 key 或模型(确定性的 detect 路径);critique 和设计命令用你宿主 agent 已在跑的模型。

impeccable 和 ui-ux-pro-max-skill 有什么区别? impeccable 是设计语言加 41 条确定性反模式检测器,而 ui-ux-pro-max-skill 从策展数据库生成整套设计系统。要防坏输出的护栏选 impeccable,要生成选后者。

怎么安装 impeccable? 跑 npx impeccable skills install,它会自动检测你的工具,或经 Claude Code 插件市场添加。

impeccable 支持哪些工具? 它能装进 Cursor、Claude Code、OpenCode、Gemini CLI、Codex CLI、VS Code Copilot、Kiro 等,而确定性的 detect CLI 可完全脱离 agent、在 CI 里独立运行。

相关阅读

要生成优先的设计工具见 nextlevelbuilder/ui-ux-pro-max-skill;要更轻的品味推一把见 Leonxlnx/taste-skill;要更广的设计系统工具见 nexu-io/open-design。