Communitygithub.com

lidge-ai/ima2-gen

設計方向探索與 UX 判斷,專為 ima2 使用者打造。用於 UI/UX 方向與設計判斷 — 模糊的視覺簡報、入門引導、空白/錯誤/載入狀態、佈局詞彙、排版斷行、網站圖示、標誌與品牌識別選擇。與 ima2-front 搭配使用:此技能決定設計方向,然後載入 ima2-front 來實作。觸發詞:make it look good, modern, clean, aesthetic, onboarding, empty state, error state, favicon, logo, design system, 깔끔하게, 모던하게, 감성적으로。

ima2-gen 是什麼?

ima2 UI/UX 是一個 AI 輔助設計技能,專門處理 UI/UX 的設計方向探索與判斷。當使用者提出模糊的設計需求(例如「깔끔하게」、「모던하게」或「just make it look good」)時,此技能會啟動一套嚴謹的意圖探索協議,引導使用者逐步明確設計方向,並產出結構化的 Design Read 文件。 此技能與 ima2-front 分工明確:本技能專注於設計判斷、資訊架構、UX 狀態意義、版型/色彩/排版方向、產品個性與品牌詞彙,以及反 slop 模式判斷;而 ima2-front 則負責具體的 HTML/CSS/元件實作與響應式機制。此外,技能內建豐富的參考模組庫,涵蓋設計主義、產品個性、構圖模式、UX 狀態、色彩系統、字型斷行、favicon/logo 設計等超過 20 個主題,並提供懶惰使用者門檻(UX-LAZY-01)與 UX 狀態合約(UX-STATE-01)等明確規則。 支援平台包括 Claude Code、Cursor 等具備技能目錄的 AI 代理。透過 ima2-gen CLI 工具安裝與設定後,即可在設計工作流程中動態載入參考文件,並透過 ima2 工具產生點陣圖素材與視覺驗證。此技能特別適合產品設計師、前端工程師與 AI 代理使用者,協助在設計初期快速收斂方向、避免通用輸出,並產出兼具美感與可用性的設計方案。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lidge-ai/ima2-gen/tree/HEAD/skills/ima2-uiux

在你喜歡的 AI 中提問

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

說明文件

ima2 UI/UX:意圖探索、模式與產品詞彙

設定

npm install -g ima2-gen    # 全域安裝(Node.js >= 20)
ima2 setup                 # 首次授權(建議使用 GPT OAuth)
ima2 serve                 # 啟動本地伺服器
ima2 ping                  # 驗證
ima2 status                # 檢視設定與 OAuth 狀態

代理啟動順序: 先執行 ima2 ping。若無法連線,則執行 ima2 serve &。若尚未安裝,則執行 npm install -g ima2-gen && ima2 setup。使用 ima2 skill path 來定位技能;閱讀 ../ima2-uiux/SKILL.md(本檔案)以取得設計方向,../ima2-front/SKILL.md 則提供實作素材。

在以下變更場景時啟動:

  • 使用者的設計方向模糊(「깔끔하게」、「모던하게」、「just make it look good」)
  • 正在建立入門引導、空白狀態、錯誤狀態或載入狀態的 UI
  • 使用者提及某個產品的風格(「Notion 느낌」、「Linear처럼」)
  • 開始新的設計系統或產生色彩調色盤
  • 選擇佈局模式或導覽架構
  • 設定網站圖示、產品標誌或品牌識別元素
  • 處理標誌深色模式變體、OG 圖片或社群分享 meta 資料

當使用者無法清楚表達明確的設計方向時,請優先閱讀此文件,再參考特定風格的參考資料。 關於反 slop 偵測與禁用模式,請參照 ima2 skill front ref anti-slop,尤其是 2026 漸層預算與單一主題禁令。

表情符號禁令(暫行): 嚴禁將表情符號用作 UI 視覺元素(嚴格)。正式規則、範圍與豁免條款請見 ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop。

角色分工: 本技能負責設計判斷:意圖探索、資訊架構、UX 狀態意義、排版/色彩/佈局方向、產品個性、品牌詞彙、反 slop 模式判斷與設計系統決策。ima2-front 則負責實作:HTML/CSS/元件、響應式機制、無障礙性、執行時期行為與渲染驗證。在此選擇設計方向後,載入 ima2-front 進行具體實作。

外部/現行設計證據: 對於即時產品參考主張、現行設計系統文件、瀏覽器 API 行為、可能已變更的無障礙指引,或瀏覽器渲染的原始碼證據,請搜尋網路,並遵循其查詢重寫、來源擷取與證據狀態規則。僅在候選 URL 存在後,才使用瀏覽器 fetch/open/text/get-dom/snapshot 功能。

C0/C1 工作(小型本地修補): 對於小型修補,可跳過完整的參考鏈。

規則類別說明(UX-STYLE-01): 本技能中所有表達品味的部分 — 產品個性、設計主義、預設權杖、美學詞彙 — 均為 STYLE_SAMPLE:僅為可參考的範例,絕非通用要求。客觀的 UX 正確性(狀態涵蓋率、無障礙性、可讀性)由 ima2-front §1.5 負責,且為嚴格/預設。

模組化參考

建議:將技能安裝到代理的技能目錄中。

ima2 skill install --dir <agent-skill-path>   # 代理提供自己的路徑
ima2 skill install --tmp                       # 臨時備用方案

代理自行決定技能目錄,並透過 --dir 傳入。安裝後,SKILL.md 與 references/ 目錄即可直接讀取。

臨時讀取(不安裝):

ima2 skill uiux refs              # 列出所有參考模組及其行數
ima2 skill uiux ref design-isms   # 列印單一模組(檔名匹配)
檔案何時閱讀內容說明
references/design-isms.md使用者提及某種風格/運動16 種設計運動與 CSS 特徵,包含 Liquid Glass + Liquid Editorial 預設套件(2025-2026) + AI Serif Editorial + Organic Capsule(2026-07-09 驗證)
references/design-award-sources.md尋找真實世界設計參考分層級來源指南:獎項與藝廊網站、各自的最佳用途及搜尋方法
references/compositional-patterns.md組成英雄區、導覽、動態或內容結構來自獎項研究的經典構圖模式,附響應式與無障礙閘門
references/design-trends.md檢查時間流行度、新興技術或推廣狀態2026-07-14 軸向頻率快照、技術訊號、簽名帳本與重新爬取協議
references/design-read-example.md學習或複習 Design Read 格式完整的 Design Read 範例與設定
references/product-personalities.md使用者提及某個產品10 個產品 DNA 設定檔,附精確權杖,包含 2026 AI 產品粉彩 + OpenAI 溫暖無襯線有機 + Anthropic 襯線書卷風
references/layout-macrostructures.md選擇頁面/元件佈局元件佈局 + 頁面層級組成
references/ux-states.md建立任何有狀態 UI入門引導、空白、錯誤、載入、漸進式揭露
references/color-system.md產生色彩/調色盤基於 OKLCH 的調色盤產生、色調預算、著色中性色、深色模式、無障礙性
references/design-system-bootstrap.md新專案/設計系統權杖架構、元件階層、DESIGN.md 格式(google-labs-code/design.md)
references/responsive-nav.md響應式或導覽工作斷點、容器查詢、依密度分類的導覽模式
references/ux-preflight.md交付前UX 狀態驗證檢查清單
references/typography-line-breaks.md通適用於文字密集 UI標題斷行品質、短描述分類(英雄副標題、卡片描述 — 使用 balance 而非 pretty)、孤兒防止、ch 單位、韓文孤兒標準、-webkit-line-clamp 衝突
references/favicon-logo.md處理網站圖示、產品標誌或品牌識別工作網站圖示檔案集、SVG 深色模式、導覽/頁尾標誌、深色模式變體、OG 圖片、品牌權杖、常見錯誤
references/logo-trust-sections.md整合/合作夥伴/客戶標誌跑馬燈 vs 網格決策、反模式、灰階處理、位置
references/visual-hierarchy.md任何佈局/組成決策6 個槓桿:尺寸比例、粗細對比、色彩強調、間距、位置、密度
references/form-patterns.md表單、精靈、驗證、檔案上傳驗證時機、多步驟、密碼 UX、檔案上傳、搜尋/篩選
references/mobile-native-ux.md原生行動應用 UX 決策iOS HIG vs Material 3、手勢、深層連結、韓文隱私、App Store UX
references/intent-discovery-ladder.mdUX-INTENT-01 選擇性深化(步驟 1-6)情緒/亮度/密度/形狀/視埠/參考階梯、模糊請求消歧
references/korean-design-vocabulary.md韓文設計簡報或韓文優先 UI韓文描述詞 → CSS 權杖轉換、快速比對表、字型選擇指南

懶惰使用者門檻(UX-LAZY-01,預設 — 馬尾辮紀律應用於 UX)

為認知節儉的使用者設計:使用者不閱讀,他們掃描;他們滿足於夠好的選擇;他們會為了單一明顯的下一步動作而放棄選擇。在出貨任何使用者面對的決策點之前 — 選項、設定、步驟、確認、輸入欄位、模式 — 請以馬尾辮方式依序證明其存在必要:

  1. 什麼都不做:正確的預設值能否完全消除這個決策?
  2. 刪除:這個步驟/欄位是否值得其完成率成本(希克定律)?
  3. 吸收:系統能否承擔複雜度,而非讓使用者承擔(泰斯勒定律)?
  4. 降級:仍部分使用者需要 → 漸進式揭露,絕不放在頂層分支。

每個畫面只有一個主要動作。根據表面情境:消費性/一次性流程要最小化決策;重複工作工具(密集設定檔)要最小化重複動作 — 將專家控制項折疊到精靈中則是相反的失敗。嚴格豁免:破壞性/不可逆動作、同意/隱私/法律、付款確認以及無障礙輔助功能,絕不能折疊到魔術預設值中。

UX 狀態合約(UX-STATE-01)

對於入門引導、空白、載入、錯誤或漸進式揭露工作,主體必須在進行樣式設定之前回答狀態的意義。深入模式請參閱 references/ux-states.md。

  • 入門引導教導第一個有意義的動作,而非整個產品。
  • 空白解釋狀態存在的原因,並指出下一個動作。
  • 載入在已知結構時選擇骨架,短時間未知等待時選擇旋轉器/進度條,並避免虛假的完成狀態。
  • 錯誤提供重試、回復或升級路徑;絕不能讓使用者陷入死胡同。
  • 漸進式揭露說明哪些內容保持隱藏、為什麼保持隱藏,以及何時變得可用。

IA 選擇器(UX-IA-01)

根據工作型態的預設導覽架構;響應式細節請參閱 references/responsive-nav.md。

工作型態預設 IA
密集桌面重複工作側邊欄 + 命令面板
中型分段工作分頁或分段導覽
行動優先消費性流程底部導覽、底部面板或拇指區域動作
精靈/驗證/設定步驟器或堆疊線性流程

1. 使用者意圖探索協議

當使用者的設計要求模糊時(「깔끔하게 해줘」、「모던하게」、「just make it look good」),不要產出通用輸出。請執行精簡模糊流程(UX-INTENT-01):

  1. 使用可用訊號,根據 §2 產出 Design Read。
  2. 如果某個決策仍阻礙方向,請提出一個最佳釐清分支,並提供二元/三元選擇。
  3. 根據答案繼續;如果使用者未回答且任務可繼續,請選擇最符合領域的正確預設值,並陳述此假設。在表現型表面(登陸頁/消費性/創意/AI 產品)上,此預設值為下方「無簡報預設方向」(UX-DEFAULT-ISM-01);安靜的表面則保持安靜的領域正確預設值。

若使用者已提供明確的設計規格,或此為 ≤5 行的修補,則跳過此節。

無簡報預設方向(UX-DEFAULT-ISM-01,預設 — 套件內容為 STYLE_SAMPLE)

此為 UX-INTENT-01 步驟 3 的備用方案,絕非繞過方式:它僅在 Design Read 完成,且單一阻塞分支已解決或未回答後才觸發,並且應用的方向必須始終在交付物中明確陳述為一項假設。一個有名稱、具體、限領域的方向取代了通用的 LLM 預設值;它不得以新標籤重新引入通用的玻璃態 / 置中卡片 / 米色預設品味。

用於表現型表面的預設套件:Liquid Editorial(2026 複合式風格,2026-07-07 從 Tier-2 趨勢研究決定 — 完整簽名請參閱 references/design-isms.md §1.14):

  • 結構:排版主導的編輯式構圖(超大標題比例、預設無襯線字型,僅在有編輯理由時使用襯線顯示字型,依 UX-TYPE-01)、觸覺/攝影紋理取代平面漸層、不對稱的內容加權佈局。
  • 材質重點:Liquid Glass 或近乎不透明的藥丸形鍍鉻,僅用於浮動功能層(導覽/工具列/籌碼簇);藥丸形籌碼內容單元;內容層保持實心(ima2-front FE-LIQUID-LAYER-01)。藥丸形鍍鉻內部的子元素在靜止時不得帶有膠囊邊框/輪廓 — 僅透過填色/淺色調來強調(ima2-front FE-PILL-NEST-01);頂部欄滾動狀態依 ima2-front/references/top-bar.md FE-TOPBAR-STATE-01。
  • 動態:回饋基準線 + 一個簽名時刻(指標接近籌碼或滾動驅動揭露) + 在登陸桶型表面至少有 1 個支援性滾動揭露(下限 2,上限約 4 — ima2-front/references/motion.md FE-MOTION-BUCKET-01);其他地方僅提供回饋,依動態領域閘門。
  • 色彩:基於 OKLCH 的單一強調色 + 著色中性色(色調預算,references/color-system.md)。

領域閘門(嚴格):儀表板、管理、營運、金融、政府、B2B 重複工作工具絕不能預設使用此套件 — 「花俏」絕不能凌駕於領域正確性之上(§ IA 選擇器 + ima2-front 產品密度設定檔)。

選擇性深化: 僅在第一個分支失敗或使用者明確要求引導探索時,才使用下方的階梯。

  • 使用二元/三元選擇,而非開放式問題。
  • 參考已知產品 — 使用者辨識他們想要的東西,比他們表述出來更快。
  • 如果圖表技能可用,提供:「참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요.」
  • 如果使用者提及特定產品參考,跳過其餘步驟,直接透過 references/product-personalities.md 進行映射。

如需完整的 6 步驟引導階梯(情緒 → 亮度 → 密度 → 形狀 → 視埠 → 參考)與模糊請求消歧表,請參閱 references/intent-discovery-ladder.md。僅在精簡流程需要更深層的引導探索時,才載入它。


2. Design Read(新頁面、元件或佈局為強制。≤5 行修補可選 — 參閱 dev §0.1 修補快速路徑)

在產生任何前端程式碼之前,請產出 Design Read。如果專案已有 DESIGN.md 檔案,請先讀取它 — 其權杖與散文將覆蓋以下所有內容。

原生工具支援(結構/60):在撰寫 Design Read 之前,使用 view_image 將視覺參考 — 現有畫面、競爭對手截圖、設計匯出 — 讀入上下文;使用 ima2 產出所需的點陣圖素材(圖示、插圖、模擬圖像)(先嘗試 ima2 status,若服務關閉則嘗試 ima2 serve;ima2 是主要工具,僅在 ima2 真正不可用時才使用其他工具),而不是保留佔位方塊;並根據視覺驗證(瀏覽器截圖 → view_image)視覺驗證建置結果。

輸出格式(迷你 DESIGN.md)

填寫範例:references/design-read-example.md。

---
name: <專案名稱>
colors:
  primary: "<hex>"
  accent: "<hex>"
  background: "<hex>"
typography:
  heading: { fontFamily: <字型>, fontSize: <尺寸> }
  body: { fontFamily: <字型>, fontSize: <尺寸> }
---

解讀為:<頁面種類> 用於 <受眾>,採用 <風格氛圍> 語言。 <1-2 句:具體參考,而非形容詞。「1970 年代講義」優於「現代且簡潔」>。

Do's:<來自簡報的具體正面建議> Don'ts:<來自簡報的具體負面建議>

相關技能