pbakaus/impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Nutlope/hallmark(已於 2026-W30 推過),故改推第 2 名。這是什麼
Impeccable 為 AI coding agent 提供設計語彙與檢查工具。它針對「功能做出來,畫面卻像同一套模板」的問題,把模糊的美化要求拆成具體動作,例如加強視覺張力、收斂裝飾、調整字級層次與完成上線前修飾,而不只是再加一段通用提示詞。
核心是專案脈絡加上有目標的操作:init 讀取程式碼並詢問不足資訊,寫出 PRODUCT.md;document 將既有視覺系統記錄為 DESIGN.md。後續修改有產品與品牌依據,比每輪重新描述「我要什麼風格」更能維持一致。
為什麼上榜
本次週榜資料累計 99,294 顆星、當期新增 12,017 顆。README 點名紫藍漸層、卡片套卡片等反覆出現的生成式介面慣性。它的切入點不是替換寫程式的模型,而是補上設計決策、審查與回饋,讓團隊能對產出提出更精確的要求。
另一亮點是 62 條確定性偵測規則,不需要模型或 API 金鑰即可執行。不過規則抓得到常見模式,不代表能判定所有設計好壞;README 也允許為品牌字型等需求設定忽略。這比較像可調整的品質防線,而非一套放諸四海皆準的審美標準。
適合誰,可以拿來做什麼
適合用 agent 開發介面的前端工程師與小型產品團隊,尤其是已有頁面、想逐步改進的人。README 明確建議縮小目標:先審一組價格卡片或一段註冊流程,比一次要求重做整個網站更有效。
critique 偏向使用體驗評估,audit 檢查無障礙、效能、主題與響應式行為;偵測器可放進 CI。要注意原始碼掃描只有模式規則,低對比、字體過小等需要渲染結果的檢查,得另外掃描開發伺服器網址,不能只掃 JSX 就宣稱全面過關。
上手
在專案根目錄執行 安裝指令,依提示選擇工具與安裝範圍,再重新載入 coding tool:
npx impeccable install
接著在 agent 內建立脈絡,挑一個小元件開始:
/impeccable init
/impeccable critique the pricing cards
Codex 使用 $impeccable 而非上述斜線指令。若只是想先看規則結果,可執行 npx impeccable detect src/;有發現時退出碼為 2,無法掃描目標則為 1,串接 CI 時應分開處理。
README 重點摘要
- 設計 hook可在 agent 修改介面檔案後自動回報問題,但支援及授權步驟依工具而異。
- Live 模式可在瀏覽器挑選元素、切換變體並寫回原始碼,只應用於本機開發副本。
- 執行權限值得先檢查:陌生專案的手動編輯驗證腳本會以使用者權限執行。
- 關閉遙測不等於離線:新設計仍會向網站取得視覺方向資料,匿名選擇紀錄才受遙測設定控制。