Communitygithub.com

21 Grams UI 介面美學

一個專門消除 AI 生成痕跡、套用經過驗證的 UX 與動畫原則(如擠壓與拉伸、預備動作、舞台化等),並透過專案既有的元件與設計 Token 來打造「非 AI 感」的精緻 UI。當使用者要求「提昇」、「打磨」、「去 AI 化」或「讓它看起來不像 AI 做的」時,便可啟用此技能。

21 Grams UI 介面美學 是什麼?

21 Grams UI 是 21 Grams 系列中的 UI 套件,其核心目標是「去 AI 化」——消除 AI 生成 UI 常見的刻板特徵(例如過度一致性、濫用陰影與圓角、缺乏動態細節),並將一套固定的設計原則(20 條 UX 與動畫原則、10 條設計駭客技巧、20 條動畫工藝、10 條排版技巧與 20 條去 slop 規則)透過專案既有的元件庫與設計 Token 來落實。它不會導入新的 UI Kit,也不會替換品牌的顏色、字型、圖標等,而是改變這些元素的使用方式(對比、層級、間距、動態)。 支援的平台包括 Claude Code、Cursor、Codex 等任何能讀取 SKILL.md 的 AI 代理工具。其工作流程為:先盤點專案現有的設計系統(Token、元件庫、圖標與動畫庫),然後對目標畫面進行審計,列出每個違反原則的問題與建議的修復方式(需指定修改哪個現有元件或 Token),再與使用者確認後才開始套用修復。修復順序為 Token → 共享元件 → 頁面,最後會產生前後對比截圖(含互動比較工具)與詳細報告。 此技能最獨特的概念是「Rule Zero」:所有修改都必須透過專案已有的元件與 Token 來完成,絕不建立平行元件集。當某個功能元件確實不存在時(如沒有切換開關),需從專案既有的基礎元件與 Token 來建構,並在報告中說明。若沒有動畫庫,就使用 CSS transitions。預設的「house style」值僅在專案未定義時作為備用,且會被映射到專案既有的 Token 上。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/HEAD/skills/ui

在你喜歡的 AI 中提問

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

說明文件

21 Grams UI

對既有的 UI 進行一次修整。21 Grams UI(21 Grams 家族的 UI 套件)不會重新設計產品,也不會帶入自己的 UI Kit。它移除 AI 生成 UI 的明顯痕跡,並透過專案既有的元件與 Token 套用一套固定的規則,使結果看起來經過深思熟慮、感覺快速,且仍然屬於該產品。

規則零:使用專案既有的元件

每一次修改都必須透過專案已經使用的東西來完成。21 Grams UI 絕不建立一套平行的元件集。

  1. 在接觸任何東西之前先盤點一次。 記錄設計 Token 或主題(CSS 變數、Tailwind 設定、主題檔案)、元件庫(shadcn/ui、Radix、MUI、Chakra、內部套件、客戶設計系統)、圖標集、圖表庫與動畫庫。記錄每個共享元件的名稱與存放位置。
  2. 在元件所在的地方修改它。 按鈕規則應寫入專案的 Button 中(一個 Token、一個變體、一個 prop 或其樣式),絕不能只在單一畫面上複製一份獨立的樣式。顏色或圓角規則應寫入 Token,而非硬編碼的值。
  3. 當已有元件可以完成工作時,絕不新增元件, 也絕不為了獲得 21 Grams UI 的效果而新增依賴(UI Kit、圖標集、圖表或動畫庫)。使用已安裝的東西。如果沒有動畫庫,就使用 CSS transitions。
  4. 當真的缺少某個元件時(例如沒有分段控制器、沒有開關),從專案既有的基礎元件與 Token 來建構它,並遵循專案的檔案佈局與命名方式。在報告中說明這一點。
  5. House-style 的值僅作為未定義時的預設值。 rules/ 與 tokens/tokens.css 為專案尚未決定的部分提供值。將它們映射到專案的 Token 上。絕不要在有現有系統的情況下貼上 tokens.css。
  6. 品牌維持專案的。 品牌顏色、字型、標誌、圖標風格與語調絕不替換。21 Grams UI 改變的是它們的使用方式(對比、層級、間距、動態),而不是它們本身。

優先順序: 使用者的話語 > 專案的設計系統與品牌 > 21 Grams UI 的 house-style。原則、設計駭客技巧與動畫工藝適用於所有地方,並以專案既有的元件來表達。

內容包含

  1. House-style。 rules/ 中的八個領域:radius.md(12/8/4 嵌套)、buttons.md(36px,.97 按壓)、motion.md(流暢,從觸發點開始,無彈跳)、type.md(緊湊,少量尺寸)、spacing.md(4pt 分組)、colour.md(一個強調色,AA 級別)、elevation.md(色調填充)、copy.md(直接且有幫助)。外加三個元件檔案:icons.md(單一風格,線條、實心或雙色,絕不混用)、charts.md(折線圖、長條圖與水平條)與 toggles.md(開關與分段控制器)。預設值在 tokens/tokens.css。
  2. 20 條原則。 references/principles.md 中的 UX 與動畫原則。
  3. 10 個設計駭客技巧。 references/design-hacks.md 中的 CSS 級工藝細節。
  4. 20 條動畫工藝。 references/animation-craft.md 中的實作級動態規則(起點、持續時間、交錯、按壓、拖曳、共享佈局)。
  5. 10 個排版駭客技巧。 references/typography.md 中的保留粗體寬度、text-box-trim、底線偏移、上標間距、流體顯示字體、小型大寫縮寫、彎引號、中間截斷、自動連字與行數限制標題。
  6. 20 條去 slop 規則。 references/unslop.md 中的構成與內容明顯痕跡(填充徽章、重複標籤、隨機斜體、裝飾性等寬字體、抽象英雄圖、同等權重的功能、模糊的標題、發光、光學對齊、載入狀態)。

如果安裝了資料視覺化技能,當涉及圖表時請一併載入它。

工作流程

  1. 進行盤點(規則零)。如果專案完全沒有設計系統,請說明並直接使用 house-style 的預設值。
  2. 在修改任何東西之前先進行審計。 瀏覽畫面或元件,並按領域(半徑…文案)、原則編號、駭客技巧編號與工藝編號分類列出發現的問題。使用 references/principles.md、references/design-hacks.md、references/animation-craft.md、references/typography.md、references/unslop.md 與 rules/icons.md 末尾的檢查清單。每個發現的問題都要包含:檔案與行號、問題說明、修復方式,以及修復應該進入哪個現有元件或 Token。標記每一個 21 Grams UI 規則與專案設計系統衝突的地方,以便使用者決定哪一個優先。
  3. 向使用者展示審計結果,以簡短的清單呈現,並在套用大範圍修改前徵求同意。在請求範圍內的小而明顯的修復可以直接進行。
  4. 按此順序套用修復: Token → 共享元件 → 頁面。保持 diff 的範圍僅限於審計過的內容,並遵循專案自身的慣例(格式化、lint、命名)。
  5. 在瀏覽器中驗證。 每個變更過畫面的前後對比截圖。檢查懸停、按壓、聚焦、載入、錯誤、兩種主題與減少動畫模式。測量按鈕與文字的對比度;不要只用目測。對於動態,盡可能錄製前後對比。一個帶有可拖曳分隔線且兩邊互動都能正常運作的前後對比頁面,是檢視 UI 提昇最清楚的方式。
  6. 報告按領域、原則、駭客技巧與工藝說明了哪些變更,觸及了哪些元件與 Token,以及還有哪些未完成的事項。

House-style 一覽(未定義時的預設值)

  • 半徑:容器 12 / 控制項 8 / 小零件 4,嵌套時為外層半徑減去內距。除了標籤與開關外,不使用藥丸形狀。
  • 按鈕:36px(緊湊 32,突出 40),半徑 8,字體 14/500,一個實心主要按鈕,每個視圖一個主要動作,懸停僅改變顏色層級,按壓 = 顏色層級 + scale(.97) 150ms,載入時保持寬度。
  • 動態:日常 UI 無彈跳。選單 220ms 進 / 175ms 出,從 scale(.95) 從觸發點開始,面板 240 / 190,進入 ease-out,退出 ease-in(約為進入時間的 80%),清單行交錯 30ms,頻繁互動立即。
  • 排版:使用專案的字型(若無則使用 Geist)。等寬字體僅用於程式碼,絕不用於標籤、眉毛、徽章、時間戳或數字(無襯線字體使用 tabular-nums 對齊數字)。尺寸 12/14/16/22/28,字重 400/500/600,標題 -0.022em,每個畫面最多四種尺寸。在手機上,標題提升一級:區塊 18,卡片 16。
  • 手機上的聊天發送是僅圖標的 44×44 紙飛機按鈕,附帶 aria-label="Send"。
  • 間距:4pt 標度。群組內部比群組之間更緊密(4 / 6 / 16 / 24–32 / 48)。選擇框的勾號距右側 12px,padding-right 36px。
  • 顏色:一個強調色(動作、焦點、選取),狀態顏色分開,按鈕文字在兩種主題下對比度 ≥ 4.5:1,每個主題都有 --on-accent。
  • 層級:靜止表面是一個填充層級,無邊框或陰影。只有浮動圖層才會有環與陰影。深色模式中每高一層就變亮。
  • 圖標:每個產品使用單一風格,線條、實心或雙色,絕不在選單、導航、工具列、清單或卡片中混用。選取狀態改變顏色,而不是圖標風格。一個圖標庫,一個筆畫寬度,每組一個尺寸。
  • 文案:動詞 + 受詞的按鈕,包含原因與修復方式的錯誤訊息,句子大小寫,無表情符號,無誇大用語。

不可妥協的事項(來自 20 條原則)

  • 使用者觸發的 UI 動態為 120–300ms,退出約為進入時間的 80%。絕不為移動使用 linear。
  • 緩動曲線與方向匹配:進入 ease-out,退出 ease-in,A→B 在同一個畫面 ease-in-out。日常 UI 無 overshoot。
  • 高頻互動(鍵盤導航、清單高亮、工具中的分頁)立即完成。
  • 每個輸入在 100ms 內得到回應。儲存時使用樂觀 UI。超過 400ms 時顯示進度。
  • 點擊區域:觸控至少 44×44,密集桌面至少 32×32,即使圖標本身較小。
  • 每個視圖一個焦點與一個主要動作。當某個元素獲得焦點時,調暗背景。
  • 長數字應分段顯示。輸入接受雜亂格式,並回顯清理後的值。
  • 除非有理由不這麼做,否則使用標準的放置位置與圖標。
  • 每個元件的狀態都需設計:閒置、懸停、按壓、載入、成功、錯誤、禁用。
  • prefers-reduced-motion:移除移動、縮放與 overshoot,保留一個簡短的透明度變化。

不可妥協的事項(來自 10 個設計駭客技巧)

  • 嵌套半徑:內層 = 外層 - 內距。
  • 邊框使用 Alpha 值(rgb(0 0 0 / .12)),絕不在不同表面上使用固態灰色十六進位色碼。
  • 調色盤與漸層使用 OKLCH(漸層上使用 in oklch)。
  • 圖標筆畫粗細與相鄰文字相符。
  • 水平滾動區在邊緣使用遮罩淡出。
  • 圖標切換時使用 filter: blur(4px) 進行交叉淡出。
  • 深色模式:每高一層就越亮(頁面 < 卡片 < 選單)。
  • 手機全高:使用 dvh/svh,絕不單獨使用 100vh。
  • 在有顏色背景的卡片上的白色背景產品照:使用 mix-blend-mode: multiply。

不可妥協的事項(來自 10 個排版駭客技巧)

  • 懸停或選取時變粗體絕不導致佈局偏移(保留粗體寬度)。
  • 按鈕與徽章中的單行標籤應光學置中(text-box-trim)。
  • 連結底線應清除下降部(text-underline-offset: 0.2em)。上標不破壞行高。
  • 文案中使用真正的標點符號:彎引號、撇號、連字號與破折號、省略號。
  • 結尾不同的名稱應中間截斷。網格中的卡片標題應限制為相同行數。

不可妥協的事項(來自 20 條動畫工藝)

  • 彈出框與選單從其觸發點展開(transform-origin 設在觸發點),從 scale(.95) 開始,絕不使用 scale(0),並從同一個觸發點退出。
  • 舊狀態與新狀態重疊。在「儲存」與「已儲存」之間絕不應有空白幀。
  • 拖曳在按住時 1:1 跟隨游標,無過渡,超出邊界時有橡皮筋效果。
  • 卡片→詳細頁面應展開同一個元素(共享 layoutId / 視圖過渡),絕非不相關的替換。
  • 分段控制器與分頁標籤應使用一個與指示器一同移動的遮罩來揭示作用中的標籤。
  • 移動的旋鈕約拉伸 12%(面積守恆)。成功時產生一次脈衝。

需要移除的 AI 痕跡

混合圖標風格(實心房子旁邊是線條資料夾,選取時線條圖標變成實心)、同一畫面使用兩個圖標庫、使用表情符號作為圖標、標題上方出現「NEW」填充藥丸、重複標題的眉毛、隨機一個斜體或等寬字體的字詞、等寬字體的標籤、眉毛、徽章、時間戳或數字(例如 // 01 STATUS 這種全大寫等寬字體)、使用亮面 3D 球體代替真實產品、一排等重的功能卡片、類似「X, meet Y.」的標題、發光的漸層邊框、靛藍到紫羅蘭的漸層、漸層文字、彩色發光陰影、所有地方都用相同的 16px 半徑(內外半徑相等)、藥丸形按鈕搭配圓角輸入框、卡片與按鈕在懸停時放大、所有動畫都是 300ms ease-in-out、頁面載入時淡入、統一的 p-6 gap-6、卡片中的卡片、每個區塊同時有陰影、邊框與圓角、所有次要文字都是 grey-500、標題中使用表情符號、以及「Unlock」、「Supercharge」、「Seamless」或「Oops!」這類文案。

致謝

這些原則、設計駭客技巧與動畫工藝是從五部短篇設計影片中改編與延伸而來:「20 Principles of UX & Animation」、「10 Niche Design Hacks」、「20 Ways to Make Beautiful AI Animations」、「10 Niche Typography Hacks」與「20 Ways to Unslop AI Designs」。詳細致謝請參閱 README。

相關技能