安装
npx impeccable install适合谁
需要给 AI 编码代理补上设计指导时，再看 Impeccable。官方概括是：Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design。
适合已经有前端项目、并愿意先写下稳定产品事实、再让后续命令按这些事实工作的人。它不是只调颜色的主题包。正文列出可与 Cursor、Claude Code、Gemini CLI、Codex CLI、Grok Build、Hermes Agent、Veto 以及 every other supported tool 一起用，不要把这份名单理解成唯一支持范围。
页面： https://github.com/pbakaus/impeccable
3 分钟完成第一次尝试
官方路径只有这一段，先在项目根目录执行：
npx impeccable install
然后在你的 AI coding tool 里运行 /impeccable init。前置条件：当前目录就是项目根；你接受 init 会把产品事实写入 PRODUCT.md。不要发明其他安装器或未写出的技能目录。
第一次先做只读核对，不要急着写文件。向代理确认：init 会把哪些事实记进 PRODUCT.md，以及这些事实和视觉方向有什么区别。成功信号是代理说出 audience、purpose、operating context、constraints、voice 和 evidence，并说明 later commands 不应把这些与 surface-level visual direction 混为一谈。
确认无误后再运行 /impeccable init。成功信号是项目里出现 PRODUCT.md，内容覆盖上述字段。
使用案例
案例一：先固化产品事实。/impeccable init records durable product truth in PRODUCT.md。把「我们在给谁做、产品做什么、有哪些硬约束、声音是什么」交给代理，让它写入该文件。这是改文件操作，执行前先确认可以创建或覆盖 PRODUCT.md。页面没有给出文件模板全文，不要编造章节名以外的结构。
案例二：用确定性规则检查前端设计。正文写 61 deterministic detector rules，另有 LLM-only critique checks。The CLI and browser extension run the deterministic rules with no LLM and no API key。适合在改完一版界面后，先跑不带模型的规则检查，而不是一上来做生成式点评。能核对的是：这次检查声明不使用 LLM、也不索要 API key。23 条命令的具体名字页面没有列出，不要发明。
使用边界
安装必须从项目根目录开始，然后才是 /impeccable init。不要把两步拆成两套互相竞争的主安装器。
PRODUCT.md 记的是耐久的产品事实，不是视觉风格说明书。
CLI 与浏览器扩展跑确定性规则时不需要 LLM 和 API key；LLM-only critique 是另一类检查，不要混成同一步。
客户端按原文列出，且包含 every other supported tool，不要写成只支持其中某一个。未写出的命令名、规则明细和实时浏览器操作步骤都不要补。