Communitygithub.com

DevvGwardo/impeccable

全方位的前端設計技能 — 23 個指令用於塑造、審計、打磨和精煉 UI。當使用者想要設計、重新設計、塑造、評論、審計、打磨、澄清、萃取、強化、優化、調整、動畫化、上色、提取或改善前端介面時使用。

impeccable 是什麼?

Impeccable 是一個全面的前端設計技能,專為 AI 代理(如 Claude Code、Cursor、Codex)所打造,旨在設計和迭代生產級別的前端介面。它基於 pbakaus/impeccable(Apache 2.0 授權),擴展了 Anthropic 的前端設計技能。此技能提供 23 個指令,涵蓋從建立(如 `craft`、`shape`)、評估(如 `critique`、`audit`)、精煉(如 `polish`、`bolder`)到增強(如 `animate`、`colorize`)的完整設計工作流程。它支援多種平台(Web 應用程式、登陸頁面、儀表板、UI 元件),並內建了關於色彩(OKLCH)、排版、佈局、動態效果的共享設計法則,以及明確禁止的反模式(如側邊條邊框、漸層文字、玻璃態效果)。該技能還提供一個獨立的 CLI 工具 `npx impeccable detect`,用於掃描 HTML、CSS、JSX 等檔案中的 25 種以上反模式,無需 AI 環境即可使用。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add DevvGwardo/impeccable

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Impeccable — 前端設計技能

設計並迭代生產級別的前端介面。真實的運作程式碼、經過審慎考量的設計選擇、卓越的工藝。

基於 pbakaus/impeccable(Apache 2.0),它建立在 Anthropic 的前端設計技能之上。

設定

在任何設計工作或檔案編輯之前:

  1. 讀取情境 — 檢查專案根目錄中是否有 PRODUCT.md / DESIGN.md。如果 PRODUCT.md 遺失或僅為佔位內容(少於 200 個字元),建議使用者先執行 impeccable:teach。
  2. 識別基調 — 每個設計任務分為品牌(行銷、登陸頁面、活動、作品集:設計即產品)或產品(應用程式 UI、管理後台、儀表板、工具:設計服務於產品)。開始設計前先進行識別。
  3. 載入基調參考 — 根據基調,從此技能的參考檔案中載入品牌或產品參考。

指令

當使用者呼叫特定的 impeccable 指令時(例如「審計這個頁面」、「打磨結帳流程」),請遵循以下模式:impeccable:<指令> [目標]。每個指令在此技能的參考目錄中都有一個對應的參考檔案。

指令類別描述
impeccable:craft [功能]建立完整的「先塑造再建立」流程,包含視覺迭代
impeccable:teach建立一次性設定:收集設計情境,撰寫 PRODUCT.md 和 DESIGN.md
impeccable:document建立從現有專案程式碼產生 DESIGN.md
impeccable:extract [目標]建立將可重複使用的元件和設計代碼提取到設計系統中
impeccable:shape [功能]建立在撰寫程式碼之前規劃 UX/UI
impeccable:critique [目標]評估UX 設計審查:層級結構、清晰度、情感共鳴
impeccable:audit [目標]評估執行技術品質檢查(無障礙、效能、回應式)
impeccable:polish [目標]精煉最終檢查、設計系統對齊、準備發布
impeccable:bolder [目標]精煉放大平淡的設計
impeccable:quieter [目標]精煉降低過於大膽的設計
impeccable:distill [目標]精煉萃取至精髓
impeccable:harden [目標]精煉錯誤處理、國際化、文字溢位、邊界情況
impeccable:onboard [目標]精煉首次執行流程、空狀態、啟用路徑
impeccable:animate [目標]增強加入有目的性的動態效果
impeccable:colorize [目標]增強引入策略性的色彩
impeccable:typeset [目標]增強修正字型選擇、層級結構、尺寸
impeccable:layout [目標]增強修正佈局、間距、視覺節奏
impeccable:delight [目標]增強加入令人愉悅的瞬間
impeccable:overdrive [目標]增強加入技術上超乎尋常的效果
impeccable:clarify [目標]修正改善不明確的 UX 文案
impeccable:adapt [目標]修正為不同裝置進行調整
impeccable:optimize [目標]修正效能改善
impeccable:live迭代視覺變體模式:在瀏覽器中迭代元素

路由

  • 未指定目標:按類別分組顯示指令表格,詢問使用者想要做什麼。
  • 指令匹配:從此技能的 reference/ 目錄載入其參考檔案,並遵循其指示。
  • 無匹配但與設計相關:直接應用共享的設計法則和基調參考。

共享設計法則

應用於每個設計,無論是哪種基調。實作複雜度需與美學願景相匹配。在不同專案間變化;切勿趨同於相同的選擇。

色彩

  • 使用 OKLCH。當亮度接近 0 或 100 時降低色度;極端值的高色度看起來俗豔。
  • 永遠不要使用 #000 或 #fff。將每個中性色朝向品牌色調進行著色(色度 0.005–0.01 就足夠了)。
  • 在選擇顏色之前,先挑選一個色彩策略。在承諾軸上有四個步驟:
    • 剋制:著色中性色 + 一個強調色 ≤10%。產品預設;品牌極簡主義。
    • 投入:一種飽和色彩佔據 30–60% 的表面。身分驅動頁面的品牌預設。
    • 完整調色盤:3–4 個命名角色,每個都有目的地使用。品牌活動;產品資料視覺化。
    • 浸潤:表面本身就是色彩。品牌主視覺、活動頁面。
  • 「一個強調色 ≤10%」規則僅適用於剋制。投入 / 完整調色盤 / 浸潤會有意地超過此限制。

主題

深色與淺色永遠不該是預設值。不要因為「工具用深色看起來很酷」而選擇深色。也不要因為「為了安全起見選淺色」而選擇淺色。

在選擇之前,寫一句關於實際場景的描述:誰在使用這個、在哪裡、在何種環境光下、帶著什麼樣的心情。如果這句話無法強迫出答案,表示它還不夠具體。繼續添加細節直到可以確定為止。

「可觀測性儀表板」無法強迫出答案。「SRE 在凌晨兩點、昏暗的房間裡,用 27 吋顯示器瞥一眼事故嚴重程度」則可以。

排版

  • 將內文行長限制在 65–75 個字元。
  • 透過字級 + 字重對比來建立層級結構(步驟之間的比例 ≥1.25)。避免平坦的字級比例。

佈局

  • 變化間距以創造節奏。到處使用相同的內距會造成單調。
  • 卡片是偷懶的答案。只有在它們確實是最佳提示方式時才使用。巢狀卡片永遠是錯的。
  • 不要把所有東西都包在一個容器裡。大多數東西並不需要。

動態效果

  • 不要對 CSS 佈局屬性進行動畫。
  • 使用指數曲線進行淡出(ease-out-quart / quint / expo)。不要使用彈跳或彈性效果。

絕對禁止(反模式)

識別並拒絕。如果你正要寫出以下任何一種,請用不同的結構重寫。

  • 側邊條邊框。在卡片、列表項目、提示框或警告上使用大於 1px 的 border-left 或 border-right 作為彩色強調。請使用完整邊框、背景色調、前導數字/圖示,或什麼都不加。
  • 漸層文字。background-clip: text + 漸層。裝飾性強,無意義。使用單一純色。透過字重或字級來強調。
  • 玻璃態效果作為預設。模糊和玻璃卡片作為裝飾。稀少且有目的性,否則不要使用。
  • 主指標範本。大數字、小標籤、支援統計數據、漸層強調色。SaaS 陳腔濫調。
  • 相同的卡片網格。相同尺寸的卡片,上面有圖示 + 標題 + 文字,不斷重複。
  • 將對話框視為第一選擇。對話框通常代表偷懶。首先窮舉行內或漸進式的替代方案。

文案

  • 每個字都要有其存在的價值。沒有重複敘述的標題,沒有重複標題的引言。
  • 不要使用破折號。 使用逗號、冒號、分號、句號或括號。

AI 千篇一律測試

如果任何人都能毫無疑問地看著這個介面說「這是 AI 做的」,那就失敗了。

類別反射檢查 — 兩個層次:

  • 第一層:如果單從類別就能猜到主題 + 調色盤(「可觀測性 → 深藍色」、「醫療保健 → 白色 + 青綠色」、「金融 → 海軍藍 + 金色」、「加密貨幣 → 霓虹黑底」),那就是訓練資料的反射。重新擬定場景描述和色彩策略,直到答案不再顯而易見。
  • 第二層:如果單從類別加上反參考就能猜到美學家族(「不是 SaaS 奶油風的 AI 工作流程工具 → 編輯排版風」、「不是海軍藍加金色的金融科技 → 終端原生深色模式」),那就掉進了更深一層的陷阱。第一層反射被避免了,但第二層沒有。重新擬定,直到兩個答案都不再顯而易見。

參考檔案

此技能的 reference/ 目錄中提供了每個指令和設計領域的詳細參考檔案。使用 skill_view(name='impeccable', file_path='reference/<名稱>.md') 載入它們。

關鍵設計領域參考(用於深入探討時載入):

  • reference/brand.md — 品牌基調:行銷、登陸、活動頁面
  • reference/product.md — 產品基調:應用程式 UI、儀表板、工具
  • reference/typography.md — 字型系統、字型搭配、模組化比例、OpenType
  • reference/color-and-contrast.md — OKLCH、著色中性色、深色模式、無障礙
  • reference/spatial-design.md — 間距系統、網格、視覺層級
  • reference/motion-design.md — 淡入曲線、交錯、減少動態效果
  • reference/interaction-design.md — 表單、焦點狀態、載入模式
  • reference/responsive-design.md — 行動優先、流體設計、容器查詢
  • reference/ux-writing.md — 按鈕標籤、錯誤訊息、空狀態
  • reference/cognitive-load.md — 減少介面中的認知負擔
  • reference/heuristics-scoring.md — Nielsen 風格的啟發式評估標準

指令特定參考(在匹配指令時載入):

  • reference/craft.md — 完整的先塑造再建立流程
  • reference/shape.md — 編寫程式碼前的 UX/UI 規劃
  • reference/teach.md — 設定 PRODUCT.md 和 DESIGN.md
  • reference/document.md — 從現有程式碼產生 DESIGN.md
  • reference/extract.md — 將代碼提取到設計系統
  • reference/critique.md — UX 設計審查
  • reference/audit.md — 技術品質檢查
  • reference/polish.md — 最終品質檢查
  • reference/bolder.md — 放大安全的設計
  • reference/quieter.md — 降低過於大膽的設計
  • reference/distill.md — 萃取至精髓
  • reference/harden.md — 生產就緒
  • reference/onboard.md — 首次執行流程和空狀態
  • reference/animate.md — 有目的性的動畫
  • reference/colorize.md — 策略性色彩引入
  • reference/typeset.md — 排版修正
  • reference/layout.md — 佈局和間距修正
  • reference/delight.md — 個性和令人難忘的點綴
  • reference/overdrive.md — 突破傳統限制
  • reference/clarify.md — UX 文案改善
  • reference/adapt.md — 裝置適配
  • reference/optimize.md — UI 效能
  • reference/live.md — 瀏覽器變體迭代

CLI 工具

Impeccable 還提供一個獨立的 CLI 工具,用於在沒有 AI 環境的情況下偵測 UI 反模式:

npx impeccable detect src/                   # 掃描目錄
npx impeccable detect index.html             # 掃描 HTML 檔案
npx impeccable detect https://example.com    # 掃描 URL(需要 Puppeteer)
npx impeccable detect --fast --json .        # 僅使用正規表達式,JSON 輸出

掃描 HTML、CSS、JSX、TSX、Vue、Svelte 檔案中的 25 種以上反模式。退出碼 0 表示乾淨,2 表示發現問題。需要 Node.js 18+。

來源

原始專案:github.com/pbakaus/impeccable 官方網站:impeccable.style

相關技能