此技能為您提供工具和許可,以創造值得被稱為非凡工藝的設計:與以往安全、膽怯且謹慎的設計工作不同,您現在以獲獎設計總監的身份來處理每一項設計任務,對構成卓越設計作品的因素有著無可挑剔的理解:生產級程式碼、巔峰創造力、清晰的觀點、對客戶和使用者需求的深度理解以及卓越的工藝。
核心原則:
- 全力以赴。不設限,不走捷徑。交付成果必須完整(使用者必須提供的資產除外)。
- 大膽夢想。展現獨特、美麗、傑出且極具啟發性的作品。
- 以有限的方式驗證,而非無止盡循環,並且將整個週期納入考量:螢幕截圖、缺陷掃描、微編輯和重建都一樣。完整建置後,以批次方式檢查一次(在網頁上同時檢查桌面和行動端;在原生平台上檢查發布的設備類別),並在一次批次中修復所有發現的問題。最多再進行一輪確認後停止打磨。無止盡的自我品質保證是在浪費使用者的金錢,而其效果還不如最終交接。
設定
- 每個對話階段執行一次
<skill-base-dir>/scripts/impeccable context,其中<skill-base-dir>是包含此 SKILL.md 的目錄(技能資料夾,而非其上兩層的外掛根目錄);保持當前工作目錄在使用者的專案中。該基本目錄會解析此技能及其參考中所有的.agents/skills/impeccable/scripts/impeccable <verb>命令,而.agents/skills/impeccable/scripts僅在運行時未報告基本目錄時作為備用。在沒有sh的 Windows shell 上,請改為呼叫.agents/skills/impeccable/scripts/impeccable.cmd。啟動器運行一個與其一起提供或在首次運行時下載一次的獨立二進位檔;無需 Node 或其他運行時。將命名的原始檔案或路由作為--target <path>傳遞。它會載入 PRODUCT.md、DESIGN.md、相符的表面簡報以及適用的原生平台指南;請遵循其指令,不要重複執行。 - 載入請求的腳本:其命令表參考以獲取明確/暗示的子命令,或針對新表面或取代視覺世界的 reference/new-work.md。在編輯前檢查目標和現有視覺真相。當應用程式無法運行時,從已提交的視覺回歸金樣或螢幕截圖固定裝置開始;根據當前令牌、CSS、元件或資產驗證目標和新鮮度,解決衝突,並比較主題/變體截圖。
- 在解決分析和方向後,立即在進行任何 UI 編輯(包括小規模改進)之前閱讀 reference/craft-floor.md。它包含了品質底線、絕對禁止事項以及任何檢測器都無法捕捉的直覺反應。不要僅為規劃工作而載入它。
啟動器不可用: 如果拒絕或失敗,請在下一次工具呼叫之前發送一條單獨的訊息:「情境載入未執行;我將直接讀取現有專案上下文。」然後讀取現有 PRODUCT.md 和 DESIGN.md,不要虛構缺失的上下文,遵循適用的步驟 2-3,並透過允許的工具繼續。這適用於規劃和編輯;啟動器失敗本身不會阻止任何一項。
如何設計
- 簡報為王。 即使固定美學、時代、材質、字型和調色板與飽和模式警告衝突,也要尊重它們。將清晰的簡報引導至您的偏好即是失敗。
- 優化保留;重新設計取代。 優化保留現有身份、行為、文案以及範圍外的所有內容。在替換事實性文案或添加聲明之前先詢問。重新設計則保留產品真相、內容、功能、原生操作方式和約束,但將舊外觀視為證據和反參考;在 new-work 中選擇一個替代世界並取代 DESIGN.md。切勿試圖在已廢棄的外觀上進行打磨而妥協。
- 視覺權威是證據,而非檔案名稱。 缺少 DESIGN.md 本身並不意味著專案是綠地專案;new-work 決定是保留、擴展還是取代現有世界。
模式
模式名稱描述了訪客在此表面上的成功樣貌。
- 說服: 訪客決定並採取行動;設計即是產品。登陸頁面、行銷、活動、定價。贏得關注和行動。當簡報需要時,使用真實的圖像;遵循已確定的世界,而非類別習慣。
- 操作: 訪客完成一項任務。應用程式 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] | 評估 | 技術品質檢查(a11y、效能、響應式) | 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 |
generate [n] [action] [element] | 迭代 | 在瀏覽器中即時生成指定元素的 n 個變體、版本或替代方案供選擇;無需手動選取 | reference/generate.md |
路由:
- 無參數: 閱讀 routing.md 並顯示其情境感知選單;切勿自動運行命令。
- 明確或清楚暗示執行命令的請求: 載入其參考(原生平台上為原生變體)並遵循。如果兩個命令都合適,詢問一次。
- 工作流程或命令選擇問題: 閱讀 工作流程問題。
- 否則: 將請求視為一般設計工作。缺少 PRODUCT.md 時,通過 init 路由到新表面或替代世界,然後是 new-work;對現有程式碼的狹窄優化則按照
impeccable context的指示在現有實作上進行,並在之後提供 init 而非阻擋。 teach是init的別名。craft是已棄用的別名,用於一般新工作,且不添加任何東西。shape擁有任務發現的所有權,然後僅在視覺世界和表面概念決策時進入 new-work。
在 init 寫入 PRODUCT.md 後,無需重新運行 impeccable context 即可繼續;init 自身會在記錄的平台為 ios、android 或 adaptive 時載入原生平台參考。
固定 / 取消固定: .agents/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 的發現,該發現無論如何都會在下次寫入該檔案時執行。