Communitygithub.com

視覺設計

在建立或修改設計系統時使用,例如設計代碼、調色盤、對比度、字型、字級、間距比例、深色模式、動態代碼或元件狀態規格。不適用於佈局或評論特定頁面或重新設計;請使用 `designer`。不適用於製作圖片;請使用 `artist`。

視覺設計 是什麼?

這個技能提供了一個全面的指南,用於建立一個穩固且可擴展的視覺設計系統,從基礎代碼(色彩、字體、間距、形狀、深度和動態)到元件規格。其主要價值在於確保設計的決策具有目的性且一致,透過先撰寫設計方向陳述,讓所有代碼決策都以此為依據,避免使用預設值或隨意選擇。這個技能支援所有需要 UI 的開發平台,並與 `designer`(負責頁面佈局)和 `artist`(負責圖片生成)等其他技能明確分工。其運作方式是建立一個分層結構:先定義方向,然後是色彩代碼、字體、間距、圓角、動態,最後是元件規格,確保每一層都依賴於前一層,從而建立一個有凝聚力且易於主題化的系統。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/visual-design

在你喜歡的 AI 中提問

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

說明文件

視覺設計 是做什麼的?

每個螢幕背後的系統:色彩、字型、空間、形狀、深度和動態的代碼,以及由它們構建的元件規格。designer 技能將此系統應用於實際頁面。系統只建立一次;讓頁面來使用它。

最重要的規則

  1. 在任何代碼之前,先用文字寫下設計方向。 三到四句話:它是為誰設計的、應該給人什麼感覺、絕對不能給人什麼感覺,以及它從主題中借鑒的一件事。每一個代碼決策都需與該段落進行校對。
  2. 元件引用語意代碼,永遠不引用原始值。 --color-text-primary,而不是 --grey-900。深色模式、主題化和品牌重塑變成重新映射,而不是重寫。
  3. 檢查每組真實配對的對比度,並在兩種主題下檢查,對照下表。在白色背景上通過的調色盤,在其自身染色的表面上可能會失敗。
  4. 預設值不是一個決策。 框架灰色、所有地方都用 Inter、每個盒子都用 4px 圓角半徑:每個看起來都不錯,但組合起來看起來就像每個其他產品。要嘛決定每個值,要嘛有意識地接受它。
  5. 每個元件規格都列出每個狀態:預設、懸停、聚焦、啟用、禁用、載入、錯誤,以及在適用的地方加上選中狀態。缺少的狀態會在構建過程中被不一致地發明出來。
  6. 更少的數值,並一致地使用。 一個有 6 個步驟且到處使用的比例,勝過一個有 14 個步驟但隨機使用的比例。

何時不使用

  • 安排特定頁面、決定摺疊內容以上的部分、評論螢幕或進行重新設計:designer。
  • 生成插圖、圖標、主視覺圖片或品牌標誌:artist。
  • 圖表和數據可視化調色盤:frontend 技能的 references/charts.md。分類圖表顏色有品牌調色盤所沒有的限制。
  • 在框架中實現代碼:frontend。

建構順序

每一層都依賴於前一層:

  1. 方向段落。
  2. 色彩:原始值,然後是語意代碼。
  3. 字型:字體,然後是字級和角色。
  4. 間距比例和網格。
  5. 圓角、邊框和高度。
  6. 動態代碼。
  7. 元件代碼和元件規格。

色彩

結構:

原始值 (原始數值,每個色相一個漸層,例如 50, 100 ... 900, 950):
  --blue-600: oklch(0.55 0.17 255)

語意代碼 (引用原始值,按功用命名):
  --color-bg, --color-surface, --color-surface-raised
  --color-text, --color-text-muted, --color-text-on-accent
  --color-accent, --color-accent-hover
  --color-border, --color-focus-ring
  --color-danger, --color-success, --color-warning (每個都有安全的文字變體)

區分深思熟慮的調色盤與預設調色盤的規則:

  • 在 OKLCH 中建立漸層。 亮度在各個色相之間保持感知上均勻,因此 600 的藍色和 600 的綠色具有相同的視覺重量。HSL 亮度會說謊。
  • 為中性色調染色。 純灰色和純黑色或白色看起來像是無主的。加入少量色度(大約 0.005 到 0.015)朝向品牌色相。
  • 彩色表面上的文字 使用該表面色相的深色調,而不是中性灰色。灰色在彩色上看起來褪色。
  • 選擇一個承諾級別並堅持下去:克制(中性底色,一個強調色)、投入(品牌色相普遍存在)、完整調色盤,或沉浸(品牌色相是底色)。半途而廢的承諾看起來像猶豫不決。
  • 永遠不要讓色彩單獨承載意義。 將其與圖標、標籤或圖案配對。
  • 留意當前的反射動作。 帶有襯線展示字體和赤陶色強調色的暖奶油色頁面,或近乎黑色搭配一個酸性強調色,是當沒有做出決定時,生成的設計會採用的。只有在方向段落要求時才使用它們。

對比度 (WCAG 2.2)

配對AAAAA
正文文字 (小於大尺寸)4.5:17:1
大文字:24px 常規體,或約 18.7px 粗體及以上3:14.5:1
UI 元件邊界、圖標、焦點指示器、承載意義的圖表標記3:1無
  • 向用戶傳達資訊的佔位文字是文字:4.5:1。
  • 禁用控件豁免,但用戶仍需能看到控件存在。
  • 測量計算後的顏色,包括不透明度和覆蓋層。染色卡片上 60% 不透明度的標籤就是一種新的顏色。

字體排版

  • 根據內容的調性選擇字體,而不是出於習慣。三個角色:一個有特色的展示字體,謹慎使用;一個舒適的正文字體;一個用於標籤、說明和數據的實用字體(表格中的數字使用表格數字)。
  • 根據清晰的對比進行配對(襯線與無襯線,幾何與人文主義)或在同一個家族中使用不同字重。兩個相似但不一樣的字體看起來像一個錯誤。
  • 模數比例。 選擇一個比例:密集的產品 UI 用 1.2,內容和行銷用 1.25 到 1.333。命名角色,而不是大小:display、h1 到 h4、body-lg、body、body-sm、label、caption。
  • 行長 正文文字 60 到 75 個字符 (max-width: 70ch)。
  • 展示字體 使用更緊的字距(約 -0.02em 到 -0.04em)和一個大小上限(約通過 clamp() 設置為 6rem)。更大很少看起來是有意為之。
  • 標題使用 text-wrap: balance,正文段落使用 text-wrap: pretty。
  • 行高:正文約 1.5,展示字體 1.1 到 1.25。

空間、形狀、深度

  • 間距比例 基於 4 或 8:例如 4, 8, 12, 16, 24, 32, 48, 64。元件使用代碼,永遠不使用原始像素值。
  • 圓角半徑:兩到三個值,並附帶規則說明哪個用在何處。嵌套圓角:內部圓角半徑等於外部圓角半徑減去它們之間的內邊距。
  • 高度:三到四個級別,每個級別對應一個功用(靜止卡片、下拉選單、模態框)。在深色主題中,使用更亮的表面而不是更重的陰影來提升高度感。

動態

  • 代碼:持續時間(例如 120ms、200ms、320ms)和兩到三個緩動曲線(一個用於進入,一個更銳利的用於退出)。元素重複使用它們;沒有人會為每個元素挑選一個值。
  • 動態解釋變化:某物從哪裡來,什麼做出了回應。只有裝飾作用的動態看起來像是生成的。
  • 一個精心編排的瞬間勝過所有東西同時淡入。
  • 尊重 prefers-reduced-motion: reduce:移除移動和長時間的過渡,保留不透明度變化。
  • 不要在懸停時縮放照片。為容器添加動畫(陰影、邊框、背景)。

深色模式

  • 深色主題是語意代碼的重新映射,從來不是反轉。底色使用深灰色,而不是純黑色,並降低會發光的強調色的色度。
  • 在深色主題中重新檢查每個對比配對。
  • 防止錯誤主題閃現:在文檔頭部的一個小型內聯腳本中決定主題,在首次繪製之前。

在實作主題切換、持久性或深色模式中的圖片時,請閱讀 references/dark-mode.md。

元件規格

在撰寫元件規格之前,請閱讀 references/component-spec.md。它包含了模板和狀態檢查清單。

陷阱

  • 11 種深淺命名為 100 到 900。 那是 9 個步驟。命名漸層時要讓數量和名稱一致(50, 100 ... 900, 950 給出 11 個)。
  • 「大字」指的是 18 點,而不是 18 像素。 18px 常規正文字體需要 4.5:1,而不是 3:1。大字閾值是 24px 常規體或約 18.7px 粗體。
  • 元件中的原始代碼。 在第一次主題化之前有效。之後每個元件都需要編輯。
  • 在模擬稿上檢查對比度,而不是在構建版本上。 不透明度、覆蓋層和抗鋸齒會改變實際顏色。測量渲染後的像素或計算後的樣式。
  • 用一個全域調整來修復一個區域性問題。 為了挽救一組失敗的配對而變暗整個調色盤,會改變每一個其他配對。修復該配對的代碼。
  • 一個無人使用的代碼,或一個無人代碼化的原始值。 兩者都意味著系統和構建版本已經脫節。搜索構建版本中的原始十六進制和像素值。
  • 為了一個標題載入一個新字體。 每個字體都需要載入時間。使用系統已經載入的字體。

驗證

  • 方向段落已撰寫,並且每個代碼家族都可以追溯到它。
  • 每個文字和 UI 配對在淺色和深色模式下都通過 AA 標準,並在構建的頁面上測量。
  • 元件僅使用語意代碼:搜索顯示元件程式碼中沒有原始顏色或間距值。
  • 每個元件規格列出其所有狀態。
  • 已測試減少動態設定:沒有動態殘留。
  • 在硬重新整理且系統設定相反時,主題切換不會閃現。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

api-design

Use when designing or changing an HTTP API contract, adding or editing a route, endpoint or webhook, writing an OpenAPI spec, choosing error, pagination or versioning shapes. Also when asking "is this a breaking change". Not for server internals such as jobs, retries or rate-limit storage; use `backend-patterns`.

artist

Use when making or directing visual assets such as illustrations, hero images, icons, logos, brand marks, textures or diagrams, or writing prompts for an image-generation model. Covers art direction, reference boards and critique against a brief. Not for page layout; use `designer`. Not for palettes and tokens; use `visual-design`.

copywriter

Use when writing, rewriting or reviewing words a customer reads, such as landing or marketing pages, headlines, taglines, calls to action, pricing pages, product descriptions, onboarding text, button labels, error messages and empty states. Not for long-form docs or articles; use `docs`. Not for positioning strategy; use `marketing`.

designer

Use when asked to critique, redesign or review the layout and hierarchy of a page, screen, landing page or dashboard (hero, CTAs, card grids, testimonials), or when a design \"looks off\", \"looks generic\" or \"looks AI-made\". Use it for any layout feedback, even if the word design is not used. Not for tokens, palettes or type scales; use `visual-design`. Not for images; use `artist`.

frontend

Use when building, reviewing or fixing browser UI, such as pages, components, forms, client state, charts, print or PDF views, accessibility or web performance (Core Web Vitals, bundle size, slow renders). Not for visual direction, layout critique or brand (use `designer` or `visual-design`). Not for native or React Native apps (use `mobile`).

game-design

Use when designing or reviewing how a game plays: core loop, mechanics, game feel and juice, difficulty curve, progression, economy and balance, tutorials, HUD and menus or a game design document (GDD) and playtest plan. Not for engine code or rendering (use `frontend`) or for non-game product UX (use `ux-research`).

ux-research

Use when planning or synthesising user research (interviews, usability tests, surveys), mapping a journey or job to be done, specifying an interaction's states, or running a heuristic review of a flow. Not for menus, labels, taxonomy or site structure; use `information-architecture`. Not for visual polish; use `designer`.

相關技能