設計系統智慧技能
自動偵測專案類型,分析意圖,並從 60 多個參考模式中套用最優化的設計系統。
自動偵測觸發條件
此技能在以下情況啟用:
- 使用者建立/修改任何網頁專案檔案(HTML、CSS、JS、JSX、Vue、Svelte)
- 使用者說出「設計這個」、「讓它變好看」、「改善 UI」、「套用設計系統」
- 使用者提到特定類別:「登陸頁」、「儀表板」、「作品集」、「電子商務」
- 專案中未明確指定設計系統
第一階段:專案分析(自動化)
在選擇設計系統前,務必執行分析。
步驟 1:偵測專案類別
掃描專案檔案以判斷類型:
# 檢查指標
偵測 = {
'saas-landing': ['pricing', 'signup', 'features', 'hero', 'testimonials'],
'dashboard-app': ['dashboard', 'chart', 'table', 'sidebar', 'widget'],
'e-commerce': ['product', 'cart', 'checkout', 'shop', 'inventory'],
'portfolio': ['portfolio', 'gallery', 'project', 'creative', 'art'],
'content-publication': ['blog', 'article', 'post', 'content', 'newsletter'],
'brand-showcase': ['brand', 'story', 'about', 'mission', 'values'],
'developer-tool': ['api', 'docs', 'code', 'terminal', 'github'],
'service-business': ['service', 'contact', 'process', 'team', 'consulting']
}
步驟 2:分析當前狀態
檢查現有的設計 Token:
- CSS/SCSS/Tailwind 設定檔中的顏色
- 字體排版(font-family、font-size 宣告)
- 間距(margin、padding、gap 模式)
- 元件(按鈕 class、卡片 class)
步驟 3:比對設計系統庫
與 60 多個參考模式進行比對:
| 專案類型 | 推薦的設計系統 |
|---|---|
| SaaS 登陸頁 | linear.app、vercel.com、supabase.com、stripe.com、notion.so |
| 儀表板/應用程式 | linear.app (UI)、github.com、vercel.com/dashboard、supabase.com/dashboard |
| 電子商務 | apple.com、shopify.com、nike.com |
| 作品集 | framer.com、webflow.com、cargo.site |
| 內容/部落格 | medium.com、substack.com、stripe.com/blog |
| 開發者工具 | vercel.com、github.com、docs.rs、nextjs.org |
| 服務型企業 | cursor.com、intercom.com、webflow.com |
| 品牌/代理商 | tesla.com、apple.com、nike.com |
步驟 4:信心分數計算
計算匹配信心度:
信心度 = (
類別匹配 * 0.40 + # 內容是否相符?
Token 相似度 * 0.30 + # 顏色/字體排版重疊程度?
元件模式 * 0.20 + # 按鈕/卡片模式?
佈局結構 * 0.10 # Grid/flex 模式?
)
如果信心度 > 0.75:自動建議最匹配的項目
如果在 0.50-0.75 之間:提供 2-3 個替代方案
如果 < 0.50:詢問使用者偏好類別
第二階段:預檢協議
資產檢查清單
在套用任何設計系統之前:
-
檢查 project-context.md
- 專案根目錄中是否存在此檔案?
- 如果沒有:從範本建立,包含專案名稱、目標、目標受眾
-
分析當前資產
# 自動執行 python3 ~/.claude/skills/design-systems/scripts/inspect-project.py檢查項目:
- Logo 是否存在?(偏好 SVG)
- 產品圖片?(Hero 區塊用的透明 PNG?)
- 顏色配置是否已定義?
- 字體排版是否已設定?
- 是否有現成的元件庫?
-
決定構成層級
- Hero 元素:最大的視覺元素(產品照、插圖、標題)
- 支援元素:功能、效益、社交證明
- 強調元素:裝飾性元素、模式
-
驗證技術限制
- 偵測到的框架(React、Vue、原生等)
- CSS 方法(Tailwind、CSS-in-JS、SCSS 等)
- 動畫能力(是否載入 GSAP?Framer Motion?)
- 效能預算(行動優先?桌上型電腦優先?)
第三階段:設計系統套用
步驟 1:選擇與載入
根據分析,載入推薦的 DESIGN.md:
推薦:Linear.app 設計系統
信心度:87%
匹配原因:
- 偵測到 SaaS 登陸頁(有定價、功能區塊)
- 偵測到深色模式偏好
- 找到乾淨的字體排版(類似 Inter)
- 存在卡片式佈局模式
步驟 2:適應專案
不要直接複製貼上原始內容。 根據專案分析進行適應:
顏色:
- 如果專案已有品牌顏色:對應到設計系統的角色
- 如果沒有顏色:直接使用設計系統的調色盤
- 範例:「你的藍色 #3B82F6 → 主要強調色角色」
字體排版:
- 如果使用 Inter/系統字型:保留設計系統的級別
- 如果使用不同字型:適應尺寸/粗細
- 範例:「Roboto 取代 Inter → 調整粗細 400→500」
間距:
- 檢查現有的間距級別
- 對應到設計系統,若一致性夠則保留
元件:
- 將現有 class 對應到設計系統模式
- 範例:「你的 .btn-primary → 設計系統的主要按鈕」
步驟 3:實作檢查清單
按優先順序套用設計系統:
-
基礎(關鍵)
- 對應顏色的 CSS 變數
- 定義字體排版級別
- 建立間距系統
- 套用基礎重置/標準化
-
佈局(高)
- 區塊間距(Hero、內容、頁尾)
- 容器寬度(max-width、padding)
- Grid 系統(如適用)
-
元件(中)
- 按鈕(主要、次要、幽靈)
- 卡片(如有使用)
- 表單/輸入框(如有使用)
- 導覽(頁首、頁尾)
-
潤飾(低)
- 陰影/層級
- 邊角圓角一致性
- 焦點狀態
- 懸停過渡效果
第四階段:驗證
品質閘門
套用後執行:
視覺一致性檢查:
# 檢查違規情況
違規清單 = []
# 1. 顏色數量
if 唯一顏色數量 > 8:
違規清單.append("顏色過多 - 請簡化調色盤")
# 2. 字體大小級別
if 字體大小數量 > 12:
違規清單.append("字體排版缺乏系統性 - 請統一大小的級別")
# 3. 間距一致性
if 間距基準 not in [4, 8, 16]:
違規清單.append("間距未遵循 4/8px 網格")
# 4. 觸控目標
if 觸控目標 < 44:
違規清單.append("觸控目標小於 44px")
無障礙檢查:
- 文字顏色對比度 >= 4.5:1
- 焦點指示器可見
- 尊重減少動畫設定
- 必要處加上 ARIA 標籤
效能檢查:
- 無造成佈局震盪的動畫
- 圖片已最佳化
- 字型已子集化(若是自訂字型)
參考資料
設計系統分析
- category-detection.md - 如何偵測專案類型
- token-extraction.md - 提取現有設計 Token
- matching-algorithm.md - 信心分數計算邏輯
適應指南
- color-adaptation.md - 將現有顏色對應到設計系統
- typography-adaptation.md - 字型家族替代
- spacing-adaptation.md - 間距系統對應
- component-mapping.md - Class 名稱轉換
驗證
- quality-gates.md - 11 條不可協商的規則
- accessibility-checks.md - 無障礙驗證
- performance-checks.md - 效能預算
類別特定模式
- saas-landing.md - SaaS 登陸頁模式
- dashboard-app.md - 儀表板 UI 模式
- e-commerce.md - 產品/電子商務模式
- portfolio.md - 創意作品集模式
- content-site.md - 部落格/內容模式
腳本
scripts/analyze-project.py— 偵測類別、當前 Tokenscripts/match-design-system.py— 與庫進行比對scripts/validate-application.py— 品質閘門scripts/generate-adaptation.py— 將現有內容對應到設計系統scripts/inspect-assets.py— 檢查圖片、Logo、品牌資產
設計系統庫
../design-systems/ 中按類別整理的 60 多個系統:
SaaS / 開發者工具
- linear.app(深色、Inter、粗細 510)
- vercel.com(Geist、邊框陰影)
- supabase.com(溫暖、受 PostgreSQL 啟發)
- stripe.com(內容豐富、漸層)
- notion.so(友善、圓角)
- github.com(功能導向、緊湊)
- cursor.com(編輯器專注、語法顏色)
電子商務 / 產品
- apple.com(SF Pro、二元對比、藥丸形 CTA)
- shopify.com(極化、Polaris Token)
- nike.com(大膽、動態、圖片優先)
創意 / 作品集
- framer.com(趣味、漸層、彈性)
- webflow.com(專業、結構化)
內容 / 出版
- medium.com(閱讀優先、襯線內文)
- substack.com(溫暖、以電子報為中心)
企業
- ibm.com(Carbon 設計、系統化)
- salesforce.com(功能導向、緊湊)
汽車 / 精品
- tesla.com(極簡、產品為中心)
- ferrari.com(戲劇化、紅色強調)
- bmw.com(技術、精準)
使用流程
使用者:「為我的 SaaS 建立一個登陸頁」
↓
技能:分析專案...
偵測到:SaaS 登陸意圖
目前狀態:無設計系統
↓
技能:推薦 linear.app(87% 匹配度)
提供替代方案:vercel.com、stripe.com
↓
使用者:「使用 Linear 風格」
↓
技能:執行預檢協議
- 建立 project-context.md
- 分析資產
- 檢查技術堆疊
↓
技能:套用 Linear 設計系統
- 對應顏色 Token
- 設定字體排版級別
- 實作元件
↓
技能:驗證輸出
- 顏色對比度檢查
- 間距一致性
- 品質閘門審查
↓
輸出:具備 Linear 靈感設計的專案
設定
在專案根目錄建立 .design-system 來覆蓋自動偵測:
{
"system": "linear.app",
"theme": "dark",
"adaptations": {
"primaryColor": "#3B82F6",
"fontFamily": "Inter"
}
}
此技能將你的 60 多個設計系統集合與史詩級工作流程結合:自動偵測、預檢、驗證和智慧適應。