Mindket

Impeccable

新上架第 2 版 · 更新于
星标110k

概览

Paul Bakaus 为编程智能体做的设计技能,有 polish、bolder、critique、audit 等 24 条命令,用来引导和审查界面工作。智能体改代码时,一个基于规则的检测器会标出千篇一律的 AI 设计习惯。

Impeccable 是一款 GitHub 上的开源项目,属于开发类,由 Mindket 上架。可免费获取。当前为第 2 版,最近更新于 。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取,以 zip 压缩包下载。

速览

用在
  • 编程智能体:README 列出了 19 个,其中有 Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、Grok Build、OpenCode 和 Google Antigravity
  • 设计钩子:可在其中六个上运行,即 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build 和 Hermes Agent
  • 终端和 CI:CLI 不用智能体就能扫描一个文件夹或一个渲染出来的页面
  • Chrome:一个扩展能把同样的检查结果叠加显示在任何线上页面上
先运行
npx impeccable install

平台

Claude Code编程智能体
Cursor代码编辑器
Codex编程智能体
GitHub Copilot编程智能体
Gemini CLI编程智能体
OpenCode编程智能体

用在哪里里还有 2 个

关于

它是什么

Impeccable 是 Paul Bakaus 为编程智能体做的设计技能:包含 polish、bolder、critique、audit 等 24 条命令,外加一个专门识别千篇一律 AI 设计的检测器。如果只让智能体做一个页面、不给其他指引,同样的习惯就会冒出来,比如满屏 Inter 字体、紫到蓝的渐变、卡片套卡片。检测器用 62 条确定性规则标出这些习惯,不调用模型,也不需要 API 密钥。README 说,它最擅长处理已经存在的界面。

  1. 运行一次 /impeccable init,写出 PRODUCT.md
  2. 你指定一条命令和一个范围很小的目标
  3. 智能体按这条命令的流程去做
  4. 设计钩子扫描它改动的每个界面文件
  5. 智能体宣布完成之前,发现的问题会先反馈给它

适合谁

前端开发者、会写代码的设计师,以及借助 AI 智能体交付界面的产品团队。在已有产品上持续迭代的团队受益最大,因为 README 说它在这类场景里表现最好。

谁在用,怎么用
行业谁在用怎么用例子
软件产品设计负责人和产品团队先把设计系统写下来,再把界面工作交给照着它做的智能体设计负责人在把界面工作交给智能体之前,先用 /impeccable document 把现有的设计系统记录到 DESIGN.md。
独立与业余项目独立开发者先把产品背景交代一次,之后每次改动都用有名字的命令来引导独立开发者在业余项目上运行 init,让后面的命令知道这个产品是给谁用的。
有 CI 的工程团队每个 pull request 都要审查的团队在 CI 里运行检测器,完全不用智能体团队把检测器加进 GitHub Actions,每个 pull request 都会收到标注。
设计与前端工作室会写代码的设计师在开发服务器上实时试一个区块的几个版本,留下最好的开发者在实时模式里轮流查看首屏主视觉区的几个变体,留下其中一个,选中的版本会写回源码。

如果你从不碰界面代码,它就无事可做。

用在哪里

它能用的地方远不止一个智能体。

  • 编程智能体:README 列出了 19 个,其中有 Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、Grok Build、OpenCode 和 Google Antigravity
  • 设计钩子:可在其中六个上运行,即 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build 和 Hermes Agent
  • 终端和 CI:CLI 不用智能体就能扫描一个文件夹或一个渲染出来的页面
  • Chrome:一个扩展能把同样的检查结果叠加显示在任何线上页面上
  • VS Code:一个扩展为 GitHub Copilot Chat 安装这个技能,但不带设计钩子
  • GitHub Copilot 应用:Impeccable 已经内置,在 Settings 下的 Experimental 里打开

如何设置

点“获取”会把一个 zip 压缩包存进你的下载文件夹,里面是 Mindket 整理的安装说明,列出了 pbakaus 的 README 中每个智能体的步骤。

先准备好这些
需要说明
Node.jsImpeccable 的入门文档要求 18.19 或更高版本,而且只在运行 npx 时才需要
项目根目录安装器要在这里运行
批准钩子Codex 需要在 /hooks 下批准项目钩子,Grok Build 则需要 /hooks-trust,或者用 --trust 启动
Agent SkillsCursor 和 Gemini CLI 可能需要在设置里打开它
  1. 在项目根目录运行安装器。
  2. 选好你的编程工具,再选项目范围或全局范围。
  3. 如果你的工具提供设计钩子,就接受它。
  4. 重新加载编程工具,然后在智能体里运行 /impeccable init;在 Codex 上则运行 $impeccable init。
npx impeccable install

在 Claude Code 里,你也可以改用插件方式添加,再打开 /plugin 安装 Impeccable。

/plugin marketplace add pbakaus/impeccable

以后用一行命令就能更新用 npx 装好的版本。

npx impeccable update

如何使用

指定一条命令和一个目标。目标越小,效果越好,因为仔细审查一个区块,胜过把整个页面扫一眼。

本页提到的命令
命令作用
init写出 PRODUCT.md,让后面的命令知道产品是给谁用的
document把现有的设计系统记录到 DESIGN.md
critique评审界面的某一部分,排出先改什么
audit检查无障碍、性能、主题和响应式表现
polish、bolder、quieter、harden有名字的设计动作,对准一个目标使用,比如设置页或结账流程
pin给常用的命令一个自己的简写
doctor找出过时的上下文文件、没用上的设置和坏掉的钩子
/impeccable critique the onboarding flow
/impeccable quieter the landing page
/impeccable polish settings
/impeccable harden checkout

只输入 /impeccable 会列出所有命令;/impeccable pin audit 之后,你就能直接用 /audit。在终端或 CI 里,检测器不需要智能体。退出码 2 表示发现了问题,1 表示有目标无法扫描。

npx impeccable detect src/
npx impeccable detect --json .
npx impeccable detect --github src/

示例

加好定价区块之后,你让它就这一个组件给出第二意见。

/impeccable critique the pricing cards

智能体按可用性启发式原则给这些卡片打分,并排出修改的先后顺序。改用 audit 则会得到一份技术报告,发现的问题按 P0(阻断)到 P3(打磨)排序。

新手与专家

新手:AI 智能体放任不管时,做出的每个网站往往都是同一种样子。Impeccable 给它一些有名字的设计动作,比如 bolder(更大胆)或 quieter(更克制),还有一个检查器,在它改动时标出那些常见习惯。在一个小项目上运行 /impeccable init,再让它用 critique 评审一个组件。

专家:检测器的规则不调用模型,所以扫描速度快、结果可复现,但只能抓出规则里写到的问题。JSX、TSX 这类源文件只适用模式规则。对比度太低、文字太小,要在渲染出来的页面上才查得出,所以也要让 CLI 扫一遍你的开发服务器。命令会读 PRODUCT.md 和 DESIGN.md,两个文件都有了之后,结果会更好。critique 终究是模型对照启发式原则做出的判断:它是第二意见,不是及格线。

24 条命令按类别统计(来自 README)
引导9
收尾6
规划与设置4
审查2
实时迭代2
已弃用的别名1

注意事项

检查在你自己的电脑上运行,只有少数几次会连到作者的网站。

  • 你的项目:README 说你的项目名、文件、代码和 PRODUCT.md 都不会被发送出去
  • 设计方向:开始一个新设计时,即使关闭了遥测,技能也会从 impeccable.style 目录获取视觉方向
  • 版本检查:通常一天最多一次,向 impeccable.style 询问有没有新版本,不带任何项目内容;设置 IMPECCABLE_NO_UPDATE_CHECK=1 可以关掉
  • Claude Code 里的钩子:即使你拒绝了模型自己的命令,已安装的钩子仍会运行;第一次改动时还可能把一个引擎二进制文件下载到 ~/.impeccable/bin/
  • 实时模式:只改本地检出的代码;应用它的文案改动时,会以你的权限运行 package.json 里的 impeccable:manual-edit-validate 脚本
  • 工作文件:放在 .impeccable/ 下
  • 来历:Impeccable 最初基于 Anthropic 的 frontend-design 技能,但它是 Paul Bakaus 的项目
  • 许可证:Apache 2.0

用下面这行命令关闭遥测,只会停止匿名记录你选了哪个方向。DO_NOT_TRACK=1 和 IMPECCABLE_NO_TELEMETRY=1 的作用相同。

npx impeccable telemetry off

README 和文件

README
# Impeccable:安装说明

这个工具包里是 Mindket 写的安装说明,不含 Impeccable 本身。技能、插件和钩子要从 Paul Bakaus 的仓库 pbakaus/impeccable 安装,地址是 https://github.com/pbakaus/impeccable

许可证:Apache-2.0,依据是仓库的 LICENSE 文件,见 https://github.com/pbakaus/impeccable/blob/HEAD/LICENSE

这些说明里的命令原样取自仓库的 README 和入门页面,分别见 https://github.com/pbakaus/impeccable#installation 和 https://impeccable.style/tutorials/getting-started

## 安装的内容

- 一个技能 impeccable,有 polish、bolder、critique、audit 等 24 条命令。
- 一个可选的设计钩子,扫描智能体改动的界面文件。README 列出它支持 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build 和 Hermes Agent。
- 子智能体。README 提到,手动复制安装会漏掉它们和设计钩子。
- 一个自带全部依赖的引擎二进制文件,随技能附带,或者一次性下载到 ~/.impeccable/bin/。

## 开始之前

Node.js 18.19 或更高版本。只有 npx 需要 Node。

## 为任一支持的智能体安装

在项目根目录运行:

```
npx impeccable install
```

按提示选择你的工具,以及项目级或全局范围,接受设计钩子,然后重新加载工具。用脚本安装时,安装器接受 --providers=claude,codex,cursor 和 --scope=project|global 参数。

然后在智能体的对话里输入:

```
/impeccable init
```

各智能体的说明在 setup 文件夹里:claude-code.md、codex.md、cursor.md、github-copilot.md、gemini-cli.md 和 grok-build.md。

## 更新

```
npx impeccable update
```

通过插件市场或插件方式安装的,从工具的插件菜单更新。更新后重新加载工具。

## 卸载

README 和文档都没有说明怎么卸载 Impeccable。

## 遥测

```
npx impeccable telemetry off
```

设置 DO_NOT_TRACK=1 或 IMPECCABLE_NO_TELEMETRY=1 也能关闭遥测。在 .impeccable/config.json 里写入 "telemetry": false 也一样。开始新设计时,技能仍会从 impeccable.style 目录获取视觉方向。另外,Impeccable 会访问 impeccable.style/api/version 检查有没有新版本,通常每天最多一次,不发送任何项目内容。设置 IMPECCABLE_NO_UPDATE_CHECK=1 可以关掉这项检查。详情见 https://impeccable.style/privacy

## 钩子与故障排查

README 提醒:在 Claude Code 里,即使你拒绝了模型自己的命令,已安装的命令钩子仍会运行。它建议在无人值守运行之前先检查已装的钩子,或者在某次运行时传入这个参数,把钩子关掉:

```
--settings '{"disableAllHooks": true}'
```

/impeccable doctor 能找出过期的上下文文件、没用到的设置和失效的钩子。
文件
README.md  3 KB
setup/claude-code.md  1 KB
setup/codex.md  994 B
setup/cursor.md  1 KB
setup/gemini-cli.md  826 B
setup/github-copilot.md  1 KB
setup/grok-build.md  756 B

7 个文件,共 9 KB,以 zip 压缩包下载。

更新内容

  • 第 2 版 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • 第 1 版 · 2026-11-03

评价

还没有评分

写评价

还没有评价。

大家怎么说

Hacker News、Bluesky、X、Reddit、Facebook 和 YouTube 上提到这个项目的帖子和评论,来自每周一次的搜索和 Trendshift。它们不是 Mindket 写的,也未经核实,点开即可在原帖处阅读。

Wpnx330Ask HN: How can you tell a site/app is vibe coded?I've been using two open-source tools to prevent, and then check this on my own sites / projects. They are actually pretty good at spotting and they are community driven so they get updates regularly. 1. Impeccable (github.com/pbakaus/impeccable) — a CLI that scans HTML/CSS/JSX for 59…midudev · Miguel Ángel Durán¡Esta skill te ayuda a evitar diseños IA Slop! Se llama Impeccable y revisa layout, usabilidad, contraste y accesibilidad y mucho más Le da al agente de código el vocabulario de diseño para auditar, criticar y mejorar tus diseños → github.com/pbakaus/impe...6 赞 · 1 条回复Edy | Indie Builderpbakaus/impeccable (+2,300 stars today) gives coding AIs a design vocabulary to fight the "AI look": purple-blue gradients, cards in cards. Commands like bolder, quieter, polish, a critique pass, and 62 fixed rules that run in CLI or CI. github.com/pbakaus/impe... #buildinpublic4 赞 · 1 条回复GitHub Trending Rust💎 Hidden Gem! 💎 (1000+ new stars) 📦 pbakaus / impeccable ⭐ 103,396 (+1,383) 🗒 Rust The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.3 赞 · 1 条回复@fenju.bsky.socialToday's GitHub Trending signals a shift: agents must go from "can it work?" to "can it work well, with standards?" pbakaus/impeccable & obra/superpowers prove devs want engineering-grade specs, not improvisation. Same for multimodal: speech, OCR, translation, proofreading shouldn't be prompt-enginee3 赞 · 1 条回复GitHub Trending Rust💎 Hidden Gem! 💎 (1000+ new stars) 📦 pbakaus / impeccable ⭐ 89,866 (+1,458) 🗒 Rust The design language that makes your AI harness better at design.1 赞 · 1 条回复Obi RyderWhat happens when you ask your coding agent to make a page quieter? Sky shows a before-and-after from Impeccable by Paul Bakaus. What would you change first? github.com/pbakaus/impeccable AI-generated presenter. repoquarry.dev/projects/imp...1 赞Alexis KirkeI came across this impressive open-source project on GitHub: design QA for coding agents. See link below. #opensource #github #design #ai https://github.com/pbakaus/impeccable1 赞🚀 olud.ai📈 Also gaining ground: ⭐ pbakaus/impeccable +4,059 stars (total 99.3k) « The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, cat… » https://olud.ai/project/pbakaus-impeccable.html #OpenSource #AI #GitHub1 赞GitHub Trending Rust💎 Hidden Gem! 💎 (1000+ new stars) 📦 pbakaus / impeccable ⭐ 97,786 (+1,339) 🗒 Rust The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.1 条回复GitHub Trending📈 Today's GitHub Trending: 1. https://github.com/HKUDS/DeepTutor - Python, 1926 stars today 2. https://github.com/obra/superpowers - Shell, 1037 stars today 3. https://github.com/pbakaus/impeccable - Rust, 2881 stars today 4. https://github.com/JetBrains/thinkrail - TypeScript, 1116 stars today […]1 赞DYFor your next AI-built portfolio, give your coding AI this brief: "On [page], clarify my offer for [client] and the next action. Keep real work + working forms. Show before/after + changes." Impeccable: critique/polish for existing pages. github.com/pbakaus/impe...

搜索日期

Mindket 的更多商品

查看 Mindket 的全部商品

DeepSeek-R1-GGUF

unsloth · 工具包

671B 参数 DeepSeek-R1 推理模型的 GGUF 版本,带 1.58-bit 和 2-bit 动态量化,可在内存足够的本机上用 llama.cpp 运行。

新上架

Axion-1.0-35B-GGUF

prithivMLmods · 工具包

提供 Axion-1.0-35B 的 GGUF 文件,这是一个有约 30 亿激活参数的 35B 混合专家模型,面向科学推理、信息查找和工具使用。适合配合 llama.cpp 在本地使用。

新上架

HEART

Phips · 工具包

用一个超分辨率网络放大低分辨率图像,可以在一块消费级 GPU 上训练,并导出为 ONNX。适合训练或运行图像放大模型的人。

新上架

REA: Reverse Engineer Anything

morluto · MCP 服务器

精选

morluto 做的 MCP 服务器和 CLI,让你的编程智能体在你自己的电脑上研究二进制文件、桌面和 Android 应用、网站和固件,并为每条发现附上证据。

新上架458k

Taste Skill

Leonxlnx · 技能

Leonxlnx 做的 Agent Skill,给 Claude Code 和 Codex 一套美术方向和开放图库里的图片,并让它们在真实浏览器里检查效果。这样它们做出的网站和应用界面,就不再像千篇一律的 AI 页面。

新上架115k

Huashu Design

alchaincyf · 技能

把你在 AI 智能体里写的一句话需求,变成一份完成的设计:发布动画、可点击的应用原型、可编辑的幻灯片、信息图,或一组小红书图片。可在多种智能体中使用。

新上架29.4k