前端樣式提取器 是做什麼的?
目標
從原始前端產生一個有證據支持、與框架無關的可攜式設計系統套件 v1.0.0。輸出是供 frontend-style-adapter 使用的交接合約,而不是複製原始碼,也不是完美像素的複製品。
在撰寫套件之前,請先閱讀 references/CONTRACT.md。在檢查時,請閱讀 references/INSPECTION_CHECKLIST.md。不要虛構樣式值,也不要將推斷出的模式陳述為觀察到的事實。
輸入
- 來源:儲存庫根目錄/工作區、選定目錄,或一個可存取的已渲染網站。
- 可選:特定頁面/元件、主題、中斷點、設計保真度、輸出路徑。
- 預設值:來源 = 目前儲存庫;範圍 = 代表性的共享 UI + 儲存庫中可發現的路由/頁面;輸出 = 原始儲存庫中的
design-system/portable/(除非使用者要求其他位置)。 - 不包含可存取原始 CSS 或計算樣式的公開 URL 是純視覺來源。除非可以透過工具測量,否則標記為推斷的像素/顏色/間距測量值。如果環境無法開啟網站,請解釋限制,而不是憑空捏造分析結果。
工作流程
- 在不改變原始碼的情況下進行定向。 檢查 git 狀態、專案結構、套件清單、框架和樣式棧、路由/頁面結構、全域樣式、主題提供者、元件庫和設計代碼。尊重
AGENTS.md和儲存庫說明。絕不讀取.env、機密或不相關的資料。 - 執行可選的啟發式清單(僅限 stdlib;非權威 CSS 解析器):
python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json如果可能,請在儲存庫之外使用臨時路徑。閱讀摘要;直接在程式碼/渲染的 UI 中驗證重要聲明。 - 對代表性 UI 進行取樣: 全域外殼、導航、標題/文字、按鈕、欄位/表單、卡片、表格、彈出視窗、提示、載入/空白/錯誤狀態;檢查桌面和行動版、hover/focus/disabled、深色/淺色(如果支援)。取樣常見和不常見的路由。記錄已檢查和跳過的表面。
- 解析規則層級: 明確的代碼/設定 → 共享元件 → 重複的頁面模式 → 一次性例外情況。不要將單一頁面的佈局誤認為全域規則。保留語義代碼和別名(例如
var(--brand-primary)),如果它們有意義;只有在驗證過時才陳述實際解析後的值。 - 記錄溯源: 每個代碼和每個結構化規則都需要
origin、confidence和具體的evidence。優先使用檔案路徑 + 行號/符號、計算樣式觀察或螢幕截圖/視窗參考。每個不支援的推斷都必須如此標記。說明任何限制、未檢查的頁面、依賴項/資產授權的不確定性。 - 在選擇的輸出路徑撰寫套件。 必要檔案:
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/了解形狀;用特定於來源的觀察結果取代所有範例內容。使用可攜式語言(元件合約和設計意圖),而不是僅以特定框架的實作來描述。 - 驗證:
python3 <skill-root>/scripts/validate_bundle.py <bundle-path>。修復所有錯誤。手動檢查未知/低可信度項目。如果未執行瀏覽器/螢幕截圖比較,請不要聲稱已測試視覺保真度。 - 報告: 檢查的來源和表面、框架/樣式方法、輸出路徑、代碼/規則計數、覆蓋範圍/不確定性、驗證器結果,以及交接使用方式:使用設計系統路徑調用
frontend-style-adapter。
硬性約束
- 提取設計語言,而不是商業邏輯、副本、專有資產或實作細節。
- 不要修改應用程式原始碼、安裝套件、重寫設定或自動提交。允許建立要求的套件。
- 除非使用者明確授權且權利明確,否則不要將標誌、字型二進位檔案、授權圖片/圖示複製到套件中;取而代之,描述它們的外觀、原始參考和授權注意事項。
- 不要轉移
.env、憑證、使用者資料、即時 API 回應或秘密。 - 如果存在,請保留獨立的深色/淺色主題和響應式規則;不要將它們扁平化為單一樣式。
- 確切的實作細節應屬於
evidence/註釋;需求應保持跨框架可攜。 - 清晰度重於數量:高價值的記錄模式勝過數百個不支援的代碼。
- 如果沒有可執行的 UI/瀏覽器,請在 manifest 中報告
visualVerification: "not_performed“。
完成條件
套件通過驗證;每個匯出的事實都可追溯;全域規則與例外情況分開;已處理無障礙/響應式狀態;報告說明已知差距。