Communitygithub.com

UI/UX 設計

根據指定的視覺風格(如液態玻璃、極簡、編輯、Bento、賽博龐克等數十種),提取具體的 token 與元件規格來設計與建構介面,並依據品質標準進行審查。適用於建構或重塑頁面、選擇外觀、匹配品牌美學,或當 UI 看來過於普通、需要明確視覺觀點時。

UX 設計 是什麼?

此技能透過五個註冊工具以及相關參考文件,引導設計工作。它將視覺風格定義為具體規格,而非形容詞:每種風格都包含了色彩角色、字體階層、間距、圓角、陰影、動畫與元件配方,可直接複製使用而非自行發明數值。工作流程從透過 `uiux_styles` 篩選候選風格開始,接著使用 `uiux_spec` 或 `uiux_mix`(用於混合風格)提交規格,並可輸出為 MD、CSS、Tailwind 或 JSON 格式。建構時必須嚴格遵守 token,每個數值都有其存在理由;偏離時須說明原因。此外,在實作互動行為前,需透過 `uiux_platform_guide` 查詢 Chrome 的現代 Web 指引;實作動畫時則使用 `uiux_motion`,優先採用原生 API(如 `popover`、`startViewTransition`),並內建減少動畫偏好分支。最後,需根據參考的品質指南進行審查,確保成果並非只是顏色置換的通用卡片網格。此技能支援所有主要 AI 編碼代理平台,其設計哲學在於「方向要完全堅定、內容優先、使用 token、對比不可妥協、暗色模式需明確宣告、動畫要有預算、通用輸出即是失敗。」

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/humphrey-de-conqueror/dsh-uiux/tree/main/skills/uiux

在你喜歡的 AI 中提問

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

說明文件

UX 設計 是做什麼的?

此技能透過本外掛程式註冊的五個工具,以及一旁的參考檔案,來引導設計工作。這些規格是具體的設計規範,而非形容詞:每種規格都包含了色彩角色、字體階層、間距、圓角、陰影、動畫與元件配方,可直接複製使用,無需自行發明數值。

工作流程

  1. 篩選。 根據使用者的情緒詞彙、領域與提及的風格名稱,呼叫 uiux_styles。閱讀單行說明與「最適用於」欄位。選出兩到三個符合內容的候選風格,而非名稱最華麗的。

  2. 提交。 使用選定的 slug 呼叫 uiux_spec。指定所需的 sections(tokens、type、components、motion、rules、a11y、platform)與輸出 format:

    • md - 閱讀後開始寫程式碼。
    • css - 將自訂屬性區塊原封不動貼入樣式表。
    • tailwind - 將 @theme 區塊貼入(假設為 Tailwind v4)。
    • json - 提供給產生器或其他工具使用。 如果使用者要求混合(例如「70% 編輯風格、30% Bento」或「編輯風格但要更柔和」),請改用 uiux_mix——它會根據權重回傳一份規格,並以主導風格的結構為主。在回覆中註明你採用的風格或混合名稱,以便使用者要求更換不同的風格。右側邊欄的 Style preview 分頁會渲染你最後擷取的內容,因此在開始建構前,請引導使用者前往該處預覽方向。Style gallery 分頁則以卡片形式顯示所有風格;這兩個功能也位於 composer 的 + 選單中,對應指令為 uiux-preview 與 uiux-gallery。
  3. 建構。 使用風格的 token 來決定所有色彩、圓角、間距、陰影與持續時間。在自行發明新元件之前,先使用 components 章節中的元件來建構。規格中的每個數值都有其存在理由;如果你偏離了規格,請說明是哪個數值以及偏離的原因。

    規格中的 composition 設定是風格的一部分,而非裝飾:poster 表示網格中的規則與大型字體,glass 表示懸浮於漸層背景上的半透明面板,terminal 表示在框架畫面中的等寬字型行列,bento 表示不等高的區塊,soft 表示單一表面搭配成對的陰影,toy 表示粗邊框與硬偏移。將一種風格套用到通用的卡片網格上只是一種顏色置換,而這正是此外掛程式存在的目的——避免這種失敗模式。

  4. 檢查平台。 在實作互動(對話框、分頁標籤、輪播、固定頁首、深色模式、表單、動畫、圖片優先級)之前,請以 op: "search" 和你要實作的行為呼叫 uiux_platform_guide,然後以 op: "retrieve" 和值得閱讀的 ID 來取得資訊。這些是 Chrome 的現代 Web 指引規則——請遵循它們,而非你自己的習慣。

  5. 從平台出發進行動畫設計。 在引入任何動畫函式庫之前,請根據介面需求(例如:「表格載入時的骨架」、「進入詳細頁面的共享元素」)呼叫 uiux_motion。配方會優先使用原生 API——選單用 popover、共享元素用 startViewTransition、捲動揭示用 animation-timeline: view()、骨架與載入器用 CSS 關鍵影格——而且每個配方都包含了減少動畫偏好的分支。當某個配方需要專案中尚未擁有的依賴項(例如 spring-entrance 需要 motion)時,請使用 op: "probe" 與 dir 進行檢查,然後停下來安裝它,再繼續進行;不要重複解決配方已經處理好的問題。

  6. 審查。 在宣布工作完成之前,請先瀏覽 references/quality/web-interface-guidelines.md。修正它所標記的問題;這正是風格化頁面與完成品之間的差異。

適用於所有風格的規則

  • 一個方向,完全堅定。 半套應用風格只會看起來像個意外。如果規格指定了 0 圓角與極細邊框,那麼頁面上就不該有任何元素使用 12px 的圓角。
  • 內容優先。 風格是為了服務介面的工作。永遠不要為了讓構圖成立而隱藏、縮小或偽造使用者的實際資料。
  • 使用 token。 不要使用色板中沒有的原始十六進位值來重新調整某個元件;一致性是讓一種風格呈現為一個系統的關鍵。
  • 對比不是選擇題。 a11y 章節列出了經過驗證的顏色對。你引入的任何新對(例如在浮動表面上的淺色文字、在彩色按鈕上的文字),內文都需要 4.5:1,大型文字或非文字指示物則需要 3:1。
  • 暗色模式是明確宣告,而非反轉。 使用規格中的暗色色板。如果規格中沒有,則透過保留強調色來推導出暗色色板,並再次檢查對比。
  • 動畫有預算。 尊重 prefers-reduced-motion,保持單一入場編排,並且絕不在使用者正在閱讀的捲動驅動內容上對版面進行動畫處理。
  • 通用輸出就是失敗。 帶有漸層主視覺與 emoji 圖示的可互換卡片網格,是模型會退回到的預設狀態。如果結果可以屬於任何其他產品,那就表示風格沒有被真正應用。

風格系列

目錄比這個列表還要大;uiux_styles 會搜尋所有風格,包括別名。

意圖值得嘗試的風格
冷靜、高端、產品導向premium-minimalism, swiss-international, japandi
深度、半透明、行銷liquid-glass, glassmorphism, aurora
大膽、具表現力、發布頁面neo-brutalism, maximalist-pop, cyberpunk, vaporwave
精心製作的印刷與編輯editorial, paper-print, monochrome-architecture
系統、工具、密集資料data-dashboard, material-you, terminal-crt
觸感佳、俏皮、柔和claymorphism, neumorphism, bento-grid

內容層級

規格分為 full(完整)或 brief(簡要)。

  • full - 完整的 token、元件配方、該做與不該做的規則、反模式、經過驗證的對比色對。作為事實來源使用。
  • brief - 僅包含色板、字體、圓角與間距。上游的 awesome-design-skills 提供了風格名稱;它們的色板與字體在此處撰寫,因此簡要風格之間是可以區分的,而非重複 59 次的相同藍底白字預設。將簡要風格視為一個起始方向:保留其色板與幾何,然後自行做出元件與無障礙設計的決定。

檔案

  • references/style-index.md - 每種風格及其單行說明,由資料檔案產生。當你想查看完整目錄而不想進行工具呼叫時,請掃描此檔案。
  • references/quality/web-interface-guidelines.md - 審查檢查清單。請閱讀它。
  • references/quality/style-review.md - 針對視覺方向本身的簡短通過/失敗審查。
  • references/upstream.md - 風格資料的來源、授權條款,以及當上游發布新風格時如何重新整理。

相關技能