Impeccable

Impeccable 是什么？

Impeccable 是一款面向 AI 编程智能体的开源设计技能。它安装到 Claude Code、Codex、Cursor、GitHub Copilot 等编程工具中，为智能体提供设计指导、一套具名设计命令词汇，以及一个自动检查器，检查 AI 生成的前端常反复出现的界面模式。

Impeccable 设计技能的定位是让智能体具备设计专长：从零构建界面、改进现有界面，并忠于既有设计系统。其仓库把这个包概括为 1 个技能、24 个命令、浏览器实时迭代，以及 61 条针对 AI 生成前端设计的确定性检测规则。

官网将 Paul Bakaus 列为创建者；新安装会下载由 Renaissance Geek, Inc. 签名的引擎，该公司也被列为 Impeccable Chrome 扩展的开发者。据项目 README 介绍，Anthropic 的 frontend-design 是第一个被广泛使用的 Claude 设计技能，Impeccable 以它为起点。

“Impeccable”也是普通单词，一些无关企业也在使用；本页介绍的是从 pbakaus/impeccable 仓库发布的设计技能。

据 2026 年 10 月 5 日的抓取记录，该仓库显示 76.3k 个星标，采用 Apache-2.0 许可证。同日，扩展的商店页面显示 60,000 名用户。

核心功能

一切都通过主技能 /impeccable 运行，后接命令或自然语言请求；audit、polish、critique 等命令都无需单独安装。

命令类别

命令参考将其分为六类：创建（2）、评估（2）、精修（8）、简化（3）、加固（4）和系统（5）。

• 创建：impeccable 接收对要制作或改进内容的描述；shape 把想法变成可构建的设计简报。
• 评估：audit 找出实现问题并排定修复优先级；critique 找出拖累设计的地方。
• 精修：animate、bolder、colorize、delight、layout、overdrive、quieter 和 typeset 各自强化一项品质，例如动效、色彩或字体排印。
• 简化：adapt、clarify 和 distill 涵盖其他设备、更清晰的下一步和更少的杂乱。
• 加固：harden、onboard、optimize 和 polish 处理失败状态、首次运行、速度和收尾打磨。
• 系统：init、document、extract、generate 和 live 管理上下文、设计记录、共享组件和变体。

常用命令可固定为快捷方式，如 /impeccable pin critique；它把请求转发给主技能，因此主技能的改进仍会生效。

PRODUCT.md 与 DESIGN.md 中的项目上下文

Impeccable 会就你的用户及其目标询问一次，把上下文存入 PRODUCT.md，在之后的设计工作前先读取它。document 命令读取界面，把颜色、字体排印和组件规则记入 DESIGN.md，让下一个页面或智能体沿用相同决定。更新 Impeccable 会替换其自身安装的文件，不改动项目的 PRODUCT.md 和 DESIGN.md。

AI 垃圾设计与质量问题检测器

AI 垃圾设计检测器是无需语言模型即可运行的部分。其目录列出 61 条检测规则，另有 6 种模式留给设计评审。检查的问题包括低对比度、文本溢出、常见 AI 设计模式，以及偏离成文设计系统。

• 终端扫描：npx impeccable detect 接受文件夹、文件或 URL；扫描 URL 时，默认在浏览器中以 1280 × 800 渲染页面。
• 机器可读结果：JSON 参数供脚本和 CI 使用，退出码表示没有主要发现（0）、有主要发现（2）或目标无法扫描（1）。
• 源码覆盖：HTML 扫描会包含链接的本地 CSS，而 JSX、TSX、Vue、Svelte、Astro 和样式表文件接受源码检查。
• 设计系统检查：若有本地 DESIGN.md，其中记录的字体、颜色、圆角和字号也会受检。
• 窄范围例外：有意为之的选择（例如被标记为过度使用的品牌字体）可按取值忽略，规则本身仍保持启用。

设计钩子

设计钩子在智能体处理 UI 文件时运行检测器，让发现在改动仍处于上下文中时送达。Claude Code 和 Codex 每次编辑后得到针对性反馈，并在智能体结束本轮时再获得一次更全面的检查；GitHub Copilot 在受支持的编辑后运行完整检测器；在 Cursor 中，一条发现可以阻止拟议的写入，直到智能体修改为止。

实时模式与 generate

实时模式标注为 beta，可让你在运行中的页面上选取一部分，就地比较三种变体，或用“引导”功能调整整个页面；你接受的版本会成为源代码的一部分。若你已能说出元素和方向，generate 命令会从聊天中发起类似比较，例如 generate 3 个大胆的定价卡片变体。

设计方向与效果图

对于新作品，Impeccable 借鉴经人工审核的设计方向（各有自己的视觉规则），并与从你的产品中提取的想法相互权衡。有图像生成时，它可以先出效果图（comp-led）；没有时，Impeccable 直接在代码中构建（code-led），往往看起来更协调，但通常没那么大胆。

使用指南

快速上手

开始使用需要编程工具、项目文件夹，以及 Node.js 22.18 或更高版本；空项目或刚用脚手架搭好的应用均可。

1. 在项目根目录的终端中运行 npx impeccable install，选择编程工具，以及安装到当前项目还是所有项目，然后重新加载该工具。
2. 在智能体聊天中运行 /impeccable init，回答关于项目服务对象的问题，然后阅读生成的 PRODUCT.md，纠正其中理解有误的地方。
3. 如果已有视觉系统，先运行 /impeccable document。
4. 用 /impeccable hooks on 开启自动检查，然后完成编程工具的钩子批准或工作区信任步骤。
5. 用日常语言描述第一个任务，例如 /impeccable polish 定价页面，或请求新页面并说明它面向谁。
6. 打开结果，也在窄屏上试一试它的主要任务，并审查代码改动。

更新与团队共享版本

安装器安装的环境用 npx impeccable update 更新，npx impeccable check 检查是否有更新的版本；插件市场安装的则通过编程工具的插件管理器更新。团队也可改为把一个记录下来的版本作为 Git 子模块，链接到各自的编程工具。

Impeccable 使用场景与示例

• 打磨已经可用的页面：polish 在现有设计范围内细化间距、字体排印、标签和交互状态。
• 发布前检查页面：对指定页面运行 audit 会审查无障碍、性能、响应式表现及其他实现问题。
• 从简报开始：你描述页面、受众以及访客应能完成的事；在效果图优先的流程中，你在实现开始前批准构图。
• 把关拉取请求：CLI 返回构建流程可据以处理的发现和退出码，因此拉取请求中的 UI 改动可被自动检查。
• 把重复模式沉淀为系统：extract 把重复出现的 UI 模式提取为共享组件和样式，供后续页面复用。

适用人群

• 设计新手或 AI 编程工具新手：不需要设计经验或设计词汇；你描述自己在做什么、面向谁，以及哪里感觉不对。
• 转向代码的设计师：在 2026 年 7 月的一次访谈中，创建者估计设计师现在至少占用户群体的一半。
• 已有成熟视觉风格的团队：Impeccable 使用项目现有的颜色、组件和规则来构建与精修，让新页面看起来属于同一个产品。

在两种情况下它不太合适：

• 原生移动开发：钩子检查 Web 代码，并跳过 PRODUCT.md 中声明为 ios、android 或 adaptive 的项目；原生界面评审则建议使用 audit。
• 期望一次提示就得到完成的设计：创建者曾表示，它永远不会成为一次成型的设计工具。

支持平台

受支持的编程工具包括 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、OpenCode 和 Pi 等。

作为一款 Claude Code 设计技能，Impeccable 从安装器获得的不只是技能文件：在 Claude Code、Cursor、Codex、GitHub Copilot 和 Grok Build 上，安装器还会为当前项目添加该平台原生的钩子清单。

实时模式适用于运行中开发服务器上的网页或本地静态 HTML，支持的框架包括基于 Vite 的应用、Next.js、SvelteKit、Astro 和 Nuxt。在编程工具之外，Chrome 扩展会在 DevTools 中添加 Impeccable 面板，显示你选择检查的页面的设计问题。

价格套餐

Impeccable 的公开技能、命令、CLI 和检测引擎免费，并以 Apache 2.0 许可证开源；实际产生的费用来自它周边的工具：

• 编程工具与模型用量：你的编程工具或模型提供商可能按用量收费（包括图像生成），这些费用独立于 Impeccable。
• 图像生成：Codex 内置的生成会计入 Codex 用量限额，而 OpenAI API 备用方案向你自己的 API 项目计费，每张效果图或每次修改都可能增加一次请求。

隐私政策还描述了 Impeccable Pro 的候补名单，会保存报名邮箱，在 Pro 就绪时通知大家。已核查的页面上没有公布任何 Pro 功能或价格。

Impeccable 替代方案

在独立的前端设计技能盘点中，另有两款智能体技能与 Impeccable 一同出现。

Anthropic 的 frontend-design 就是 Impeccable 以之为起点的那款前端设计技能；它自述为在构建新 UI 或重塑现有 UI 时提供鲜明而有意图的视觉设计指导。Impeccable 的 README 把其新增部分概括为单一的安装流程、24 个命令和 61 条确定性检测规则，CLI 和浏览器扩展运行这些规则时无需 LLM 和 API 密钥。

taste-skill 是一组 MIT 许可的可移植智能体技能，目标是在布局、字体排印、动效和间距上胜过模板感明显的 UI；其仓库还包含用于网页、移动端和品牌套件参考板的图像生成技能。

注意事项

• 仅限 Web 界面：检测器检查 Web 界面，并把原生 iOS 或 Android 工作引导到 audit；实时模式同样无法附加到原生 iOS 或 Android 界面。
• 实时模式仍是 beta：文档称它已可试用，但不常见的项目配置仍可能需要排查问题。
• 已报告的源码写入缺陷：2026 年 9 月的一份公开问题报告称，在一个 Next.js 16 和 React 19 项目中，实时模式把无效的 TSX 写进了源码，只靠 git diff 和 TypeScript 检查才发现。另一份针对 4.4.0 版本的报告称，多行 JSX 元素无法定位，且一个后备的丢弃再恢复步骤可能删除原始元素。
• 扫描干净不等于设计结论：干净的结果只说明这些检查没有发现可报告的问题；评判整体设计要用 critique 命令。
• 钩子取决于你的工具：例如 Codex 只在你审查并信任 Impeccable 的 PostToolUse 和 Stop 钩子后才运行它们；没有反馈可能意味着编辑没有问题、处于安静模式，或钩子未激活。
• 效果图转成代码会丢失细节：图像到代码的转换是有损的，因此效果图的部分特色与细节会改变或丢失，文档也提醒用户预期几轮提示与审查。
• 发布初期的反馈：在公开发布前后的一个开发者论坛帖子中，几位评论者认为公布的前后对比示例比原版更差，其中一人指出某个仪表板丢失了大部分有用信息。创建者称这些示例做得仓促并将其删除，还写道词汇不能让用户或 LLM 成为出色的设计师。

隐私与数据处理

• 项目检查在本地运行，不会把项目文件或检测结果上传到 Impeccable 的服务器，不过你的编程工具可能把提示词、文件、截图和其他上下文发给它自己的 AI 提供商。
• 版本检查通常每天最多运行一次，不发送任何项目内容，可用 IMPECCABLE_NO_UPDATE_CHECK=1 关闭。
• 请求设计方向时会发送随机抽取键、范围和可选筛选条件，但不发送你的项目名称、文件路径、提示词或简报。可选的选择报告可用 IMPECCABLE_NO_TELEMETRY=1 或 DO_NOT_TRACK=1 关闭，但这不会停止目录或预览图请求。
• 图像生成器配合 OPENAI_API_KEY 运行时，会把图像提示词和任何参考图片发给 OpenAI，这些提示词可能包含项目细节。
• 官网在首页使用 Google Analytics，在每个页面使用 PostHog，记录页面浏览、点击、复制的命令以及你选择的安装方式。
• Chrome 扩展在本地处理页面快照和检测发现，但会请求访问所有网址的权限，以便检查你选择的网站。

FAQ

Q1. Impeccable 免费吗？

是的。公开的技能、命令、CLI 和检测引擎依据 Apache 2.0 许可证免费提供。你的编程工具、模型提供商或图像生成产生的用量费用，由这些提供商另行计费。

Q2. 检测器需要 AI 模型或 API 密钥吗？

不需要。检测器和设计钩子以代码形式运行，不需要 AI 模型或 API 密钥；只有智能体所做的设计工作才使用它的模型。

Q3. 什么时候应该用 generate，而不是 live？

能说出想要的元素和方向时用 generate；想在浏览器会话中自己挑选元素、添加批注或引导整个页面时，用实时模式。

Q4. 能用于 iOS 或 Android 应用吗？

只能部分使用。检测器、钩子和实时模式面向 Web 界面，因此文档建议原生评审使用 audit 命令。