Communitygithub.com

Cozythecoder/frontend-design-md

自動偵測專案類型,分析意圖,並從 60 多個參考模式中套用最優化的設計系統。

frontend-design-md 是什麼?

這項技能能自動分析你的前端專案,從 60 多個精選的設計系統參考模式(如 Linear.app、Vercel、Apple 等)中,為你推薦並套用最合適的設計系統。首先會分析專案類型(SaaS 登陸頁、儀表板、電子商務等),接著檢查現有的設計 Token(顏色、字體、間距、元件),然後根據信心分數進行比對。套用前會執行「預檢協議」,確認資產(LOGO、圖片)和技術限制(框架、動畫能力),最後套用時會根據專案的品牌色彩和字體進行適應性調整,而非直接複製貼上。此技能支援 HTML、CSS、JS、React、Vue 等常見 Web 技術,並內建品質驗證機制,確保視覺一致性、無障礙性和效能。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

在你喜歡的 AI 中提問

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

說明文件

設計系統智慧技能

自動偵測專案類型,分析意圖,並從 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:詢問使用者偏好類別

第二階段:預檢協議

資產檢查清單

在套用任何設計系統之前:

  1. 檢查 project-context.md

    • 專案根目錄中是否存在此檔案?
    • 如果沒有:從範本建立,包含專案名稱、目標、目標受眾
  2. 分析當前資產

    # 自動執行
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    檢查項目:

    • Logo 是否存在?(偏好 SVG)
    • 產品圖片?(Hero 區塊用的透明 PNG?)
    • 顏色配置是否已定義?
    • 字體排版是否已設定?
    • 是否有現成的元件庫?
  3. 決定構成層級

    • Hero 元素:最大的視覺元素(產品照、插圖、標題)
    • 支援元素:功能、效益、社交證明
    • 強調元素:裝飾性元素、模式
  4. 驗證技術限制

    • 偵測到的框架(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:實作檢查清單

按優先順序套用設計系統:

  1. 基礎(關鍵)

    • 對應顏色的 CSS 變數
    • 定義字體排版級別
    • 建立間距系統
    • 套用基礎重置/標準化
  2. 佈局(高)

    • 區塊間距(Hero、內容、頁尾)
    • 容器寬度(max-width、padding)
    • Grid 系統(如適用)
  3. 元件(中)

    • 按鈕(主要、次要、幽靈)
    • 卡片(如有使用)
    • 表單/輸入框(如有使用)
    • 導覽(頁首、頁尾)
  4. 潤飾(低)

    • 陰影/層級
    • 邊角圓角一致性
    • 焦點狀態
    • 懸停過渡效果

第四階段:驗證

品質閘門

套用後執行:

視覺一致性檢查:

# 檢查違規情況
違規清單 = []

# 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 標籤

效能檢查:

  • 無造成佈局震盪的動畫
  • 圖片已最佳化
  • 字型已子集化(若是自訂字型)

參考資料

設計系統分析

適應指南

驗證

類別特定模式

腳本

  • scripts/analyze-project.py — 偵測類別、當前 Token
  • scripts/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 多個設計系統集合與史詩級工作流程結合:自動偵測、預檢、驗證和智慧適應。

相關技能