独立指南——Impeccable 不是 ArtCraft 产品。 Impeccable 是 Paul Bakaus 面向编程 Agent 的设计 skill，不是 ArtCraft 产品，不是 Crafting App，也不由 ArtCraft / storytold 团队开发。本页是我们的教程，不是官方文档。官方来源：impeccable.style 与 github.com/pbakaus/impeccable。

Impeccable Skill：给编程 Agent 的设计命令与工作流

Name: Impeccable
Author: Paul Bakaus

短答：Impeccable 是一个免费开源的设计 skill 与 CLI，让编程 Agent 拥有可执行的设计命令。在项目根目录运行 npx impeccable install，重载 Agent，运行 /impeccable init，然后把 critique、polish、audit 指向一个页面或组件。它不是 ArtCraft 产品，也不能替代设计师。

是什么：面向 AI 编程 Agent 的设计词汇、审查流程和确定性反模式检测器；Apache-2.0，作者 Paul Bakaus。
安装：npx impeccable install → 重载工具 → /impeccable init（Codex 用 $impeccable init）。
核心循环：critique 找问题，polish 收细节，发布前 audit；排版和减法分别用 typeset、distill。
别和它混淆：ArtCraft MCP 是通过各应用官方 CLI/MCP 驱动 PhotoCraft 等本地 Crafting App 的另一层工具，不是设计审查 skill。

官方站 impeccable.style pbakaus/impeccable 官方文档 English

核对：2026年11月3日 · 站点更新：3 November 2026 · 中文：本页 · English

没有使用 Impeccable 时生成的民宿落地页：奶油色背景、细衬线标题配斜体强调、两个胶囊按钮，以及圆角卡片里的扁平矢量插画 — 同一个十四间房民宿 brief，同一个模型，没有 Impeccable 时的结果：奶油色页面、细衬线、斜体强调、胶囊按钮——标准的“有品味默认值”。图片来自 pbakaus/impeccable 官方 README，用来说明设计问题，不是本站截图。

Impeccable 是什么，不是什么

Impeccable 把自己称为“给编程 Agent 的设计词汇表”。你不再说一句含糊的“让它更抓眼”，而是说出一个 Agent 有现成 playbook 的动作，并指定目标：/impeccable bolder the pricing cards、/impeccable critique the onboarding flow、/impeccable polish settings。 skill 会载入这个动作的指导、读取项目上下文，然后直接改代码。它同时提供 audit 做技术质量报告、critique 做打分式 UX 审查，以及一个识别 AI 生成界面“套路感”的检测器。

它最擅长已有界面：指着一个页面或组件反复迭代。也能新建页面，但官方 README 坦言这是更难的用法。项目从 Anthropic 的 frontend-design skill 起步，以 Apache-2.0 发布，分发形式包括 npm 包、面向各工具的 skill，以及 Claude Code、GitHub Copilot、Grok Build 的插件。Node 只在 npx 阶段需要；skill 本体运行旁边的自包含引擎二进制。

它不是什么。Impeccable 不是 ArtCraft，不是 Crafting App，也不是 Adobe 产品。它不是 Figma 那样的独立设计画布，不是图像生成器，也不是托管的审查服务。它不附带 ArtCraft 素材，安装它不会顺带装上 PhotoCraft、LightCraft 或 ArtCraft MCP。如果某个页面把“Impeccable + ArtCraft”打包成一个官方产品，除非 impeccable.style 或 getartcraft.com 明确这么说，否则按错误信息处理。

在项目里安装 Impeccable

在要让 Agent 工作的那个项目里运行安装器，不要在一个随便的全局目录里跑。它会检测能看到的编程工具，询问装到当前项目还是全局，并提供 design hook。README 建议接受 hook：大多数“AI 味”是在编辑过程中被抓住的，而不是等谁想起来才跑一次检测。

npx impeccable install

确认运行时。npx 需要 Node 18.19 或更新版本。安装器会把 skill 写进工具期望的目录（例如 .claude/skills/、.cursor/、.agents/ 或 .dsh/），也可以全局安装。
重载编程工具。正在运行的 Agent 会话通常看不到新 skill，要重载工具。然后运行 /impeccable init（Codex 用 $impeccable init），回答它关于受众、目标和约束的问题。它会写 PRODUCT.md，后续命令都会读这个文件。
需要时批准 hook。Claude Code 要接受工作区信任并检查 /hooks；Codex 要在 /hooks 里批准项目 hook，更新改变 hook 后还要再批准；Grok Build 要 /hooks-trust 或 --trust；Hermes Agent 要把 hook 当插件启用。准确步骤见 hooks 文档。
有意识地更新。npx impeccable update 刷新已有安装。脚本场景可以传 --providers=claude,codex,cursor 和 --scope=project|global。团队要固定版本时，官方 README 给了 git submodule 加 npx impeccable link 的做法。

没有 Node？官网提供 ZIP 构建，仓库也在每个工具目录里提交了构建产物。手动复制能拿到 skill，但拿不到 design hook 和 subagents；README 说想要这些就跑安装器。Claude Code 还可以走插件市场：/plugin marketplace add pbakaus/impeccable。

先掌握这些命令：critique、polish、audit、typeset、distill

Impeccable 一共 24 个命令，第一天不需要全用。下面五个覆盖常见循环：先理解问题，再收细节，然后检查实现，最后在排版或信息过载是真正瓶颈时做针对性修复。调用格式是 /impeccable <命令> <目标>；Codex 用 $impeccable，只输入 /impeccable 会列出命令。

优先学习的 Impeccable 命令
命令	做什么	什么时候用
`/impeccable init`	读代码，只问它推断不出来的信息，然后写 `PRODUCT.md`：受众、目标、约束。后续命令都读它。	每个项目一次，在第一次 critique 或新建之前。
`/impeccable critique`	打分式 UX 审查：设计质量、可用性、不同视角和优先级清单；同时跑自动反模式检查，但不改设计。	页面显得普通、混乱、难用，又说不清原因时。
`/impeccable polish`	修间距、排版、交互、文案和状态，保留页面目的与视觉识别；阻塞性问题优先。	方向对了，但细节还不到能发布的程度。
`/impeccable audit`	技术报告：无障碍、性能、主题、响应式、实现一致性，按 P0（阻塞）到 P3（打磨）排序。不改代码。	发布前、大改之后，或怀疑质量有问题时。
`/impeccable typeset`	修排版系统：字体选择、层级、字号、行宽、行距和跨页一致性，也检查缩放和大字号行为。	标题和正文糊在一起，或同一角色在不同页面长得不一样。
`/impeccable distill`	围绕主任务做减法：去重复、合并相关元素、把偶发选项收起来，但保留必要标签和状态。	界面一次要求用户消化太多东西。
`/impeccable hooks status\|on\|off`	查看、开启或关闭当前项目的 design hook。hook 在 Agent 编辑 UI 文件时跑检测器，在 Agent 停下前把问题交回来。	想要自动检查，或需要为一次专注运行临时静音。

其余命令在需要更窄的动作时再用：bolder、quieter、colorize、layout、animate、delight、overdrive、harden、clarify、adapt、optimize、onboard、shape、document、extract、generate、live、pin。craft 是普通新建请求的弃用别名。每个命令在官方文档里都有独立页面，参数细节以那里为准。

在一个真实页面上走一遍

目标越窄，结果越好。挑一个页面或组件，说明哪些东西不能改，并让 Agent 在分支或你能审阅的本地 diff 里工作。下面的顺序是合理默认值，不是必须照搬的流水线。

/impeccable init
/impeccable critique the pricing page. Keep the current plan names and prices.
/impeccable polish the pricing cards. Keep the layout and brand colors.
/impeccable audit the checkout flow
/impeccable typeset the help articles

先建立一次上下文。init 写 PRODUCT.md；如果还想把现有视觉系统固化下来，运行 /impeccable document，它会写 DESIGN.md，让后续修改保持品牌一致。
先审再改。先跑 critique，读优先级清单。只让你认同的修复被执行，不要照单全收。
一次只 polish 一个界面。保留方向，让 polish 修间距、状态、焦点、加载和空状态。窄视口和键盘路径要自己再走一遍。
发布前 audit。先修 P0 和 P1；修完再跑一次 audit。总分高也可能仍藏着一个阻塞问题。

如果命令问了一个会改变设计方向的问题，在对话里回答，不要让它猜。结果不对时，给一条聚焦的修正（“错误提示更清楚了，但出现时表单会跳——按钮位置别动”），而不是把整页推倒重来。

Impeccable 和编程 Agent 怎么配合

Impeccable 是设计成待在你现有 Agent 里面的，而不是另起一个工具。它支持 Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Grok Build、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness 和 Veto。安装器会为检测到的工具选择构建；命令相同，但调用方式和 hook 信任步骤不同。例如 Codex 用 $impeccable，不是斜杠命令。

真正改变日常工作的是 design hook。没有它，检测器只在有人想起来时运行；有了它，Agent 每改一个 UI 文件都会扫描，问题还在上下文里时就交回来。同一个检测器也能在 CI 里用命令行跑：npx impeccable detect src/；还有 Chrome 扩展，可以把问题叠加显示在任意在线页面上。它是确定性的：62 条规则，不用 LLM，不要 API key。JSX、TSX 这类源码只跑模式规则；低对比度、过小字号这种需要渲染页面的规则，要给 URL 或正在运行的开发服务器。

同一个民宿落地页在使用 Impeccable 后的结果：整幅海崖别墅夜景版画、奶油色与朱红色窄体标题，以及底部月份条 — 同一个模型、同一个 brief，用了 Impeccable：页面围绕一张主视觉展开，而不是奶油色加衬线的默认模板。图片来自 pbakaus/impeccable 官方 README，用来说明设计词汇的作用，不代表你的项目一定得到同样结果。

Impeccable 与 ArtCraft MCP：什么时候用哪个

两者都“面向 Agent”，很容易混，但作用层不同。Impeccable 是设计 skill，处理前端源码和渲染出来的界面；ArtCraft MCP 是各 Crafting App 官方提供的 MCP/CLI 接口，让 Agent 通过应用自己的服务器驱动 PhotoCraft、FigCraft、LightCraft、EffectCraft、VectorCraft 等本地应用。一个塑造界面，一个操作界面背后的内容生产工具。

两件不同的事，不能互相替代
维度	Impeccable skill	ArtCraft MCP
作用对象	前端源码、组件、设计系统、渲染后的页面。	通过官方 CLI/MCP 服务器操作本地 Crafting App（例如 PhotoCraft）。
产出	设计指导、按优先级排序的 critique / audit 结果、改过的 UI 代码。	应用动作：图像编辑、导出、自动化和项目操作。
什么时候用	界面显得普通、层级弱，或发布前需要无障碍与质量检查。	Agent 需要在你机器的 Crafting App 里生产、编辑或导出素材。
不是同一件事	不是 Figma、设计画布、图像生成器，也不是 ArtCraft 官方文档。	不是设计审查 skill，也不是社区里叫“artcraft-mcp”的订阅 API 项目。

组合使用是合理的：用 Impeccable 设计和审查营销页或产品 UI，用 ArtCraft MCP 自动生产这个 UI 需要的图片、视频素材。凭据、权限和审阅边界要分开。官方 MCP/CLI 设置见 ArtCraft MCP 指南和 Crafting Apps 枢纽。不要安装声称把两者合并起来的社区“全家桶”。

检测器、CLI 与 CI

即使你从不用斜杠命令，检测器也有用。它扫描源码或渲染页面，按规则 ID 报告问题；--json 输出机器可读结果，--github 输出 GitHub Actions 注解，--list-rules 只列规则不扫描。退出码 2 表示有问题，1 表示某个目标根本没能扫描——这是另一种失败，不能当成通过。

npx impeccable detect src/
npx impeccable detect https://example.com
npx impeccable detect --json .
npx impeccable detect --github src/
npx impeccable detect --list-rules

要让品牌字体全局放行，README 的示例是 npx impeccable ignores add-value overused-font Inter --reason "Brand font"。要对单个文件关闭某条规则，加注释，例如 。把这些当成代码变更：审阅、保持范围最小，不要因为报告吵就随手静音。

安全、范围与限制

只从官方 npm 包或官方仓库安装。安装器可能写入在模型审批之外运行的 hook——在 Claude Code 里，命令 hook 即使你拒绝模型自己的命令也会执行——所以无人值守前先审阅 hook 条目。如果某次运行不想要 hook，README 记录了用 --settings 配 disableAllHooks: true 临时关闭。

live 模式是本地开发工具。它改本地 checkout，README 明确说不要注入已部署站点，也不要为了让它工作而削弱生产环境 CSP。应用文案修改时，可能会用你的权限运行项目里可选的 impeccable:manual-edit-validate 脚本，所以在不熟悉的仓库里用 live 模式前先看这个脚本。遥测默认用于视觉方向目录；它不会发送项目名、文件、代码或 PRODUCT.md，可以用 npx impeccable telemetry off、DO_NOT_TRACK=1 或项目配置关闭。当前发送清单以官方隐私页为准。

最后，Impeccable 是一个快速变化的第三方项目。命令、参数和集成可能在本页核对日期之后变化。以你实际安装版本的官方文档和 changelog 为准；团队依赖固定工作流时，锁定版本。本页没有复刻完整命令参考，也不能替代官方文档。

谁适合用 Impeccable

可以试：你已经用编程 Agent 做 UI，想要一套可重复的 critique、polish、audit 流程；想在编辑循环或 CI 里放一个确定性检测器；或者团队里多个 Agent 需要共享设计词汇。
先等：你需要完整设计画布、素材生成或无障碍认证。Impeccable 审查和修改代码，不替代设计师、浏览器测试套件或真人无障碍审计。
不要装：第三方站点重打包的“Impeccable + ArtCraft”合集。用官方 npm 包或官方仓库，批准 hook 前读清楚改动。

Impeccable skill 常见问题

Impeccable skill 是什么？

Impeccable 是 Paul Bakaus 开发的开源设计 skill 与命令行工具，给 AI 编程 Agent 一套可执行的设计词汇：critique、polish、audit、typeset、distill 等命令，以及一个确定性的“AI 味”检测器。它不是独立设计软件，也不生成图片。官网是 impeccable.style，源码在 github.com/pbakaus/impeccable，许可证为 Apache-2.0。

Impeccable 是 ArtCraft 或本站的产品吗？

不是。Impeccable 不是 ArtCraft 产品，不是 Crafting Apps 之一，也不由 ArtCraft / storytold 团队开发。Open Creative Apps 是独立指南站，本页是我们的教程，不是 Impeccable 官方文档。官方来源只有 impeccable.style、官方文档和 github.com/pbakaus/impeccable。遇到“Impeccable for ArtCraft”打包下载，按非官方处理。

怎么安装 Impeccable？

在项目根目录运行 npx impeccable install。安装器会检测你的编程工具，询问装到当前项目还是全局，并在支持的工具里提供 design hook。建议接受 hook，然后重载编程工具，在 Agent 里运行 /impeccable init（Codex 用 $impeccable init）。npx 需要 Node 18.19 或更新版本；skill 本体运行自带的引擎二进制。已安装过可用 npx impeccable update 更新。

critique、polish、audit 有什么区别？

critique 是打分式 UX 审查：解释设计哪里拖后腿、先修什么，不改代码。polish 是发布前的收尾，修间距、排版、交互、文案和状态，但保留原有方向。audit 是技术质量报告，覆盖无障碍、性能、主题、响应式和实现一致性，按 P0 到 P3 排序。先用 critique 找方向，用 polish 收细节，发布前跑 audit。

支持哪些编程 Agent？

官方 README 列出 Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Grok Build、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness 和 Veto。多数工具用 /impeccable 斜杠命令，Codex 用 $impeccable。部分工具还要单独信任 hook，例如 Codex 的 /hooks、Hermes 的插件启用命令；以你所用工具的当前文档为准。

需要 API key 或付费订阅吗？

不需要。Impeccable 以 Apache-2.0 开源，免费使用。检测器是确定性的：62 条规则，不用 LLM，也不要 API key，可以在 Agent 内、终端、CI 或浏览器扩展里跑。设计命令通过你已有的编程 Agent 执行，所以你付的是那个 Agent 的费用，不是 Impeccable 订阅费。可选的“先出效果图”流程会用到工具自带的图像能力或你自己的 OpenAI key，但不是必须购买 Impeccable 套餐。

/impeccable hooks 系列命令做什么？

design hook 会在 Agent 编辑 UI 文件时运行检测器，并在 Agent 宣布完成前把问题交回来。在 Agent 里，/impeccable hooks status 查看当前项目是否开启，/impeccable hooks on 或 /impeccable hooks off 开关。编程工具本身也要允许 hook：Claude Code 要接受工作区信任并检查 /hooks，Codex / Cursor 要审阅 hook，Copilot 要把 hook 文件提交到仓库。完整步骤见 impeccable.style/docs/hooks。

什么时候用 Impeccable，什么时候用 ArtCraft MCP？

如果工作对象是界面本身——页面、组件、设计系统、响应式布局——用 Impeccable，它看前端源码和渲染结果。如果 Agent 要驱动本地 Crafting App，例如用 PhotoCraft 做分层图像编辑、用 LightCraft 做 RAW 显影，就用该应用官方的 CLI/MCP，也就是 ArtCraft MCP 这条线。两者层次不同，可以配合：Impeccable 审界面，ArtCraft MCP 生产和编辑素材。社区里叫“artcraft-mcp”的订阅 API 是第三种东西，别混在一起。

安装 Impeccable 安全吗？

只从官方 npm 包 impeccable（npx impeccable install）或 github.com/pbakaus/impeccable 安装。批准 hook 前先看清它改了什么：在 Claude Code 里，命令 hook 即使你拒绝模型自己的命令也会运行，所以无人值守前要审阅。live 模式只改本地 checkout，不要注入已部署站点，也不要为了它削弱生产环境 CSP。遥测可用 npx impeccable telemetry off、DO_NOT_TRACK=1 或项目配置关闭。和任何第三方工具一样，团队使用要固定版本并审阅更新。

Impeccable 能替代设计师或 Figma 吗？

不能。Impeccable 给 Agent 更好的设计判断和可重复的审查词汇，但不能替代有品味、懂产品上下文、对结果负责的人。它最擅长已有界面：指着一个页面或组件反复迭代。新建设计也有 comp-led 和 code-led 两种路径，但“什么算好”仍要人来决定。把它的评分当成结构化的第二意见，而不是质量保证。

独立声明

Open Creative Apps（opencreativeapps.com）是介绍 ArtCraft Crafting Apps 的独立指南 / 小果园。本页同样独立于 Impeccable：我们不是 ArtCraft，不是 ArtCraft / storytold 团队，不是 getartcraft.com，不是 Paul Bakaus，也不是 impeccable.style。我们不维护、不销售 Impeccable，也不代表其作者发言。“Impeccable”及相关名称归各自所有者，这里只用于识别。官方站点是 impeccable.style；源码在 github.com/pbakaus/impeccable。如果某个页面自称官方 Impeccable 站，却不是这两个域名之一，它就不是官方。

命令、版本和集成方式可能在发布后变化。采用某套工作流前，重新核对官方文档与仓库；如果你要支持一个团队，把实际安装的版本记进自己的 runbook。

Sources

Every fact on this page comes from the pages below, checked on 2026年11月3日.