Impeccable

项目动机

Anthropic 的 frontend-design 是较早面向 Claude 的设计技能，Impeccable 在此基础上扩展。所有模型训练数据高度同质化，缺少设计引导时，输出总会带上一组可识别的痕迹：千篇一律的 Inter 字体、紫到蓝的渐变、套娃式卡片、彩色背景上的灰色文字，以及每个标题上方千篇一律的圆角图标方块。Impeccable 通过一份统一的引导把这些"AI 套路化"问题系统化地纠正掉。

核心特性

• 一套初始化流程：/impeccable init 生成 PRODUCT.md 与可选的 DESIGN.md，将受众、品牌/产品定位、语气、反面参考、配色、字体、组件沉淀为上下文，供后续命令复用。
• 23 条命令：与 AI 共享设计词汇，覆盖 polish、audit、critique、distill、animate、bolder、quieter 等场景。
• 59 条确定性检测规则：CLI 与浏览器扩展可在不调用大模型、不需要 API Key 的前提下完成扫描，再叠加 LLM 层的评审判断。

技术架构

工具以单一技能 impeccable 的形式安装，统一入口为 /impeccable <command> <target>。命令可在 Cursor、Claude Code、GitHub Copilot、Gemini CLI、Codex CLI、Grok Build、OpenCode、Pi、Kiro、Trae（含国内版与国际版）、Rovo Dev、Qoder、Mistral Vibe、Google Antigravity 等主流 AI 编码代理中加载。

在 Claude Code、GitHub Copilot、Codex、Cursor、Grok Build 上，安装器会同步写入各平台原生的 hook 配置，编辑 UI 文件时即时触发检测：Cursor 在写入前拦截；其余平台在编辑后返回结果，部分平台在 Stop 阶段再做一次深度扫描。运行时产物写入 .impeccable/ 目录，其中 config.json、live/config.json、design.json、critique/*.md 是需要纳入版本控制的共享产物，其余缓存、截图、会话状态建议加入 .gitignore。

关键 CLI 用法

独立 CLI 用于在脱离 AI 代理的场景下做静态扫描：

# 扫描目录、HTML 文件或远程 URL
npx impeccable detect src/
npx impeccable detect index.html
npx impeccable detect https://example.com

# CI 友好的 JSON 输出
npx impeccable detect --json .

# 忽略项目配置与上下文进行裸扫
npx impeccable detect --no-config src/

检测覆盖两类问题：一类是 AI 套路化（侧边标签框、紫渐变、弹跳缓动、暗色发光等），另一类是一般性设计质量（行宽、留白过紧、点击区域过小、标题层级跳跃等）。

如需对单条规则或单文件豁免，可在源文件中加入行内注释：

<!-- impeccable-disable overused-font: exported brand doc -->
<!-- impeccable-disable-line small-touch-target -->
<!-- impeccable-disable-next-line bounce-easing -->

豁免可使用 --no-inline-ignores 或 --no-config 绕过。豁免规则统一通过 npx impeccable ignores 子命令管理：

npx impeccable ignores list
npx impeccable ignores add-file "src/legacy/**"
npx impeccable ignores add-value overused-font Inter --reason "Brand font"

安装方式

推荐使用 CLI 安装器，自动识别 Claude、Codex、Grok、Cursor 等配置目录，并支持 --providers= 与 --scope=project|global 参数跳过交互：

npx impeccable install
npx impeccable update

其他安装路径包括：作为 Git 子模块引入并执行 npx impeccable link；通过平台插件市场安装（Claude Code 用 /plugin marketplace add，Grok Build 用 grok plugin install）；从官网下载 ZIP 解压；从仓库 dist/ 目录手工拷贝对应工具的目录到项目或用户目录。其中 Cursor、Trae、Gemini CLI 等还需要在客户端开启 Skills 或切换到对应 Beta 通道后才可识别。

反模式指引

技能内置明确禁止项：不要使用过度泛滥的字体（Inter、Arial、系统默认）；不要在彩色背景上叠灰字；不要使用纯黑或纯灰，需带色相；不要把所有内容都包进卡片，也不要在卡片里再嵌套卡片；不要使用弹跳或弹性缓动。