impeccable

Impeccable 是由谷歌工程师 Paul Bakaus 发起并持续维护的开源 AI 编码代理设计技能框架，核心定位是“为 AI 生成的界面注入结构化的设计判断力，将千篇一律的模板变成有明确风格主张的精致设计”——它不满足于做一份通用的设计建议或零散的代码片段，而是将 1 个核心技能、23 条精确命令、60 条确定性检测器规则、实时浏览器迭代、设计钩子等核心能力整合于一套即插即用的技能体系中，全部配有 npx impeccable install 一键安装、/impeccable init 初始化工作流、/impeccable live 实时视觉迭代模式，以及可跨 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Grok Build 等主流 AI 编码代理的广泛兼容性。市面大多 AI 前端辅助工具要么是泛泛的“做一个好看的页面”式提示（缺乏具体的设计约束），要么是只能输出特定框架代码的脚手架（缺乏审美判断力）——但很少有项目能将“反模板化的设计规则”与“跨平台、可工程化的 AI 技能形态”同时做到，Impeccable 解决的正是这个问题。

一、Impeccable 是什么

Impeccable 采用“技能指令 + 23 条命令 + 实时迭代 + 设计钩子”四位一体的使用体验，通过 GitHub 完全开源发布。项目由谷歌工程师 Paul Bakaus 发起并持续维护，核心定位是“让你的 AI 工具在设计上更出色的设计语言”。项目提供 npx impeccable install 一键安装 CLI，支持检测并安装到 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Grok Build 等主流 AI 编码代理中。完整文档见 impeccable.style。

Impeccable 的运作机制与市面常见的“通用设计建议”或“单平台专属技能”有本质区别。它不是一句“帮我设计一个好看的页面”的泛泛指令，也不是只能在 Claude Code 上运行的专属工具，而是一套 结构化、跨平台、可工程化 的设计技能框架。Impeccable 的起点是 Anthropic 的 frontend-design 技能——第一个被广泛使用的 Claude 设计技能。但 Impeccable 在此基础上做了根本性的扩展：它发现“每个模型都在相同的 SaaS 模板上训练”，如果不加引导，每个项目都会得到同样的结果——到处都是 Inter 字体、紫蓝渐变、嵌套的卡片、彩色背景上的灰色文字。Impeccable 通过 一个初始化工作流（/impeccable init 写入 PRODUCT.md 和 DESIGN.md，让后续命令知道受众、品牌定位、语气、反例参考、颜色、字体和组件）、23 条精确命令（polish、audit、critique、distill、animate、bolder、quieter 等，形成与 AI 的共享设计词汇）、60 条确定性检测器规则（CLI 和浏览器扩展可在无需 LLM 和 API 密钥的情况下运行这些规则）三大支柱，让 AI 编码代理在动手之前先“读懂”设计语境。

二、Impeccable 能做什么

Impeccable 的核心能力可以精炼地概括为：定、调、审、检、活，围绕这五大维度提供了从设计初始化到高质量界面交付的完整路径，覆盖 AI 辅助前端开发的全方位需求，具体包括：

设计语境初始化（定） ——不是“随便选个风格”，而是“先读懂项目再设计”。/impeccable init 是每个新项目的起点——它会询问界面是“品牌”（营销、落地页、作品集）还是“产品”（应用 UI、仪表盘、工具），然后写入设计上下文，供后续所有命令读取。/impeccable document 可从现有项目代码生成根 DESIGN.md；/impeccable extract 可将可复用组件和设计令牌提取到设计系统中。

23 条精确设计命令（调） ——不是“高级感”这种模糊指令，而是可执行的设计操作。Impeccable 提供了 23 条命令，覆盖了从规划到交付的完整设计工作流：

• 规划与审计：/impeccable shape（在写代码前规划 UX/UI）、/impeccable critique（UX 设计评审：层次、清晰度、情感共鸣）、/impeccable audit（技术质量检查：可访问性、性能、响应式）

• 风格调优：/impeccable bolder（放大平淡的设计）、/impeccable quieter（压制过于大胆的设计）、/impeccable distill（剥离到本质）

• 视觉与动效：/impeccable animate（添加有目的的动效）、/impeccable colorize（引入战略性色彩）、/impeccable typeset（修复字体选择、层次和大小）、/impeccable layout（修复布局、间距和视觉节奏）、/impeccable delight（添加愉悦时刻）、/impeccable overdrive（添加技术上的非凡效果）

• 健壮性与适配：/impeccable harden（错误处理、国际化、文本溢出、边缘案例）、/impeccable onboard（首次运行流程、空状态、激活路径）、/impeccable adapt（适配不同设备）、/impeccable optimize（性能优化）

• 最终交付：/impeccable polish（最终润色、设计系统对齐、发布就绪检查）

实时浏览器迭代（活） ——不是“改完再看”，而是“边看边改”。/impeccable live 提供视觉变体模式，让用户可以直接在浏览器中迭代元素。这种“实时反馈”的工作流，将设计迭代从“代码→预览→修改”的长周期缩短为“在浏览器中直接调整、即时看到效果”的实时交互。

60 条确定性检测器规则（检） ——不是“大概看看”，而是“逐条扫描、精准定位”。Impeccable 的 60 条确定性检测器规则 可以在无需 LLM 和 API 密钥的情况下运行。这些规则覆盖了 AI 生成的“模板痕迹”（侧边标签边框、紫色渐变、弹性缓动、暗色光晕）和通用设计质量问题（行长度、拥挤的布局）。CLI 支持扫描目录、HTML 文件或 URL，并支持 CI 友好的 JSON 输出。用户可通过 npx impeccable ignores 添加忽略规则。

设计钩子与实时反馈（审） ——不是“写完再查”，而是“边写边审”。在 Claude Code、GitHub Copilot、Codex、Cursor 和 Grok Build 上，Impeccable 安装一个设计钩子，在直接编辑 UI 文件时自动运行检测器，并将发现反馈到代理流程中。Cursor 甚至会在不良写入落地之前阻止它们；Claude Code、GitHub Copilot、Codex 和 Grok Build 则在编辑后呈现发现。

三、Impeccable 适合谁用

Impeccable 的内容设计使其适配各类希望通过结构化设计规则提升 AI 生成界面品质的开发者与团队，核心聚焦那些“AI 生成的页面代码没毛病，但就是看着廉价、像从同一个模版里倒出来的”，希望从“让 AI 写代码”升级为“让 AI 做有品位的设计”的人群，主要涵盖以下几类：

AI 编码代理的重度使用者——已经在用 Claude Code、Cursor、Codex、Gemini CLI 等 AI 编码代理进行日常开发，但发现 AI 生成的界面总是“千篇一律的模板风”——Inter 字体、紫蓝渐变、三张功能卡片。Impeccable 的 23 条命令和 60 条检测器规则从源头杜绝“模板脸”。

独立开发者与创业团队——资源有限、没有专职设计师，但希望产品在视觉上不输大厂。Impeccable 的 /impeccable init 初始化工作流和 23 条精确命令，让没有设计背景的开发者也能通过结构化的设计操作控制界面的视觉品质。

技术团队负责人与 Tech Lead——希望为团队的 AI 辅助开发建立统一的审美标准和设计门禁。Impeccable 的设计钩子（在 UI 文件编辑时自动运行检测器）和 CI 友好的 JSON 输出，让设计质量检查可以融入团队的 CI/CD 流程。

产品设计师与设计工程师——希望将设计决策系统化、可重复，而非每次都从零开始。Impeccable 的 23 条命令（critique、audit、polish、distill 等）与专业设计师的工作流程高度契合。

跨平台 AI 编码代理用户——在 Cursor、Claude Code、Codex 等多个代理之间切换使用，希望获得一致的设计方法论体验。Impeccable 支持 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Grok Build、OpenCode、Pi、Qoder、Trae 等主流 AI 编码代理。

四、Impeccable 的应用场景是什么

基于其内容设计与定位，Impeccable 的应用场景主要围绕落地页与作品集设计、产品 UI 打磨、设计系统建立和 CI/CD 设计质量门禁，覆盖从个人项目到团队交付的多个场景，具体包括：

落地页与作品集设计场景——独立开发者或设计师需要快速搭建一个视觉出众的个人作品集或产品落地页。Impeccable 提供了一条“/impeccable init 初始化设计语境 → /impeccable shape 规划 UX/UI → /impeccable craft 完整构建 → /impeccable live 实时迭代 → /impeccable polish 最终交付”的完整路径。

现有产品 UI 打磨场景——团队有一个已上线的产品，但 UI 缺乏设计感、看起来“廉价”或“过时”。Impeccable 的 /impeccable audit 可运行技术质量检查，/impeccable critique 可进行 UX 设计评审，/impeccable bolder 或 /impeccable quieter 可调整设计调性，/impeccable polish 可做最终润色。

设计系统建立与规范化场景——团队希望为 AI 辅助开发建立一套统一的设计规则。Impeccable 的 /impeccable document 可从现有代码生成 DESIGN.md，/impeccable extract 可提取可复用组件和设计令牌。

CI/CD 设计质量门禁场景——团队希望在设计质量问题进入主分支之前就被发现。Impeccable 的 CLI 支持 --json 输出，可集成到 CI 流程中；设计钩子在 UI 文件编辑时自动运行检测器；Cursor 甚至会在不良写入落地之前阻止它们。

多代理统一设计体验场景——团队使用不同的 AI 编码代理（Cursor、Claude Code、Codex 等），希望所有代理输出一致的设计品质。Impeccable 的跨平台兼容性让“一次配置，到处一致”成为现实。

五、Impeccable 为什么值得关注

Impeccable 之所以值得关注，核心在于它将“AI 界面的设计品质从依赖运气和直觉升级为规则驱动、命令可控、可工程化的能力”，并具备“谷歌工程师背书、23 条精确命令、60 条确定性规则、跨平台兼容、实时迭代”的独特价值，具体体现在以下几点：

从“通用建议”到“23 条精确命令”的操作化革命。大多数设计建议停留在“做得高级一点”这类模糊指令上——AI 无法准确理解，只能回到默认模板。Impeccable 将设计决策拆解为 23 条可执行的命令：polish、audit、critique、distill、animate、bolder、quieter……每一条命令都对应一个明确的设计操作。用户不再需要说“帮我优化一下这个页面”，而是说“/impeccable polish”——AI 立刻知道要做最终润色、设计系统对齐和发布就绪检查。

从“被动建议”到“主动阻止”的设计钩子。大多数设计工具只提供“建议”——用户可以忽略。Impeccable 的设计钩子在 UI 文件编辑时自动运行检测器；Cursor 甚至会在不良写入落地之前阻止它们。这种“强制而非建议”的设计，让设计质量从“可选项”变为“默认行为”。

60 条确定性规则 + 无需 LLM 的运行方式。大多数 AI 设计工具依赖 LLM 来判断设计质量——慢、贵、不一致。Impeccable 的 60 条确定性检测器规则可以在无需 LLM 和 API 密钥的情况下运行。CLI 支持扫描目录、HTML 文件或 URL，支持 CI 友好的 JSON 输出。这种“确定性规则 + 离线运行”的设计，让设计质量检查可以融入任何开发流程，无需担心 API 成本或网络依赖。

谷歌工程师的行业声誉背书。Impeccable 的创建者 Paul Bakaus 是谷歌工程师，曾参与 Google Web Designer 等项目的开发。其深厚的工程背景和对设计工具的长期投入，为 Impeccable 的设计哲学和质量提供了天然的信任背书。

从“单平台专属”到“跨所有主流 AI 编码代理”的覆盖广度。大多数 AI 设计辅助工具只支持一两种平台。Impeccable 支持 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Grok Build、OpenCode、Pi、Qoder、Trae 等主流 AI 编码代理。用户无论在哪个平台上工作，都能获得一致的设计方法论体验。

“实时浏览器迭代”的交互深度。大多数 AI 设计工具的工作流是“生成代码 → 预览 → 修改 → 重新预览”的长周期循环。Impeccable 的 /impeccable live 提供视觉变体模式，让用户可以直接在浏览器中迭代元素。这种“边看边改”的实时交互，将设计迭代从“分钟级”压缩到“秒级”。

开源 + 活跃迭代。Impeccable 采用开源协议，项目活跃迭代——最新提交为 2026 年 7 月 25 日。项目提供完整的文档站点 impeccable.style、案例研究和活跃的社区支持。

现实挑战与生态成熟度。Impeccable 并非没有短板。首先，项目的核心能力高度依赖于 AI 编码代理对技能指令的遵循程度——不同代理对长指令的“服从度”存在差异。其次，项目目前主要以英文提供，对非英语用户有一定语言门槛。再次，Impeccable 是一个“设计规则框架”而非“代码生成器”——它告诉 AI“什么不该做”和“应该怎么做”，但不直接输出可运行的组件代码，用户仍需结合具体的框架（React/Vue/Svelte 等）进行实现。