GitHub 热榜实测｜Impeccable：专治AI量产脸

GitHub 热榜实测｜Impeccable：专治AI量产脸

让 AI coding agent 画一页 UI，你大概率收获一套 Inter 字体、紫蓝渐变、卡片套卡片、圆角图标方块——换个模型、换个项目，套路照旧。Impeccable 用 62 条确定性规则（不依赖 LLM、不需要 API key）专治这种"AI 量产脸"，本周单周新增 12031 star，总数 99045。

项目为什么火

README 把痛点写得很直白：你只说"给我做个页面"，agent 就会输出 cream 底色、细体衬线大标题、斜体强调、药丸按钮——跨模型、跨项目反复出现同一套"安全审美"。

Impeccable 的定位不是再给 agent 加一轮 prompt，而是给 agent 装一套设计词汇表：

• 定向指令：/impeccable bolder the pricing cards 会加载针对"让某块更出挑"这一个动作的 playbook，而不是泛泛地说"好看点"。
• 结构化审查：critique 按可用性启发式打分并排出修复优先级；audit 检查无障碍、性能、主题、响应式，发现项按 P0（阻断）到 P3（打磨）分级。
• 62 条确定性规则：专门抓"紫蓝渐变""卡片套卡片""圆角图标方块"等 AI 量产特征，以及 cramped padding、跳级标题等质量问题。纯规则引擎，不走 LLM。

支持 Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Gemini CLI 等 18+ 个 agent 工具，装一次即可跨工具复用。

实测过程

按时间线走一遍：

第一步：克隆仓库

$ git clone --depth 1 https://github.com/pbakaus/impeccable
exit=0
Cloning into '/tmp/ght-smoke/pbakaus__impeccable'...

干净利落，无异常。

第二步：安装 skill

$ npx impeccable install
exit=0
ject (/private/tmp/ght-smoke/pbakaus__impeccable) or global (~)? [project] Impeccable skills are already installed (found in .claude/).
Could not check for skill updates: Could not download skill bundle: https://github.com/pbakaus/impeccable/releases/download/skill-v4.8.0/universal.zip.sig.json: Connection Failed: Connect error: connection timed out
Existing skills were left unchanged.
Run with --force to reinstall.

这一步出了幺蛾子：它检测到 .claude/ 目录下已有 skill 文件，尝试拉取 v4.8.0 的更新包签名文件时连接超时，最终选择保留本地旧版 skill、不做覆盖。不是报错阻断，而是"安全回退"。如果你确实想强制重装，加 --force 即可。

执行环境还顺手暴露了一条 shell 配置问题（/Users/aresen/.bash_profile: line 9: alias: -alF: not found），与项目本身无关，属于本机 bash_profile 写法错误，不影响后续流程。

整体结论：clone 顺利，install 在已有环境走的是"检测→尝试更新→超时→保留旧版"的安全路径，没有卡死。

踩坑记录

本次未获取到官方 issue 区数据，以下坑全部来自真机执行记录：

现象	来源	处理
下载 skill bundle 签名文件超时（universal.zip.sig.json Connection Failed）	npx impeccable install 输出	自动保留本地已有 skill；如需强刷加 --force
安装脚本提示 "or global (~)?" 时默认选了 [project] 级别	同上	若希望全局生效，交互时选 global 或加对应参数

官方 issue 区暂无高频问题记录。

使用说明

从项目根目录开始，两步完成接入：

npx impeccable install

安装完毕后重载你的 coding 工具，然后在 agent 对话中运行：

/impeccable init

如果用 Codex CLI，对应命令是 $impeccable init。

装好之后，日常用法就是给 agent 下达带 impeccable 关键词的指令：

• /impeccable polish — 整体打磨
• /impeccable bolder — 让指定区域更出挑
• /impeccable critique — 按可用性启发式打分、排修复优先级
• /impeccable audit — 检查无障碍 / 性能 / 主题 / 响应式，P0–P3 分级

完整文档在 impeccable.style/docs。

总结

该用： 你日常用 Claude Code / Cursor / Copilot 等 agent 写前端页面、落地页、组件，且受够了"每次出来都像 AI 画的"。装一次 skill，之后每次让 agent 出 UI 时多带一句 /impeccable polish 或 /impeccable audit，成本极低，收益是设计一致性。

不该用： 纯后端、CLI 工具、不碰 UI 的开发者；或者你已经有一套非常成熟的设计系统且 agent 严格遵守的团队——额外套一层审查流程反而是摩擦。

---

本周共跟踪 7 个 GitHub 热榜项目，后续每天发布一篇真机实测。关注我，跟着热榜项目练手，下一篇继续实测。

你平时让 agent 写页面时，是更痛"审美单一"还是"功能跑不通"？选一个，评论区打 1 或 2。

---

做自动化这几年，最耗时间的从来不是写代码，是摸清每个平台的脾气。

这篇里提到的坑，都是真金白银踩出来的。
这篇里的场景你踩过类似的吗？是卡在「需求说不清」还是「改完就崩」？
评论区说说，我按最多人卡的点接着写。