Impeccable — 前端設計技能
設計並迭代生產級別的前端介面。真實的運作程式碼、經過審慎考量的設計選擇、卓越的工藝。
基於 pbakaus/impeccable(Apache 2.0),它建立在 Anthropic 的前端設計技能之上。
設定
在任何設計工作或檔案編輯之前:
- 讀取情境 — 檢查專案根目錄中是否有
PRODUCT.md/DESIGN.md。如果PRODUCT.md遺失或僅為佔位內容(少於 200 個字元),建議使用者先執行impeccable:teach。 - 識別基調 — 每個設計任務分為品牌(行銷、登陸頁面、活動、作品集:設計即產品)或產品(應用程式 UI、管理後台、儀表板、工具:設計服務於產品)。開始設計前先進行識別。
- 載入基調參考 — 根據基調,從此技能的參考檔案中載入品牌或產品參考。
指令
當使用者呼叫特定的 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— 字型系統、字型搭配、模組化比例、OpenTypereference/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.mdreference/document.md— 從現有程式碼產生DESIGN.mdreference/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+。