Impeccable 技能:24 个设计命令 + 62 条检测规则
pbakaus/impeccable 给编码代理一套设计词表:/impeccable 加 24 个命令,62 条确定性检测规则(hook、CLI、Chrome 扩展三种跑法),Claude Code 与 DeepSeek Harness 的安装命令,以及去掉引擎二进制的 dsh 社区移植版。
最近更新: 2026-11-19
先说结论
impeccable 是给编码代理用的设计技能:一套告诉代理「我要哪种设计动作」的命令词表,加一个能点名 AI 味界面的检测器。仓库简介只有一句:「The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, and catch AI slop before it ships.」
大家装的东西由三块组成:
/impeccable主命令。单独打它就列出命令表。- 它后面 24 个命令:23 个具名剧本,加上
craft——README 原文说它是「a deprecated alias for a plain build request」。 - 检测器里的 62 条确定性规则——README 原文「No LLM, no API key」。
作者 Paul Bakaus,许可 Apache-2.0,README 里写明它「started from Anthropic's frontend-design skill」。按 2026-11-19 的 GitHub API 快照:112,991 stars、6,730 forks,建于 2025-11-16,最后一次 push 是 2026-11-18。这些是快照数字,不是固定值。
下面内容都在 2026-11-19 读过,命令逐字抄自 README 和移植版文件。如果你要的是「把一屏界面重做一遍」而不是一套命令词表,unslop 技能更对口。
24 个命令
README 的表格标题就是「### 24 commands」,按你要做的事分组。命令名逐字照抄:
| 分组 | 命令 |
|---|---|
| Steer | bolder、quieter、distill、colorize、typeset、layout、animate、delight、overdrive |
| Review | critique(打分式 UX 评审)、audit(技术质量报告) |
| Finish | polish、harden、clarify、adapt、optimize、onboard |
| Iterate live | live、generate |
| Plan and set up | shape、init、document、extract |
加起来 23 个具名剧本。第 24 个在下一行:README 原文「The 24th, craft, is a deprecated alias for a plain build request.」每个命令都有自己的文档页:impeccable.style/docs。
最该先跑的是两个建上下文的命令,因为其他命令都读它们的产物。init 写 PRODUCT.md——README 说它「reads your code, asks only what it can't infer (who the product is for, what it needs to do, the constraints)」;document 把你现有的视觉体系写进 DESIGN.md,好让后续改动「stay on-brand」。工作文件都落在项目的 .impeccable/ 下。
命令要带目标,目标越窄效果越好:/impeccable critique the onboarding flow、/impeccable quieter the landing page、/impeccable polish settings、/impeccable harden checkout。在 Codex 上不敲斜杠命令,用 /skills 或 $impeccable。/impeccable pin audit 能给常用命令配一个 /audit 快捷方式——README 有这条,而 dsh 移植版把它去掉了(见下文)。
live 是浏览器里的循环:README 说它「opens your running dev server with an overlay. Select an element, pick a direction, and Impeccable hot-swaps variants in place」,支持 Vite、Next、SvelteKit、Astro、Nuxt 和纯 HTML,且只改本地 checkout。
检测器:62 条规则,三种跑法
README 的原话:「A slop detector. 62 deterministic rules flag the tells above, plus quality problems like cramped padding and skipped headings. No LLM, no API key.」slop 页的口径一致:「The catalog includes 62 detector rules and 6 patterns for design review.」
**在代理里。**design hook 会「scans every UI file your agent edits and hands the findings back before the agent calls the work done」。覆盖范围 README 写得很明确:「It's available on Claude Code, Cursor, Codex, GitHub Copilot, Grok Build, and Hermes Agent, and the installer sets it up.」这份名单里没有 dsh——见下面 DeepSeek Harness 那节。
**在终端或 CI 里。**CLI 不需要代理:
npx impeccable detect src/ # 扫目录
npx impeccable detect https://example.com # 扫渲染后的页面(用你本机的 Chrome 或 Edge)
npx impeccable detect --json . # 机器可读输出
npx impeccable detect --github src/ # 生成 GitHub Actions 注解
npx impeccable detect --sarif src/ # SARIF 2.1.0,给 code scanning 用
npx impeccable detect --list-rules # 列出每条规则的 id 和说明
npx impeccable detect --report-unused-ignores src/ # 找出没豁免任何东西的内联 ignore
JSX/TSX 这类源码文件只跑 pattern 规则;需要渲染页面才能判断的规则(低对比、字号过小)要在扫 URL 时才跑,所以也把 CLI 指向你的 dev server:npx impeccable detect http://localhost:5173。
退出码 0 表示干净,2 表示有 findings,1 表示有目标扫不了。规则 id 是你后面打交道的抓手——检测器文档里拿来当 finding 示例的是 overused-font 和 gradient-text。两种放过它的写法:
npx impeccable ignores add-value overused-font Inter --reason "Brand font"
<!-- impeccable-disable overused-font: exported brand doc -->
第一条是全局允许某个品牌字体,第二条是单文件关掉某条规则。
在浏览器里。Chrome 扩展把同样的结果叠在任意线上页面,你自己的或别人的都行。
安装
在项目根目录:
npx impeccable install
安装器识别本机编码工具、问项目级还是全局、并在工具支持时提供 design hook。已装过的用 npx impeccable update 刷新。写脚本时传 --providers=claude,codex,cursor 和 --scope=project|global。
按 README,三个工具的 hook 还要各走一步:Codex 里打开 /hooks 批准项目 hook(更新改到 hook 后要再批一次);Grok Build 跑 /hooks-trust 或用 --trust 启动;Hermes Agent 跑一次 hermes plugins enable impeccable-design-hook。
Claude Code 还有插件路线:/plugin marketplace add pbakaus/impeccable,再打开 /plugin 安装 Impeccable。装完重载工具,在代理里跑 /impeccable init(Codex 上是 $impeccable init)。团队想钉版本可以走子模块:git submodule add 这个仓库,再跑 npx impeccable link --source=vendor/impeccable --providers=claude,cursor——link 只装技能,不装 hook。
没有 Node 也行——README 给了手动复制表,DeepSeek Harness 就在表里:
| 工具 | 仓库目录 | 全局技能目录 |
|---|---|---|
| DeepSeek Harness | .dsh/ | ${DSH_HOME:-$HOME/.dsh}/skills/ |
也就是把 skills/impeccable 复制到项目的 .dsh/skills/,或者复制进全局目录。上游仓库的 main 分支里确实提交了 .dsh/skills/impeccable/(SKILL.md、reference/ 下 50 个 markdown、以及装着启动器和 live-browser-*.js、字体索引的 scripts/),复制的是这个。
同一张表还有一条对 dsh 很关键的注记:「impeccable install and update manage a DeepSeek Harness global copy only when DSH_HOME is inside your home directory.」如果你的 DSH_HOME 指在别处,全局那份得自己复制。
Node 只是给 npx 用的。技能本身跑的是「a self-contained engine binary that ships next to it or downloads once into ~/.impeccable/bin/」——正因如此手动复制不算完整安装:「A manual copy skips the design hook and subagents.」
和 DeepSeek Harness 一起用
下面两条要一起读,dsh 的情况就是这两条:
- **DeepSeek Harness 在官方支持列表里。**README 的支持列表逐字是:「Works with Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness, and Veto.」手动复制表有 dsh 这一行,仓库里也提交了
.dsh/skills/impeccable/。 - **编辑后自动检测的 hook 在 dsh 上不可用。**hook 只覆盖 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build、Hermes Agent。dsh 上检测是你自己敲的命令:
npx impeccable detect src/,或者指向 dev server 以覆盖需要渲染页面的规则。
这就是「支持」和「全接通」的实际差别:命令、参考文件、上下文文件(PRODUCT.md、DESIGN.md)都一样能用;每次改完自动兜底的那层没有。手动装的话,安装技能实战讲 .dsh/skills/ 的目录结构,什么是技能讲这次复制依赖的文件夹形状。
dsh 社区移植版
因为上游技能要一个引擎二进制,有人把它做成了 dsh 原生版:kechao-sgp/dsh-impeccable-skill。这是社区移植,不是上游发布也不是 DeepSeek 官方——它的 NOTICE 写明「not published, endorsed, or supported by the upstream author」。
按仓库实际情况:
- 注册一个随包离线的
impeccable技能。index.js只读一次包内skill/SKILL.md然后注册(source: bundled),只用 Node 内置模块:不写文件、不跑子进程、不注册工具或斜杠命令;package.json声明dsh.capabilities: ["fs:read"]。 - **README 剧本表 23 条,技能内命令表 24 条。**README 的表按规划、评审、打磨、强化、修复、迭代分组,加起来 23 个具名剧本;技能自己的命令表把
craft也列上(原文「Deprecated alias for an ordinary new-work request」),这才凑成 24。skill/reference/下 46 个.md(其中degraded/4 个、*.native.md2 个、mode-*.md3 个),另有craft-floor.md、new-work.md、region-map.md、routing.md、dsh-runtime.md。 - **不打包引擎二进制。**README 原话:「本移植版不打包该二进制:来源不可审计、体积与本插件定位不符。」替代方案是
skill/reference/dsh-runtime.md,把每个引擎命令映射成 dsh 原生动作:impeccable context→ 直接读PRODUCT.md/DESIGN.md/.impeccable/;detect→ 手工遍历(craft-floor 禁令 +grep+ 逐条读上下文);generate-image→ dsh 原生generate_image;截图 →playwright技能、已提交的视觉基准或用户截图;comp-spec→ 读图后手写regions.json,尺寸标为估算;font-match→ 目测取最接近的可得字体并声明估算;live→ 落成静态变体文件加截图让用户挑;钩子 → 无。 - 三处明写的降级。
SKILL.md有「Edition limits」一节:Pin/Unpin 不可用;hooks 不跑,所以它自己改完 UI 后要手工跑一遍反模式检查并说明;Doctor 没有自动修复,按doctor.md手工走清单。 - **三条安装路径。**从仓库装(包声明了
dsh.bundle,把仓库地址填进插件管理)——README 标注「当前可用」;本机目录装,用于开发调试;市场安装——README 标注「待收录」。npm 包dsh-impeccable-skill尚未发布:2026-11-19 访问https://registry.npmjs.org/dsh-impeccable-skill返回 HTTP 404,与 README 一致。 - **同名冲突。**npm 上另有 Cassius0924 发布的
dsh-impeccable(最新 0.1.2,2026-10-31 发布,自称 23 个设计剧本),带客户端工作台和检测器。移植版 README 提醒两者注册同名技能:「两者都注册同名技能impeccable,不要同时安装(同层同名先到先得,后装的不生效)。」
许可:技能正文与 skill/reference/ 来自 pbakaus/impeccable(Apache-2.0);reference/ios.md、reference/android.md 源自 ehmo/platform-design-skills(MIT)。移植版打包的上游技能是 4.8.0,「re-checked against the repository on 2026-11-07」;而 2026-11-19 读上游自己的 .dsh SKILL.md 时是 version: 4.10.0——也就是说移植版的内容落后于上游当前版本。
目录侧的事实,决定你能在本站看到什么:kechao-sgp/dsh-impeccable-skill 已收录进本站目录,归类在生态与资源,2026-11-19 快照为 0 stars、0 forks,建于并最后 push 于 2026-11-07。它目前还没有独立详情页,所以入口是目录搜索「impeccable」。同批命中里 zc7hyz/dsh-taste 在自己的 README 里把它的扫描器写成「25 条设计方法论 + 61 条确定性反模式扫描器」——那是那个项目对自家工具的自述口径,不是上游的 62 条。
Impeccable 和 unslop 的分工
两个都是设计技能,但不能互相替代。简单分法:
- Impeccable 是命令词表 + 检测器 + 上下文文件:24 个命令给代理指方向,62 条规则检查结果,
PRODUCT.md和DESIGN.md让它在多次会话之间保持同一套审美。它最强的场景是已经存在的界面——README 说「point it at a page or a component and iterate」。 - unslop 技能 是一屏界面的单一剧本:先列出 slop,再从你的产品里定一个方向,然后按固定顺序一轮一轮改,还能录一段短视频。
想要可复用的命令词和能进 CI 的检测器,用 Impeccable;想把一个 vibecoded 页面从头改一遍,用 unslop。两者可以共存(名字不同、技能不同),但同一次会话里对同一屏都跑一遍,多半是重复劳动。更全的选型看最值得装的 dsh 技能和 pstack 技能包。
什么情况下它不合适
- **你要改的是文案,不是界面。**Impeccable 有
clarify处理界面里不清楚的文案,但把整篇文字去 AI 味是另一件事,看 humanizer 技能。 - 你要的是安全或正确性审计。
audit是设计质量报告:可访问性、性能、主题、响应式。它不是代码审计。 - **你在 dsh 上等 hook 自动跑。**dsh 上它不会自己触发。要么留出跑
npx impeccable detect的时间,要么接受改完没人检查。 - **你根本跑不了引擎二进制。**上游技能依赖它;手动复制只给你技能、没有 hook 和子代理;社区移植给的是剧本正文加手工替代方案,没有引擎的测量能力。
- **你需要像素级精确测量。**移植版里
comp-spec和font-match降级成明确标注的估算。要精确数字,这不是那个工具。
FAQ
Impeccable 技能是做什么的?
它是给编码代理用的设计技能,作者 Paul Bakaus,许可 Apache-2.0。仓库自称「the design vocabulary for your coding agent」:一个 /impeccable 主命令,后面挂 24 个命令(23 个具名剧本,外加 craft——它被标为普通建站请求的废弃别名),再加一套 62 条确定性规则的 slop 检测器,不用 LLM、不要 API key。
在 Claude Code 里怎么装?
在项目根目录跑 npx impeccable install。安装器会识别你本机的编码工具、问你是装到当前项目还是全局,并提示要不要装 design hook。也可以走插件:/plugin marketplace add pbakaus/impeccable,再打开 /plugin 安装 Impeccable。重载工具后在代理里跑 /impeccable init。已装过的用 npx impeccable update 刷新。
DeepSeek Harness 能用吗?
能。README 的支持列表里有 DeepSeek Harness,手动复制表也给了 dsh 两行:仓库内 .dsh/,全局 ${DSH_HOME:-$HOME/.dsh}/skills/。不能用的是编辑后自动检测的 hook——它只覆盖 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build、Hermes Agent,dsh 不在其中,所以 dsh 上要自己跑 npx impeccable detect。
62 条规则怎么跑?
三种跑法。代理内:design hook 扫它改过的每个 UI 文件。终端或 CI:npx impeccable detect src/ 扫目录,npx impeccable detect https://example.com 扫渲染后的页面,--json、--github、--sarif、--list-rules、--report-unused-ignores 换输出格式。浏览器:Chrome 扩展把同样的结果叠在任意线上页面。退出码 0 表示干净,2 表示有 findings,1 表示有目标扫不了。
有 DeepSeek Harness 的移植版吗?
有,社区的:kechao-sgp/dsh-impeccable-skill 把剧本和 46 个参考文件打成随包离线可用的 impeccable 技能,不打包引擎二进制,另附 dsh-runtime.md 把每个引擎命令映射成 dsh 原生动作。它是 Apache-2.0,非上游官方也非 dsh 官方;2026-11-19 快照是 0 stars、0 forks;npm 包没发布——registry 返回 404。它和另一个 dsh-impeccable 注册同名技能,不要同时装。
Sources
以下每一条都在 2026-11-19 读过:
- github.com/pbakaus/impeccable — README:那句简介、含 DeepSeek Harness 的支持列表、「### 24 commands」表格与
craft废弃别名、62 条检测规则那句、hook 覆盖名单与三个工具的额外批准步骤、七条detect命令、退出码、ignores与impeccable-disable两种写法、install/update与--providers、--scope、Claude Code 的/plugin marketplace add路线、子模块路线、手动复制表里.dsh/与${DSH_HOME:-$HOME/.dsh}/skills/两行、DSH_HOME注记、「Node is only needed fornpx」与~/.impeccable/bin/说明、「manual copy skips the design hook and subagents」、live 模式说明、.impeccable/项目文件,以及许可原文(「Apache 2.0. See LICENSE. Impeccable started from Anthropic's frontend-design skill.」)。2026-11-19 读仓库树:.dsh/skills/impeccable/下有SKILL.md(version: 4.10.0)、reference/50 个 markdown,以及装着启动器、live-browser-*.js和字体索引的scripts/。2026-11-19 抓的 GitHub API 快照:Apache-2.0、112,991 stars、6,730 forks、created 2025-11-16、pushed 2026-11-18(快照,不是固定值)。 - impeccable.style/slop —「The catalog includes 62 detector rules and 6 patterns for design review.」
- impeccable.style/docs/detector — 退出码表(0 / 2 / 1)、
overused-font与gradient-text两个 finding 示例,以及豁免示例里用到的规则 id。 - github.com/kechao-sgp/dsh-impeccable-skill — README、
NOTICE.md、skill/SKILL.md与index.js:注册的impeccable技能与index.js行为、README 的 23 条剧本表与技能命令表里的craft行、dsh-runtime.md的命令映射、「Edition limits」、三条安装路径、与dsh-impeccable的同名冲突、Apache-2.0 / MIT 来源拆分、打包的上游 4.8.0,以及「not published, endorsed, or supported」那句。2026-11-19 读仓库树:skill/reference/下 46 个.md(degraded/4 个、*.native.md2 个、mode-*.md3 个)。2026-11-19 GitHub API 快照:Apache-2.0、0 stars、0 forks、created 2026-11-07、pushed 2026-11-07。 - registry.npmjs.org/dsh-impeccable-skill — 2026-11-19 返回 HTTP 404,与 README 的「npm 包
dsh-impeccable-skill尚未发布」一致。 - registry.npmjs.org/dsh-impeccable — 另一个 Cassius0924 的包:最新 0.1.2,2026-10-31 发布。
Impeccable 是 Paul Bakaus 的开源项目,dsh 移植版是社区包;两者都不是 DeepSeek 的产品,也与本站无关。命令取自上述日期的 README——这个仓库在本文核对前一天还有 push,动手前再核一遍。
相关阅读:unslop 技能、安装技能、什么是技能、最值得装的 dsh 技能、pstack 技能包。
