Communitygithub.com

設計系統

用於開始建立設計系統、樣式指南或代幣集,新增或更改元件或代幣,標準化已偏離的畫面,或稽核指南中是否存在鬆散的顏色、一次性元件、遺失狀態或不符合規範的畫面。

設計系統 是什麼?

此技能引導 AI 代理建立、修改或稽核設計系統。它強調分層構建(先建立基礎,再建立元件),並在每一層完成後要求使用者批准,以避免重工。技能明確區分了「新增或更改」與「稽核」兩種模式:新增或更改時,需先檢查現有元件是否能透過變體滿足需求,更新所有受影響的畫面,並在傳播前獲得批准;稽核時,則需按照稽核清單生成報告,但絕不自動修復問題,所有修復都必須經過使用者選擇。此技能支援 Paper、Figma 和 HTML 等工具,並維護一份強制性的規則清單(如「所有顏色必須是代幣」、「每個互動元件都需有狀態矩陣」)和預設行為(如懸停效果、焦點環的顯示時機)。最終交付物依模式而異:建立模式需有已批准的基礎和元件;更改模式需更新所有清單上的位置;稽核模式則只需提供一份分級報告,不修改任何檔案。

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

在你喜歡的 AI 中提問

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

說明文件

設計系統 是做什麼的?

概述

設計系統是一個決策只做一次、然後到處重複使用的地方。每個顏色都是一個代幣,每個互動元件都顯示其所有狀態,而每項變更都會觸及所有使用該元件的畫面。按層次構建,先建立基礎,並在每一層停下來等待批准。稽核只報告,絕不自行修復。

使用時機

  • 「為……開始建立樣式指南 / 設計系統 / 代幣」
  • 新增元件、變體或代幣,或更改現有項目。
  • 「讓這些畫面一致」、「標準化」、「稽核指南」,或畫面中存在鬆散的十六進位顏色值和一次性元件。

不應使用的情況

  • 關於某個值的問題(「我們的主色是什麼?」):直接回答它。
  • 使用者準確描述的一個小編輯(一個值、一個標籤、一個尺寸),即使是在共享元件上:在其定義處更改一次,並說明影響哪些畫面。不需要狀態矩陣,也無需停止。

開始之前

  1. 如果專案根目錄存在 DESIGN.md,請閱讀它:這是專案的設計簡報。
  2. 找出已存在的內容:代幣、指南、元件、畫面和程式碼。現有的指南在視覺外觀上具有最高權威。 即使與下面的預設值不同,也要遵循其規則,並指出差異一次。
  3. 在 references/adapters/ 中選擇你工具的轉接器(paper.md、figma.md、html.md)。如果沒有轉接器符合你的工具,請在你的工具中執行相同的操作,並說明哪些是你手動映射的。如果完全沒有設計工具,則使用 HTML 構建(html.md)。如果你只有一張圖片,請說明從中讀取的值均為估計值。
  4. 決定模式:建立、新增或更改,或稽核。

步驟 · 建立

  1. 基礎草稿:

    • 顏色角色(參見 代幣角色);
    • 字體比例;
    • 間距;
    • 圓角;
    • 陰影(最多兩個);
    • 佈局寬度;
    • 動畫持續時間;
    • 簡短的「寫作風格」部分。

    依照角色命名代幣(如 text-muted、border-hover、danger-bg),絕不要僅按值命名(如 gray-500)。

  2. 互動規則(一次設定): 針對有邊框元件、無邊框元件和主要操作,寫下其懸停、按下、焦點(僅限鍵盤)、禁用、載入和選中狀態的外觀。每個元件都應遵循這些規則,而不是各自發明一套。

  3. 停下來,向使用者展示基礎草稿和互動規則。 在獲得批准前,不要構建元件。

  4. 一次一個元件,按照第一個畫面所需的順序。 每個元件在指南中都應有一個章節,內容包含元件解剖:包含規則及其原因的圖例、範例,以及一個 變體 × 狀態 的狀態矩陣。將每個元件加入元件索引中。

步驟 · 新增或更改元件

  1. 檢查現有元件加上一個變體是否能滿足需求。優先考慮重用,而非建立一次性元件。
  2. 使用解剖結構繪製它,包括完整的狀態矩陣。新的顏色、尺寸或圖示應立即成為代幣或圖示集條目,而不是以後再說。
  3. 列出所有使用該元件的畫面和程式碼位置。
  4. 停下來,向使用者展示這個變更和那份清單。
  5. 獲得批准後,進行傳播:
    • 更新清單上的每個畫面;
    • 更新程式碼(如果有的話);
    • 更新元件索引;
    • 報告哪些地方發生了什麼變更。

步驟 · 稽核

  1. 對指南、畫面及任何程式碼執行稽核檢查清單。
  2. 撰寫報告:按嚴重性排序調查結果,每個結果需說明位置、重要性以及建議的修復方法。
  3. 停下來,向使用者展示報告。在他們指定要修復哪些問題之前,不要更改任何檔案。 保存原始檔案的副本並不能使編輯它們變得可接受。

規則

嚴格規則(任何專案均適用):

規則原因
所有顏色都是代幣;畫面和程式碼中不得有鬆散的十六進位值鬆散的值會逐漸變成近似的重複項,導致無法一次性更改
僅使用一個圖示集混用圖示集看起來像混合了不同的產品
設計與程式碼同步更改,且設計優先否則指南會在一週內失去真實性
每個互動元件都須有狀態矩陣臨時繪製的狀態永遠無法協調一致
對共享元件的更改,在傳播前需列出受影響的畫面否則一次「小」更改會悄無聲息地重新設計二十個畫面

預設值(現有指南可覆蓋它們):

預設值原因
懸停時,有邊框元件僅加深邊框顏色卡片和欄位上的背景變化會顯得很沉重
懸停效果應比選中效果更微妙當懸停看起來像選中時,使用者會以為選了兩個東西
選中時切勿改變字體粗細粗細變化會改變文字的寬度
佔位文字比淺色文字更淺否則佔位文字會被誤讀為已輸入的文字
堆疊列表和選單中的項目應有細微間距,不可相連相連的選中高亮會合併成一個色塊
焦點環僅在鍵盤操作時出現滑鼠點擊後出現焦點環看起來像一個錯誤
載入狀態保持元素原有尺寸避免佈局偏移
陰影僅用於浮動元素(選單、彈出視窗、對話框、提示訊息),分為兩種強度到處使用陰影會破壞它們本應創造的層級
每個畫面最多一個主要操作按鈕兩個主要按鈕表示畫面沒有做出決定

完成條件

  • 建立: 基礎和互動規則已獲批准;每個元件都有其解剖結構、狀態矩陣和索引條目。
  • 更改: 清單上的每個畫面和程式碼位置都已更新,並且索引也已更新。
  • 稽核: 已交付一份分級報告,且未更改任何檔案。

常見錯誤

想法現實
「我會一次性建立整個指南:代幣和十個元件」在未經批准的基礎上建立十個元件意味著十次重做。先建立基礎,得到批准,再建立元件。
「稽核發現了問題,我直接修復就好了」使用者可能不同意其中一半的修復方案。先報告,停下來,只修復他們選擇的。
「我把原始檔案備份了,所以修復是安全的」備份並不能讓使用者同意你的修復。先報告。
「按鈕有懸停和禁用狀態,夠了」狀態矩陣應包含每個狀態 × 每個變體:普通、懸停、按下、焦點、禁用、載入、選中。
「--teal-600 就是一個代幣」它只是一個值。元件需要角色(如 --color-primary),這樣值才能在一處修改。
「這個畫面需要一個略有不同的卡片」將其製作為卡片的變體,或者直接使用卡片。一次性元件是偏離的開始。

相關技能