第一章 · 认识 Impeccable
先看清敌人（「AI 味」长什么样），再看懂它的四件套：1 个 Skill、23 个命令、61 条检测规则、浏览器实时迭代。
1「AI 味」界面长什么样
每个模型都在同一批 SaaS 模板上训练，于是每个项目都出现同一批「标志性破绽」（官方叫 tells）。
常见 AI 套路（Impeccable 明令禁止）
所有项目都用 Inter 字体、系统默认字体
紫到蓝的渐变横幅、暗色光晕装饰
万物装卡片，card 里再套 card
彩色底上压灰色正文，对比度不够
弹跳 / 橡皮筋缓动（bounce / elastic）
侧边栏右边框「一条线分隔一切」
Impeccable 的主张
选字体是战略决策，每个项目要给出理由
色彩、层次、留白先做方向规划再动手
结构优先：排版与节奏比框框更重要
动效要有目的，缓动有明确曲率约束
视觉方向按页面（surface）单独确认
61 条确定性规则在写码前后持续兜底
2来历与形态
Impeccable 由 Paul Bakaus（jQuery UI 联合创作者）维护，从 Anthropic 的 frontend-design skill 发展而来，Apache-2.0 开源，当前版本 skill 4.3.1。
它由两部分组成：Skill 本体（一堆 Markdown 设计指南 + 命令定义，装进 Agent 的技能目录）和 Impeccable 引擎（一个自包含二进制，首次运行时由启动脚本固定版本下载到 ~/.impeccable/bin/）。引擎负责确定性检测和 live 模式的本地服务；Node.js 只在用 npx impeccable install 安装时才需要——手动复制安装完全不需要 Node。
.cursor/skills/impeccable/ 里，被命令唤醒时才加载，不拖慢你的 Agent。3一次命令的工作回路
你在 Cursor CLI 里输入命令，Skill 提供设计语言与流程，Agent 干活，引擎用确定性规则兜底，live 模式在浏览器里收尾迭代。
其中「引擎体检」这一步很特别：它是确定性的——同一份代码永远得到同一个结果，不需要调用模型、不需要 API key，所以可以塞进 Git hook（写盘前拦截）、CLI（detect 命令）和 CI 流水线。
4两个关键文件：PRODUCT.md 与 DESIGN.md
Impeccable 用两个文档把「产品事实」和「视觉系统」分开记账，这是理解它所有命令的前提。
| 文件 | 谁写的 | 记什么 | 举例 |
|---|---|---|---|
PRODUCT.md | /impeccable init | 持久的产品真相：受众、目的、运行环境、约束、语气 | 「面向自由职业者的记账工具，语气克制，移动优先」 |
DESIGN.md | /impeccable document 或 init 过程 | 视觉系统本身：配色、字体、间距、组件规范 | 「主色 #0F766E，标题用 Fraunces，卡片圆角 12px」 |
分开记账的好处：换视觉方向不会污染产品事实；每个页面（surface）还可以在 .impeccable/surfaces/*.md 里单独记录方向契约，让「落地页要活泼、后台要安静」这类差异化成为可能。
5它能做什么 / 不能做什么
给预期画条线，免得用错地方。
从零规划并实现页面（craft）；给现有 UI 做 UX 审查与技术体检（critique / audit）；统一既有项目的设计系统（document / extract）；力度调节（bolder / quieter / distill）；浏览器里实时比稿（live）；写盘前自动拦截坏改动（hook）。
不能替代人眼看多视口渲染效果；检测全绿不等于视觉优秀（官方原话「证据，不是证明」）；live 模式只能编辑本地代码，不支持线上生产站点；它不维护组件库，也不接管你的 CSS 架构。
进入第二章：安装到 Cursor——重点是 Nightly 频道和 Agent Skills 这两个前置开关。