Communitygithub.com

前端樣式提取器

從現有 Web 應用程式或可存取的網站中,提取並記錄可攜式前端設計系統的設計技能。當需要分析 UI 樣式、設計代碼、排版、佈局、元件、互動、響應式,或為其他專案產生可重複使用的樣式規則時使用。不會重新設計、修改或遷移原始應用程式。

前端樣式提取器 是什麼?

前端樣式提取器是一項 AI 代理技能,專門從現有前端應用程式或可存取的網站中,系統性地逆向工程並記錄一個可攜式、與框架無關的設計系統。它會產生一組結構化文件(稱為「可攜式設計系統套件」),包括以下關鍵要素:配色代碼、排版規則、佈局模式、元件合約、互動規則和響應式原則。這些輸出專為供另一個技能「前端樣式適配器」使用而設計,作為設計交接合約,而非原始碼的直接複製或完美像素的複製品。 此技能廣泛適用於各種代理平台,包括 Claude Code、Cursor 和 Codex,並支援從多種來源進行分析,例如本機儲存庫根目錄、特定目錄或已渲染的網站 URL。其工作流程強調嚴謹性:技能會先梳理現有程式碼和樣式,執行可選的庫存腳本,對代表性 UI 表面(如導航、按鈕、表單和卡片)進行取樣,解析規則層級(從明確的代碼到元件再到一次性例外情況),並記錄每個發現項的詳細溯源資訊,包括出處、可信度和具體證據。 此技能嚴格遵守多項硬性約束:它提取的是設計語言(而非商業邏輯、機密內容或授權素材),不會修改原始應用程式,並保留獨立的深色/淺色主題和響應式規則。最後的套件會經過驗證腳本檢查,並生成一份詳細報告,說明已檢查的來源、框架和樣式方法、確切輸出、計數統計以及已知的限制。如果沒有可用的瀏覽器或可執行的 UI,它會如實報告視覺驗證未執行,而不是憑空捏造分析結果。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

在你喜歡的 AI 中提問

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

說明文件

前端樣式提取器 是做什麼的?

目標

從原始前端產生一個有證據支持、與框架無關的可攜式設計系統套件 v1.0.0。輸出是供 frontend-style-adapter 使用的交接合約,而不是複製原始碼,也不是完美像素的複製品。

在撰寫套件之前,請先閱讀 references/CONTRACT.md。在檢查時,請閱讀 references/INSPECTION_CHECKLIST.md。不要虛構樣式值,也不要將推斷出的模式陳述為觀察到的事實。

輸入

  • 來源:儲存庫根目錄/工作區、選定目錄,或一個可存取的已渲染網站。
  • 可選:特定頁面/元件、主題、中斷點、設計保真度、輸出路徑。
  • 預設值:來源 = 目前儲存庫;範圍 = 代表性的共享 UI + 儲存庫中可發現的路由/頁面;輸出 = 原始儲存庫中的 design-system/portable/(除非使用者要求其他位置)。
  • 不包含可存取原始 CSS 或計算樣式的公開 URL 是純視覺來源。除非可以透過工具測量,否則標記為推斷的像素/顏色/間距測量值。如果環境無法開啟網站,請解釋限制,而不是憑空捏造分析結果。

工作流程

  1. 在不改變原始碼的情況下進行定向。 檢查 git 狀態、專案結構、套件清單、框架和樣式棧、路由/頁面結構、全域樣式、主題提供者、元件庫和設計代碼。尊重 AGENTS.md 和儲存庫說明。絕不讀取 .env、機密或不相關的資料。
  2. 執行可選的啟發式清單(僅限 stdlib;非權威 CSS 解析器): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json 如果可能,請在儲存庫之外使用臨時路徑。閱讀摘要;直接在程式碼/渲染的 UI 中驗證重要聲明。
  3. 對代表性 UI 進行取樣: 全域外殼、導航、標題/文字、按鈕、欄位/表單、卡片、表格、彈出視窗、提示、載入/空白/錯誤狀態;檢查桌面和行動版、hover/focus/disabled、深色/淺色(如果支援)。取樣常見和不常見的路由。記錄已檢查和跳過的表面。
  4. 解析規則層級: 明確的代碼/設定 → 共享元件 → 重複的頁面模式 → 一次性例外情況。不要將單一頁面的佈局誤認為全域規則。保留語義代碼和別名(例如 var(--brand-primary)),如果它們有意義;只有在驗證過時才陳述實際解析後的值。
  5. 記錄溯源: 每個代碼和每個結構化規則都需要 origin、confidence 和具體的 evidence。優先使用檔案路徑 + 行號/符號、計算樣式觀察或螢幕截圖/視窗參考。每個不支援的推斷都必須如此標記。說明任何限制、未檢查的頁面、依賴項/資產授權的不確定性。
  6. 在選擇的輸出路徑撰寫套件。 必要檔案:manifest.json、tokens.json、rules.json、README.md、typography.md、layout-rules.md、component-rules.md、interaction-rules.md、responsive-rules.md。可選 assets.md,用於圖示/圖片/字型的考量。請參閱 references/CONTRACT.md 和 assets/example-bundle/ 了解形狀;用特定於來源的觀察結果取代所有範例內容。使用可攜式語言(元件合約和設計意圖),而不是僅以特定框架的實作來描述。
  7. 驗證: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>。修復所有錯誤。手動檢查未知/低可信度項目。如果未執行瀏覽器/螢幕截圖比較,請不要聲稱已測試視覺保真度。
  8. 報告: 檢查的來源和表面、框架/樣式方法、輸出路徑、代碼/規則計數、覆蓋範圍/不確定性、驗證器結果,以及交接使用方式:使用設計系統路徑調用 frontend-style-adapter。

硬性約束

  • 提取設計語言,而不是商業邏輯、副本、專有資產或實作細節。
  • 不要修改應用程式原始碼、安裝套件、重寫設定或自動提交。允許建立要求的套件。
  • 除非使用者明確授權且權利明確,否則不要將標誌、字型二進位檔案、授權圖片/圖示複製到套件中;取而代之,描述它們的外觀、原始參考和授權注意事項。
  • 不要轉移 .env、憑證、使用者資料、即時 API 回應或秘密。
  • 如果存在,請保留獨立的深色/淺色主題和響應式規則;不要將它們扁平化為單一樣式。
  • 確切的實作細節應屬於 evidence/註釋;需求應保持跨框架可攜。
  • 清晰度重於數量:高價值的記錄模式勝過數百個不支援的代碼。
  • 如果沒有可執行的 UI/瀏覽器,請在 manifest 中報告 visualVerification: "not_performed“。

完成條件

套件通過驗證;每個匯出的事實都可追溯;全域規則與例外情況分開;已處理無障礙/響應式狀態;報告說明已知差距。

相關技能