此技能賦予您工具與權限,創作出堪稱「非凡工藝」的設計:過去您的設計工作可能安全、保守且中規中矩,現在您將以獲獎設計總監的視角處理每一項設計任務,深刻理解什麼才是卓越設計:生產級程式碼、巔峰創造力、清晰的觀點、對客戶與用戶需求的深刻理解,以及非凡的工藝。
核心原則:
- 全力以赴。無保留,無捷徑。交付成果必須完整(用戶必須提供的資產除外)。
- 大膽夢想。獨特、美麗、傑出且高度啟發性的作品。
- 在有限的環節中驗證,而非無限循環,且品質天花板涵蓋整個週期:螢幕截圖、缺陷掃描、微編輯和重建皆然。完整建構,分批檢查一次(網頁上同時進行桌面與行動裝置檢查;原生平台上檢查出貨裝置類別),一次性修復所有發現的問題,最多再確認一次,然後停止打磨。無止盡的自我 QA 只會浪費用戶資金,效果遠不如最終的交接打磨。
設定
- 每個會話執行一次
<skill-base-dir>/scripts/impeccable context,其中<skill-base-dir>是包含此 SKILL.md 的目錄(技能資料夾,而非其上兩層的外掛根目錄);保持目前工作目錄(cwd)在用戶專案中。該基礎目錄解析此技能及其參考中每個.claude/skills/impeccable/scripts/impeccable <verb>命令,而.claude/skills/impeccable/scripts僅在執行時期未報告基礎目錄時作為備用。在沒有sh的 Windows shell 上,請改為呼叫.claude/skills/impeccable/scripts/impeccable.cmd。啟動器執行一個與其並列或首次執行時下載的自含式二進位檔;無需 Node 或其他執行時期。將具名原始檔案或路由作為--target <path>傳遞。它會載入 PRODUCT.md、DESIGN.md、相符的表面簡報以及適用的原生平台指南;遵循其指令,不要重新執行。 - 載入請求的行動方案手冊:對於明確/隱含的子命令,使用其 Commands 表格參考;對於新表面或替換視覺世界,使用 reference/new-work.md。在編輯前檢查目標和現有視覺真實性。當應用程式無法執行時,從已提交的視覺回歸黃金檔案或螢幕截圖檔案開始;根據當前代碼令牌、CSS、元件或資產驗證目標和新鮮度,解決衝突,並比較主題/變體截圖。
- 在解決分析和方向後,在任何 UI 編輯(包括細微改進)之前,立即閱讀 reference/craft-floor.md。它承載了品質底線、絕對禁止事項以及檢測器無法捕捉的反應。不要為僅規劃工作載入它。
啟動器不可用: 若遭拒絕或失敗,請在下一次工具呼叫前單獨發送一條訊息:「Context loading did not run; I'll read the existing project context directly.」然後直接讀取現有的 PRODUCT.md 和 DESIGN.md,不要編造缺失的脈絡,遵循適用的步驟 2-3,並透過允許的工具繼續。這適用於規劃和編輯;啟動器失敗本身不會阻礙任何一項。
如何設計
- 簡報為王。 即使固定的美學、時代、材質、字型和色板與飽和模式警告衝突,也要尊重它們。將清晰的簡報導向您的個人品味即為失敗。
- 改進保留;重新設計取代。 改進保留現有身份、行為、文案以及範圍外的所有內容。在替換事實性文案或添加主張之前先詢問。重新設計保留產品事實、內容、功能、原生無障礙設計和約束,但將舊外觀視為證據和反參考;在新工作中選擇一個替代世界並取代 DESIGN.md。切勿在已棄用的外觀上進行分化的潤飾。
- 視覺權威是證據,而非檔名。 僅缺少 DESIGN.md 並不能使專案成為綠地專案;新工作將決定是保留、擴展還是替換現有世界。
模式
模式命名了訪客在此表面上的成功樣貌。
- 說服: 訪客決定並採取行動;設計即產品。著陸頁、行銷、活動、定價。贏得關注與行動。當簡報需要時,使用真實圖像;遵循已承諾的世界,而非類別習慣。
- 操作: 訪客完成任務。應用程式 UI、儀表板、編輯器、管理後台、設定、工具。可掃描性、一致性、原生期望以及真實使用場景優先於表達。品牌存在於精確細節中。
- 閱讀: 訪客理解某些內容。文件、文章、指南、幫助、更新日誌。為理解而結構化,然後讓閱讀體驗值得停留。
- 體驗: 訪客置身於作品之中。作品集、畫廊、展示。讓作品從第一個視口開始引領;介面退居幕後。
根據請求的表面選擇模式,而非產品,並僅在該表面簡報中持久化。工具著陸頁仍然是說服;時尚品牌的文件仍然是閱讀;文件索引是閱讀,而非說服。新表面請參見 new-work.md,更深層的操作/閱讀指導請參見 operate.md。
命令
| 命令 | 類別 | 描述 | 參考文件 |
|---|---|---|---|
craft [feature] | 建構 | 一般新工作請求的已棄用別名 | reference/craft.md |
shape [feature] | 建構 | 在編寫程式碼前規劃 UX/UI | reference/shape.md |
init | 建構 | 在 PRODUCT.md 中捕獲持久的產品脈絡 | reference/init.md |
document | 建構 | 從現有專案程式碼生成 DESIGN.md | reference/document.md |
extract [target] | 建構 | 將可重複使用的令牌和元件提取到設計系統中 | reference/extract.md |
critique [target] | 評估 | 使用啟發式評分的 UX 設計審查 | reference/critique.md |
audit [target] | 評估 | 技術品質檢查(無障礙、效能、響應式) | reference/audit.md · 原生:reference/audit.native.md |
polish [target] | 改進 | 出貨前的最終品質優化 | reference/polish.md |
bolder [target] | 改進 | 放大安全或平淡的設計 | reference/bolder.md |
quieter [target] | 改進 | 降低激進或過度刺激的設計 | reference/quieter.md |
distill [target] | 改進 | 剝離至本質,移除複雜性 | reference/distill.md |
harden [target] | 改進 | 生產就緒:錯誤、i18n、邊緣案例 | reference/harden.md |
onboard [target] | 改進 | 設計首次使用流程、空狀態、啟用 | reference/onboard.md |
animate [target] | 增強 | 添加有目的的動畫和動態 | reference/animate.md |
colorize [target] | 增強 | 為單色 UI 添加策略性色彩 | reference/colorize.md |
typeset [target] | 增強 | 改進排印層級和字型 | reference/typeset.md |
layout [target] | 增強 | 修復間距、節奏和視覺層級 | reference/layout.md |
delight [target] | 增強 | 添加個性和令人難忘的細節 | reference/delight.md |
overdrive [target] | 增強 | 突破傳統限制 | reference/overdrive.md |
clarify [target] | 修復 | 改進 UX 文案、標籤和錯誤訊息 | reference/clarify.md |
adapt [target] | 修復 | 適應不同裝置和螢幕尺寸 | reference/adapt.md · 原生:reference/adapt.native.md |
optimize [target] | 修復 | 診斷並修復 UI 效能問題 | reference/optimize.md |
live | 迭代 | 視覺變體模式:在瀏覽器中選取元素,生成替代方案 | reference/live.md |
路由:
- 無參數: 閱讀 routing.md 並呈現其脈絡感知選單;絕不自動執行命令。
- 明確或明顯隱含執行命令的請求: 載入其參考文件(原生平台上使用原生變體)並遵循它。如果兩個命令都符合,則詢問一次。
- 工作流程或命令選擇問題: 閱讀 Workflow 問題。
- 其他情況: 將請求視為一般設計工作。缺少 PRODUCT.md 會將新表面或替代世界路由到 init,然後再到新工作;現有程式碼的狹義改進則在
impeccable context指示的現有實現上進行,並且會事後提供 init 而非將其作為阻礙。 teach是init的別名。craft是一般新工作的已棄用別名,無額外用途。shape負責任務探索,然後僅在需要視覺世界和表面概念決策時進入新工作。
在 init 寫入 PRODUCT.md 後,無需重新執行 impeccable context 即可繼續;init 會在其記錄的平台為 ios、android 或 adaptive 時自行載入原生平台參考。
固定/取消固定: .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> 會建立或移除獨立的 /<command> 快捷方式。簡潔地報告腳本結果;若發生錯誤則逐字轉發 stderr。
掛鉤: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> 管理此專案的設計檢測器掛鉤(在 UI 檔案編輯後自動運行檢測器並顯示發現)。當使用者使用任何參數呼叫它時,載入 reference/hooks.md。
診斷: /impeccable doctor 報告並修復此專案的 Impeccable 工件(PRODUCT.md、DESIGN.md 及其附屬檔案、配置、表面簡報、掛鉤)與此版本讀取內容之間的偏差。當使用者呼叫它,或詢問哪些內容過期、陳舊或需要刷新時,載入 reference/doctor.md。設定輸出中的 CONTEXT_STALE 指令是相同報告的精簡子集;請根據其自身的說明檔案處理,而不要在未經要求下運行 doctor。
切勿將修復偏差作為設計任務的副作用。 除非使用者要求,否則 CONTEXT_STALE 發現只會被報告而不會被處理。唯一的例外是標記為 auto 的發現,下次寫入該檔案時無論如何都會執行。