项目详情

Impeccable

让 AI 编码 Agent 擅长设计的设计语言

pbakaus/impeccable Apache-2.0 1 skill · 23 commands 59 检测规则 skill v4.1.2 14+ Runtime

更新于 2026-09-17 · 上次 2026-08-09(57k★ 时代,本次补 v4.1 系列更新)

← 返回汇总
项目速览

一句话定位

治好 AI 生成前端的「千篇一律病」

继承 Anthropic frontend-design skill 的衣钵再进化:用 1 个 skill + 24 个命令 + 61 条确定性检测规则,把「设计品味」变成 AI Agent 可执行的工作流。/impeccable init 一次写入 PRODUCT.md + DESIGN.md(受众、品牌/产品定位、声音、反参考、配色、字体、组件),后续每个命令都读这份上下文。关键差异化:确定性规则无需 LLM/API key,CLI 和浏览器扩展直接跑。适合想让 AI 写出「不像 AI 生成」的前端、或团队要统一设计语言再让 Agent 执行的开发者。

核心数据

仓库画像

68.6k
GitHub Stars
24
斜杠命令
59
确定性检测规则
14+
兼容 Runtime

覆盖 Claude Code / Cursor / Codex / Gemini CLI / Grok Build / OpenCode / Kiro / Trae / Vibe / Qoder / RovoDev / Pi / Hermes / Antigravity 等主流 runtime,几乎每个都有对应 .xxx/skills/impeccable 目录。三件套同日发版(2026-08-26):skill v4.1.2 · cli v3.6.1 · 扩展 v1.3.3;1,656 commits,官网 impeccable.style。

为什么存在

AI 生成前端的「五宗罪」

所有模型都在同一批 SaaS 模板上训练,跳过设计引导就会在每个项目留下同样的「指纹」:

Inter 滥用

什么字体都用 Inter / Arial / system 默认,毫无个性。

紫蓝渐变

purple-to-blue 渐变成了 AI 设计的默认皮肤。

卡片套娃

cards nested in cards,层层嵌套,视觉混乱。

灰字配彩底

gray text on colored backgrounds,对比度灾难。

圆角图标砖

每个标题上方一块 rounded-square icon tile,千篇一律。

+ 纯黑纯灰

用 #000/#fff 不带色调(impeccable 原则:always tint)。

🔥 核心架构

三层设计:上下文 + 命令 + 检测

L1 · 上下文层(一次写入,全局复用) PRODUCT.md + DESIGN.md /impeccable init 写入:受众 / 品牌 or 产品定位 / 声音 / 反参考 / 配色 / 字体 / 组件 L2 · 命令层(与 AI 共享的设计词汇表) 24 个 /impeccable 子命令 craft / shape / critique / audit / polish / bolder / quieter / distill / animate / harden ... L3 · 检测层(确定性,无需 LLM / API key) 59 条规则 + LLM-only critique CLI + 浏览器扩展直接跑 → 抓 Inter 滥用 / 紫蓝渐变 / 卡片套娃 / 灰字彩底
LLM 协作层(需 Agent) 确定性层(零 LLM,可独立运行)
🔥 24 命令全景

与 AI 共享的设计词汇表

创建 · Create

从零搭建

initcraftshapedocumentextract
评估 · Evaluate

审查质量

critiqueauditlive
精修 · Refine

打磨细节

polishbolderquieterdistilldelightoverdrive
强化 · Harden

工程健壮性

hardenonboardclarifyadaptoptimize
专项 · Specific

单一维度

animatecolorizetypesetlayout
快捷 · Pin

/impeccable pin 创建独立快捷方式

pin audit → /audit
核心命令详解

设计生命周期全覆盖

命令阶段做什么
init设置区分 brand(营销/落地/作品集)vs product(App UI/仪表盘/工具),写入设计上下文
shape规划写代码前先规划 UX/UI,避免边写边改
craft构建完整 shape-then-build 流程 + 可视化迭代
critique评估UX 设计评审:层级、清晰度、情感共鸣
audit评估技术质检:a11y、性能、响应式
polish精修终检 + 设计系统对齐 + 发布就绪
live迭代可视化变体模式:浏览器里逐元素迭代
harden强化错误处理、i18n、文本溢出、边界情况

命令可带目标:/impeccable audit blog 审博客页 · /impeccable polish settings 精修设置页 · /impeccable harden checkout 强化结算流程。

🔥 确定性检测

59 条规则:零 LLM 抓「AI 味」

这是与 frontend-design 最关键的差异——确定性规则不依赖模型判断,CLI 和浏览器扩展直接跑,结果稳定可复现。

确定性规则能抓什么
  • 字体滥用:检测 Arial/Inter/system 默认
  • 紫蓝渐变:识别 purple-to-blue 色彩签名
  • 卡片嵌套:cards in cards 结构检测
  • 对比度:灰字配彩底的 WCAD 违规
  • 纯黑纯灰:#000/#fff 无色调告警
  • 过时缓动:bounce/elastic easing 检测
LLM-only critique 补什么
  • 视觉层级:信息优先级是否清晰
  • 情感共鸣:设计是否有「灵魂」
  • 品牌一致性:是否符合 PRODUCT.md 定位
  • 反参考:是否撞了 DESIGN.md 列出的雷区
设计哲学
确定性规则管「不犯错」,LLM critique 管「有品味」。两层结合:先消灭 AI 味,再追求卓越。
工作流

从 init 到 polish 的完整链路

init→ shape→ craft→ critique→ audit→ polish
# 1. 项目根目录安装(自动检测 runtime 文件夹)
npx impeccable install

# 2. AI 工具里初始化(写入 PRODUCT.md + DESIGN.md)
/impeccable init

# 3. 规划 → 构建 → 评审 → 终检
/impeccable shape # 先规划 UX/UI 再写码
/impeccable craft  # shape-then-build 全流程
/impeccable critique # UX 设计评审
/impeccable audit   # a11y / 性能 / 响应式
/impeccable polish  # 终检 + 发布就绪

也可直接描述需求:/impeccable redo this hero section。/impeccable pin <cmd> 把常用命令提升为顶层快捷方式(如 /audit)。

brand vs product

init 的关键分叉

brand 面
营销 / 落地页 / 作品集

设计取向:大胆、情感驱动、视觉冲击。允许更多装饰性元素、动画、强对比。目标是吸引注意力、传达品牌个性。

适用命令:bolder · delight · overdrive

product 面
App UI / 仪表盘 / 工具

设计取向:克制、信息密度、效率优先。强调层级清晰、状态明确、可访问性。目标是让用户高效完成任务。

适用命令:quieter · harden · optimize

这一分叉决定后续所有命令的默认基调——同样是 polish,brand 面会倾向加强视觉,product 面会倾向收敛。这是 impeccable 比 frontend-design 更「懂业务」的关键。

安装生态

14+ Runtime 全覆盖

Claude
.claude/ + hook
Cursor
.cursor/ + hook
Codex
.codex/hooks.json
Gemini
.gemini/
Grok Build
.grok/hooks/
OpenCode
.opencode/
Kiro
.kiro/
Trae
.trae/ + .trae-cn/

还含 Vibe / Qoder / RovoDev / Pi 等。三种安装方式:① npx impeccable install(推荐,自动检测 + hook 清单)② Git submodule 团队托管 ③ 手动 clone。Claude/Cursor/Codex/Copilot/Grok 还会装 provider-native hook 实现自动化。

vs frontend-design

与 Anthropic 原版的差异

维度frontend-designImpeccable
定位首个广泛使用的设计 skill继承衣钵 + 工程化演进
上下文依赖对话内引导PRODUCT.md + DESIGN.md 持久化
命令单一 skill 触发24 个语义化子命令
检测纯 LLM 判断59 条确定性规则(零 LLM)+ LLM critique
brand/product不区分init 分叉,基调自适应
迭代对话轮次live 浏览器可视化变体模式
runtime主要 Claude14+ runtime + hook 自动化
v4.1 重磅更新

对抗式世界轮换:发牌前先自己打一架

v4.1 更新

检测器精度进化:还是 59 条规则,但安静多了

  • 对比度不再假设白底:文字叠渐变、叠图片、被上层元素遮挡的场景,过去按白底猜出大量假阳性——现在测量真实背景,读不出背景就拒绝打分(declines to guess)
  • 作用域 waiver:data-impeccable-ignore 只静默携带它的那个元素,不再一刀切关掉整条规则
  • 误报大扫除:匹配前先剥离注释(含 Astro fence / 预处理行注释 / script 字符串);oklch 正确解析;color-mix() 内嵌 hex 不再误触渐变对比;虚线单向规则不再被当网格背景
  • 根相对样式表解析:链 /styles.css 的页面不再被「裸判」;.. 越界路径拒绝并警告
  • monorepo 支持:嵌套 workspace 各自持有 DESIGN.md,显式 projectRoots 优先,父级设计系统只在真拥有该路径时继承
  • hook 可靠性:Grok Build 恢复工作;Codex Stop hook 按其期望的决策格式输出——设计闸门真正拦截
  • +2 Provider:Hermes Agent、Google Antigravity 开箱即装

官方口径「The same 59 rules, quieter」——规则数不膨胀,误报率下陈才是检测器的进化方向,和 lint 工具成熟路径一致。

在线体验

Playground:AI 味检测器

本地构建的交互式检测器,左边输入 HTML/CSS,右边实时跑 15 条代表性规则,即时标红违规 + 给出 impeccable 命令修法。零 LLM、零 API key,确定性规则直接跑。

🎨 打开 Playground
实时检测

粘贴 HTML 即时跑规则,200ms 防抖,边改边看结果

brand / product 切换

切换基调,规则集自适应——product 面更克制,brand 面更个性

一键示例

内置「典型 AI 味 / 已治愈 / 卡片套娃」三组对比样本

适用场景

适合谁用

风险提示

需要警惕

潜力评估

未来空间

「AI 设计品味」赛道的事实标准候选。68.6k stars 远超原版 frontend-design,确定性检测 + 命令词汇表 + runtime 全覆盖的组合构成强护城河。若 hook 自动化 + 浏览器扩展形成「写完即审」闭环,可能成为 AI 前端开发的 lint 那样的基础设施。


上一个
仓颉.skill
下一个
Awesome LLM Apps
1 / 18