Impeccable 技能:24 個設計指令 + 62 條偵測規則
pbakaus/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 技能包。
