pbakaus/impeccable

解決的問題

Impeccable 為 AI 編碼代理提供設計指導與品質控制，防止其產出通用、重複且低品質的前端設計（通常被稱為「SaaS 模板」風格）。它建立了一套共享的設計詞彙與確定性規則，確保 AI 生成的 UI 專業、獨特且符合特定的產品目標。

運作方式

本專案作為一種「技能」整合至各種 AI 編碼工具中（例如 Claude Code、Cursor、GitHub Copilot 與 Grok Build）。它結合了以下功能：

• 產品背景 (Product Context)：透過 /impeccable init 指令建立 PRODUCT.md 檔案，儲存關於專案受眾與目的的持久性事實。
• 指令集 (Command Set)：24 個專用指令（例如 /impeccable polish、/impeccable audit、/impeccable critique），引導 AI 完成 UX 審查、無障礙檢查與視覺優化等特定設計階段。
• 確定性檢測器 (Deterministic Detectors)：61 條在本地端執行（無需 LLM）的規則，用於標記設計反模式，例如過度使用的字體或不良的色彩對比。
• 設計鉤子 (Design Hooks)：原生整合功能，可即時掃描 UI 檔案編輯並將發現的問題回饋給代理。

適用對象

使用 AI 編碼代理的前端開發人員與設計師，希望超越通用的 AI 生成佈局，實現高保真、客製化的專業設計。

特色亮點

• 廣泛的工具支援：相容於多種代理，包括 Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI 等。
• 確定性規則：包含 61 條非 LLM 規則，可立即捕捉常見的設計錯誤。
• 結構化工作流程：從收集產品事實 (init) 到規劃 (shape) 再到最終發布準備 (polish)。
• 即時迭代：具備 live 模式，可直接在瀏覽器中迭代視覺變體。