Impeccable 是什麼、怎麼安裝使用：Paul Bakaus 的前端設計 Skill（/impeccable 24 個命令 + 設計檢測器）

本文根據 pbakaus/impeccable 倉庫 README、官網 impeccable.style 與 Claude Code 官方文檔整理，資料核對於 2026-10-10。命令數量和支持的工具以倉庫 README 為準。

是什麼

Impeccable 是 Paul Bakaus 維護的一套給 AI 編程智能體用的設計指導。README 說它的起點是 Anthropic 官方的 frontend-design 技能，在此之上補了三樣東西：一個記錄產品背景的初始化流程、一組和 AI 溝通設計意圖的命令、以及一個不調用大模型就能跑的設計問題檢測器。

它要解決的問題很具體：各家模型學的都是同一批 SaaS 模板，不加約束就會反覆出現同樣的痕跡——全站 Inter 字體、紫藍漸變、卡片套卡片、彩色底上放灰字。Impeccable 把這些寫成明確的「不要這樣做」，並給出可執行的檢查規則。

截至 2026-10-10，GitHub 顯示該倉庫約 7.9 萬 Star、4704 Fork，最近一次推送在 2026-10-09。

包含哪些 Skill

倉庫只有一個技能 impeccable，所有功能通過 /impeccable <command> <target>（命令加目標） 調用。README 列出 24 個命令，按用途大致分為：

• 起步與規劃：init（一次性設定，寫出 PRODUCT.md）、shape（寫代碼前先規劃 UX/UI）、craft（規劃加實現的完整流程）、document（從現有代碼生成 DESIGN.md）、extract（把可複用的組件和設計變量抽出來）；
• 評審：critique（層級、清晰度等設計評審）、audit（無障礙、性能、響應式等技術檢查）；
• 調整方向：bolder、quieter、distill、delight、overdrive；
• 專項修整：typeset（字體）、layout（佈局與間距）、colorize（配色）、animate（動效）、clarify（介面文案）、adapt（多裝置適配）、harden（錯誤處理、國際化、文字溢出）、onboard（首次使用與空狀態）、optimize（性能）、polish（上線前收尾）；
• 瀏覽器內迭代：live、generate，在本地開發頁面上直接生成和挑選介面變體。

另外有一個獨立命令行檢測器，README 稱它包含 59 條確定性規則，不需要大模型和 API Key。

怎麼安裝

命令行安裝器（README 推薦），在項目根目錄運行：

bash
npx impeccable install

它會檢測本機已有的工具目錄（如 ~/.claude、~/.codex、項目裏的 .cursor），讓你選擇裝給哪些工具、裝到當前項目還是全局。之後更新用 npx impeccable update。

Claude Code 插件市場：

text
/plugin marketplace add pbakaus/impeccable

登記市場後，打開 /plugin 從列表裏安裝 Impeccable。

GitHub Copilot（VS Code）：code --install-extension renaissance-geek.impeccable。README 還提供 Git 子模組方式、官網 ZIP 下載和從倉庫 dist/ 目錄手動複製幾種做法，適合想把版本固定在倉庫裏的團隊。

怎麼用

• 新項目先運行 /impeccable init，它會查看項目並只追問缺失的產品資訊，結果寫進 PRODUCT.md，後續命令都以此為背景。
• 日常用法是「命令 + 範圍」，例如 /impeccable audit the header、/impeccable polish the checkout form；也可以直接描述，如 /impeccable redo this hero section。只輸入 /impeccable 會列出全部命令。
• 常用命令可以固定成快捷方式：/impeccable pin audit 之後就能直接用 /audit。
• Codex 裏通過 /skills 或輸入 $impeccable 調用，README 寫明項目級技能在 .agents/skills/、用戶級在 ~/.agents/skills/，與 Codex 官方文檔一致。
• 不用智能體也能單獨跑檢測：npx impeccable detect src/ 掃描目錄，npx impeccable detect --json . 輸出適合 CI 的 JSON。

適合誰 / 不適合誰

適合：

• 用 AI 寫前端、希望有一套固定「設計口令」反覆打磨介面的開發者；
• 想在 CI 或提交前自動攔住常見設計問題的團隊；
• 同時使用多種編程智能體、需要統一設計規範的項目。

不適合：

• 對自動執行的 hook 比較謹慎、又沒時間審查它的環境；
• 只做後端或命令行工具的項目；
• 只用 claude.ai 網頁版的用戶——README 的安裝方式都面向本地編程工具。

注意事項

• 許可證：倉庫 LICENSE 為 Apache-2.0。
• 維護狀態：更新活躍，最近一次推送 2026-10-09。
• 安全提醒（這個倉庫要特別留意）：
• 安裝器在 Claude Code、Cursor、Codex、GitHub Copilot 等工具上會一併安裝 hook，在你編輯介面文件後自動運行檢測；安裝時可以選擇不裝，或加 --no-hooks 跳過。
• 技能自帶啟動腳本，首次運行可能聯網下載一個引擎二進制文件到 ~/.impeccable/bin/。README 說明在 Claude Code 裏，hook 的運行不受模型工具審批的限制，所以第一次編輯就可能觸發下載；無人值守運行前先檢查已安裝的 hook。
• live 模式只應在你信任的本地項目裏用：應用文案修改時會以你的用戶權限執行 package.json 裏的一個可選校驗腳本。README 明確不支持把它注入線上生產站點。
• 和所有第三方技能一樣，安裝前通讀 SKILL.md 與腳本。
• 兼容性：Codex 安裝或更新後需要在 /hooks 裏手動批准項目 hook；Cursor 的技能功能按 README 說明需要先在設定裏開啟；VS Code 擴展要求較新的版本並處於受信任的工作區。