clone-design 是做什麼的?
先複製一個網站,然後將其混搭成專案專用的登陸頁面,或將其提煉成 DESIGN.md。
預設姿態:在 1:1 複本被驗證之前,保留來源網站呈現的佈局,不做任何創意偏移。只有在驗證之後,才可以為當前專案替換文案、圖像和品牌特定內容。
使用時機
當使用者要求以下事項時,使用此技能:
- 從網址複製一個網站或登陸頁面
- 在改編前先 1:1 複製一個登陸頁面
- 將另一個網站的登陸頁面轉換為當前本地專案的登陸頁面
- 用當前專案資料夾中的文案替換複製網站的文案
- 用專案相關的生成點陣圖資產替換複製的圖像
- 將網站轉換為
DESIGN.md - 萃取網站的設計系統
- 分析頁面的視覺語言
- 分析已登入的產品 UI 或工作區
- 綜合來自多個頁面或狀態的設計指引
- 將 UI 複本轉化為可重複使用的設計指引
- 直接將即時網址轉換為設計捆綁包
選擇模式
模式 A:登陸頁面混搭
當使用者想要複製另一個登陸頁面並將其改編為當前專案時使用。
流程:
URL -> 1:1 複本 -> 驗證的本地頁面 -> 專案文案映射 -> imagegen 資產 -> 最終登陸頁面
閱讀並遵循:
模式 B:設計系統萃取
當使用者想要 DESIGN.md、視覺語言分析或設計指引時使用。
流程:
URL 或 clone.html -> 擷取 -> design-md/<slug>/
閱讀並遵循:
- references/ui_clone_workflow.md
- references/multi_page_session_workflow.md 當登入、多個頁面或多個狀態有影響時
來源擷取規則
如果使用者提供網址:
- 不要要求使用者另外安裝或執行
frontend-ui-clone - 首先建立一個自包含的 HTML 快照
- 重複使用與
frontend-ui-clone相同的複製工作流程和保真度階梯 - 將來源素材儲存在
captures/<slug>/下 - 為每個擷取的頁面或狀態包含
clone.html - 在適當時加入螢幕截圖和 token 轉儲
- 在混搭或提煉前,先在瀏覽器中驗證複本
如果使用者提供本機 .html 檔案:
- 直接使用
- 接受單一檔案、多個檔案,或包含多個
clone.html檔案的擷取目錄
當網站依賴客戶端渲染時,避免從原始 HTTP 獲取來進行混搭或撰寫 DESIGN.md。
預設路徑
如果使用者未指定路徑:
擷取檔案:
- 單頁擷取資料夾:
captures/<slug>/ - 多頁擷取資料夾:
captures/<slug>/<page-slug>/ - 每頁檔案:
clone.html、homepage.png、live.json - 可選的站點層級擷取清單:
captures/<slug>/capture-plan.json
登陸頁面混搭輸出:
- 輸出資料夾:
landing-pages/<slug>/ - 最終頁面:
index.html - 驗證過的來源複本:
source-clone.html - 萃取的內容清單:
content-inventory.json - 產生的資產:
assets/generated/ - 規劃與 QA 檔案:
copy-map.jsonimage-plan.jsonqa/original-desktop.pngqa/clone-desktop.pngqa/final-desktop.png- 可選的行動裝置螢幕截圖
設計萃取輸出:
- 輸出資料夾:
design-md/<slug>/ - 輸出檔案:
DESIGN.mdREADME.mdpreview.htmlpreview-dark.html
- 可選的證據檔案:
evidence.json
1:1 複本標準
當輸入是網址時:
- 在可用時優先使用內建瀏覽器/Playwright 工具
- 使用與
frontend-ui-clone相同的預設視口和滾動策略 - 保留渲染後的 DOM、CSS、字型和解析後的資產 URL
- 保留原始 DOM 結構、類別名稱、區塊順序、間距、圓角、陰影、字體排印、漸層和響應式行為
- 在驗證的複本存在之前,不要重新設計、簡化、重塑品牌或重新佈局
- 如果頁面需要認證,讓使用者在瀏覽器中完成登入,並保持相同的瀏覽器上下文存活
- 登入後,在同一個工作階段中分別擷取每個請求的頁面或 UI 狀態
- 如果第一次擷取出現空白英雄區或明顯的覆蓋層問題,則應用與
frontend-ui-clone相同的升級思維:- 第 1 級:DOM + CSS 複製
- 第 1a 級:混合複製,帶有目標修正
- 第 1b 級:目標樣式烘焙
- 在大約
1440 x 900的解析度下進行桌面螢幕截圖 QA - 當頁面具有響應式時,在大約
390px的寬度下進行行動裝置螢幕截圖 QA - 在繼續之前修復可見的不匹配
除非使用者明確要求這種廣度,否則不要自動爬取整個已認證的應用程式。偏好一個精選的關鍵頁面或狀態集合。
混搭規則
將複製的登陸頁面改編為當前專案時:
- 在撰寫文案之前,檢查當前專案資料夾以獲取產品背景。偏好
README、PRODUCT.md、package.json、現有登陸頁面、文件、原始碼字串、螢幕截圖和品牌資產。 - 對驗證過的複本執行
scripts/extract_landing_inventory.py以初始化文字和圖片規劃。 - 建立一個從原始可見文字到替代文字的文案映射。保留相同的內容層級和近似文字長度,以使佈局保持完整。
- 將品牌名稱、標題、副標題、CTA、功能標籤、見證、常見問題文字和頁尾文案替換為專案相關的語言。
- 除非使用者明確要求結構變更,否則保留來源佈局、動畫時間、區塊順序和元件結構。
- 盤點點陣圖影像、英雄媒體、縮圖、頭像、產品模型和裝飾性照片。
- 當來源圖像不應保留時,使用
imagegen技能生成專案相關的點陣圖替代品。將生成的資產儲存到landing-pages/<slug>/assets/generated/並更新 HTML/CSS 引用。 - 偏好保留原始圖片尺寸、寬高比、裁切行為、object-fit、邊框圓角和視覺重量。
- 除非使用者要求,否則不要用生成的點陣圖取代簡單的 SVG 圖示、向量標記、CSS 漸層或幾何裝飾。
- 移除或替換第三方品牌標誌、名稱、螢幕截圖和商標,除非使用者明確希望為私人參考複本保留它們。
- 在文案和圖片替換後,在瀏覽器中驗證最終改編的頁面。修復文字溢出、損壞的圖片、行動裝置換行和佈局偏移。
DESIGN.md 生成
對於設計萃取模式,使用配套腳本:
python3 scripts/generate_design_md.py "$CLONE_HTML" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
對於多個擷取頁面:
python3 scripts/generate_design_md.py \
"captures/$SLUG/home/clone.html" \
"captures/$SLUG/workspace/clone.html" \
"captures/$SLUG/settings-modal-open/clone.html" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
或直接掃描擷取根目錄:
python3 scripts/generate_design_md.py \
--capture-dir "captures/$SLUG" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
當你沒有這些值時,省略可選旗標。
生成之後:
- 閱讀產生的
DESIGN.md - 緊縮模糊的措辭
- 保持 token 宣告基於來源
- 將不確定的陳述標記為推斷
切勿發明:
- 複本中不存在的顏色
- CSS 中未觀察到的字型家族
- 未萃取的中斷點
- 需要你未擷取的執行時期狀態的互動
- 針對你實際上未包含在工作階段中的頁面或流程的覆蓋範圍聲明
所需的 DESIGN.md 章節:
- 視覺主題與氛圍
- 色彩調色板與角色
- 字體排印規則
- 元件樣式
- 佈局原則
- 深度與層級
- 要點與禁忌
- 響應式行為
- 代理提示指南
最終回應
對於登陸頁面混搭模式,報告:
- 來源 URL
- 擷取資料夾和驗證過的複本路徑
- 最終登陸頁面資料夾和
index.html - 哪些專案檔案為替代文案提供了資訊
- 進行了多少次文案替換
- 建立了多少張生成的圖片以及它們的儲存位置
- 已執行的桌面/行動裝置瀏覽器驗證
- 任何限制,例如未擷取的互動或無法乾淨替換的資產
對於設計萃取模式,報告:
- 如果是從即時網址複製,則儲存擷取資料夾的位置
- 它是否包含一個
clone.html或多個具有各自clone.html的頁面資料夾,以及可選的homepage.png/live.json - 輸出資料夾的儲存位置
- 是否包含
DESIGN.md、README.md、preview.html和preview-dark.html - 如果產生了,
evidence.json的儲存位置 - 結果是來自強複本來源還是較弱的備用方案
- 最終綜合中包含多少個頁面或狀態
- 任何值得注意的限制