Impeccable 实战指南：用 AI 技能为前端架构立规矩
AI 编码智能体很强大，但默认生成的 UI 常常千篇一律：渐变、间距失调、组件臃肿。Impeccable 是一套开源的设计技能包，它能直接嵌入 Claude Code、Gemini CLI、Codex CLI 等工具，通过 23 条命令和 58 条反模式规则，强制 AI 遵循你定义的视觉规范。本文带你了解什么是“技能设计”，以及如何用它打造真正有品牌感的前端作品。
什么是技能设计？为什么对 AI 智能体很重要？
技能设计（Skill Design），简单说就是给不确定的 AI 模型铺一条确定的轨道。与其一遍遍对智能体说“让它更好看”“提升一下性能”，不如事先注入一份编译好的 DESIGN.md 和功能指令，让 AI 在每次迭代中都不得不遵守这些规则。
Impeccable 正是基于 Anthropic 的前端设计技能构建的。它在原有基础上新增了 23 条命令，让你和 AI 之间拥有一套共享的设计词汇；外加 58 条确定的反模式检测规则——例如“默认 Inter 字体”“紫色到蓝色渐变”“卡片套卡片”“彩色背景上的灰色文字”“每个标题上方带圆角方块”等等。这套机制把 AI 从一个靠猜你审美的初级开发者，变成了严格执行你视觉规则的“设计执法官”。
在现代 Web 应用中应用 Impeccable 的约束
把 Impeccable 接入工作流时，精确性是关键。它不会覆盖你现有的设计系统，而是尊重它：运行时，Impeccable 会扫描你的代码库（令牌、组件、Tailwind 配置），并从你自己的 DESIGN.md 文件中加载品牌规则，而不是强加一套通用审美。
举个例子：如果你的品牌是极简风格，那就在 DESIGN.md 里明确声明——有限的绿色和粉色配色板、深色背景设为 #0c1624、字体和语气风格等。这样，后续每一条命令在生成任何内容之前都会先读取这个文件。Impeccable 不替你决定美学风格，它给你的是词汇和机制，让你能在每一次迭代中保持风格一致。
真正干活的命令
Impeccable 提供了 23 条命令，这些命令就是你和 AI agent 之间的共享语言，每条代表一种特定类型的设计干预。在实际生产中，最实用的三条是：
/audit—— 生产级代码检查。它会针对你当前的代码运行 58 条确定性反模式检测规则（通用渐变、默认 Inter 字体、嵌套卡片、可预测的阴影等），然后报告发现的问题，但不会修改任何东西。这是动手改代码前的诊断步骤。/normalize—— 修复系统内部不一致。间距、圆角、字号、颜色用法如果偏离了你DESIGN.md中定义的 token，就会被拉回正轨。当多个 agent 会话随时间累积引入小偏差时，这个命令特别有用。/polish—— 最终质量检查。它会在你现有系统内应用修复（不发明新系统），移除检测到的“AI 痕迹”，然后重新运行检测器，直到零问题才返回结果。
在 Claude Code 或 Cursor 中的典型流程是：先用 /impeccable audit 诊断，再用 /impeccable normalize 让已有代码与你的 token 对齐，最后在提交前用 /impeccable polish 收尾。每一步都读取同一个 DESIGN.md / PRODUCT.md，所以永远不会偏离你的品牌规范。
除了这三个，还有 20 多个命令（/typeset、/distill、/colorize、/layout、/bolder、/quieter、/overdrive 等），覆盖排版、色彩、布局和动效。完整命令列表和安装文档可以在官方仓库的 README 中找到。
实战示例：你自己的品牌规则
Impeccable 不强迫你采用某种前端架构——它不决定你是否使用无 zone 的 Angular、Signal 还是哪个动画引擎。选择权始终在你手上。它只做一件事：始终如一地读取你定义的视觉规则。
下面是一个带有严格品牌约束的 DESIGN.md 示例（仅示意，实际使用 Markdown 格式的 DESIGN.md/PRODUCT.md，遵循 Google Stitch 规范）：
# 仅作示例说明——并非 Impeccable 的实际模式，
# 实际使用 Markdown 格式的 DESIGN.md/PRODUCT.md
brand:
background_base: "#0c1624"
allowed_accents: ["green", "pink"]
voice: "冷静、精确、不浮夸"
anti_references: "避免纯白色。不要生成通用的渐变。抵制攻击性或武器相关的图标，视觉素材中避免生成或展示手部。"
把这个文件放在项目根目录，Impeccable 就会自动读取并应用这些约束。后续你通过命令生成或修改的任何代码，都会符合这套品牌规范。