cnproduct/1-1website-skill

1:1網站復刻技能 — 像素級全站與全量商品目錄復刻大師技能

定位：將「逆向取證級 DOM/CSS 採集 + Akamai/Cloudflare 真機穿透 + 全品類商品爬蟲與本地化落盤 + 1:1 交互商城重構 + 自動化排版/SEO/多視口視覺 QA」濃縮為單一封閉迴圈的終極 1:1 網站復刻技能。

---

一、 技能融合架構（6 大底層能力合一）

本技能將以下 6 個本地與 GitHub 頂尖技能的核心能力融為一體，解決單一技能無法兼顧「高防網站穿透」、「懶加載原圖提取」、「全品類商品批量入庫」與「像素級靜態/動態交互還原」的痛點：

模組來源	核心職責	在本技能中的固化階段
1. Jane-xiaoer/claude-skill-web-clone	5 階段取證工作流、DOM 語義樹映射、區塊級 1:1 視覺還原	Phase 1（DOM 區塊測繪）& Phase 7（多滾動位截圖對比）
2. ericshang98/perfect-web-clone-skill	瀏覽器 getComputedStyle 精確 Token 提取、DESIGN.md 契約、吸頂導航狀態機	Phase 1（CSS 精確提取）& Phase 4（設計規範合成）
3. ego-browser (Real Chromium Engine)	穿透 Akamai (HTTP 403) / Cloudflare、自動關閉鎖屏彈窗、瀏覽器上下文 page.fetch 下載	Phase 1 ~ Phase 3（全真機環境採集與零 403 資產落盤）
4. renwork-web-create-skill (Mode B v3)	零佔位圖鐵律（Zero Placeholder Policy）、SEO/GEO (sitemap.xml/robots.txt/llms.txt) 自動化	Phase 2（100% 本地資產）& Phase 6（SEO/GEO 生成）
5. wideway-export-site-builder-skill	全量商品目錄視圖（PLP）、分屏商品詳情頁（PDP）、購物袋、願望清單與前端商品上傳 CMS	Phase 5（全站商品交互商城與在線上傳引擎）
6. layout-typography-auditor	單一 <h1> 校驗、語義化交互標籤（杜絕 <div onclick>）、表單 autocomplete、:focus-visible 審計	Phase 6（靜態程式碼品質與無障礙 0 錯誤閘門）

---

二、 鐵律與紅線（Non-Negotiable Rules）

1. 嚴禁直接 curl / urllib 裸抓高防站點：遇到 Akamai（如 us.louisvuitton.com）、Cloudflare 等防護返回 403 Forbidden 時，必須全程透過 ego-browser 的真機頁面執行 DOM 提取與 page.fetch(url, { saveAs }) 本地儲存。
2. 彈窗解鎖先行（Modal & Scroll Unlock First）：首次打開目標站點後，必須先檢測並點擊關閉地區切換彈窗（如 .lv-modal__container button.lv-modal__close）、Cookie 遮罩或訂閱彈窗，並驗證 window.scrollTo(0, 500) 能夠真實改變 window.scrollY，防止截取到鎖屏半透明遮罩或空白懶加載區。
3. 穿透懶加載提取 4K/高清晰原圖：針對 <picture> 動態 data-srcset 或 <noscript><img src="..."></noscript>，必須編寫腳本優先解析高清晰源 URL（如 ?wid=2048 / ?wid=1090），嚴禁抓取 1x1 base64 佔位符。
4. 100% 本地化資產與全量產品入庫：所有首頁海報、分類封面、全品類商品工作室白底/灰底圖（PNG/JPG）必須下載至本地 assets/images/ 與 assets/products/，所有官方圖示與 Logo 必須內聯原版 <svg viewBox="...">，嚴禁使用任何外部防盜鏈 URL 或通用圖庫（Unsplash/Pexels）替代。
5. 隔離工作區保護：若當前工作區已有存量業務程式碼，必須在獨立子目錄（如 <brand>-clone/）中構建完整專案，嚴禁覆蓋根目錄既有檔案。

---

三、 標準 7 步像素級復刻全流程（7-Phase Pipeline）

Phase 1: 真機取證偵察與彈窗穿透 (scripts/recon_and_harvest.mjs)

1. 啟動 ego-browser TaskSpace，設定桌面視口 1440×900。
2. 導航至目標 URL，自動檢測並關閉 Country/Region 模態框與 Cookie 橫幅，移除 body 滾動鎖。
3. 分段滾動觸發全頁懶加載，提取：
   • RECON/original-recon.json & RECON/homepage-blocks.json：全頁所有 Section 的標題、副標題、CTA 連結、網格列數與精確座標。
   • RECON/css-spec.json：透過 getComputedStyle 提取 Header、Hero、Section 標題、Product Card、Footer 的精確字型大小、行高、字距、內邊距、背景漸層與邊框色。
   • RECON/svgs.json：提取全站原版向量 SVG（品牌 Wordmark、搜尋、願望清單、購物袋、關閉、箭頭、社交圖示）。
4. 沿頁面高度按固定步長（如 0, 720, 1660, 2450, 3150, 3920, 4630, 5400, 6100）利用 page.cdp("Page.captureScreenshot") 截取無彈窗高清晰基準圖 RECON/screenshots/original-clean-{y}.png。

Phase 2: 首頁全量高清晰媒體資產下載 (assets/images/)

1. 解析首頁所有 Hero 大片、品類網格圖、推薦單品透明 PNG 及品牌故事豎圖。
2. 在 ego-browser 內呼叫 page.fetch(url, { saveAs }) 將全部圖片儲存至 assets/images/，校驗每個檔案位元組數 > 1KB。

Phase 3: 全站多品類商品爬蟲與批量上傳入庫 (scripts/crawl_all_categories.mjs)

1. 提取首頁及導航選單關聯的所有核心品類 URL（如 womens-bags, womens-slg, womens-accessories, womens-shoes, mens-bags, mens-slg, mens-shoes, mens-accessories, 季節限定系列等）。
2. 在 ego-browser 中依次訪問各品類落地頁，自動提取每個商品卡片的：
   • sku（唯一商品編號）
   • name（官方商品名稱）
   • price & priceValue（格式化價格與數值）
   • category & categoryName（所屬品類 ID 與展示名）
   • gender（人群歸屬）
   • image（高清晰工作室商品圖 URL）
   • description / material / dimensions（工藝描述與規格）
3. 跨品類按 sku 去重，呼叫 page.fetch 將所有商品高清晰圖下載至 assets/products/prod_<SKU>.png。
4. 自動編譯生成結構化商品資料庫：
   • data/products.json（標準 JSON 資料庫）
   • js/products-data.js（前端零延遲載入全域變數 window.LV_CATALOG_DATA / window.SITE_CATALOG_DATA）

Phase 4: 設計規範文件生成 (DESIGN.md & NOTES.md)

將採集到的視覺參數固化為 DESIGN.md：

• 色彩令牌：主文字色（如 #1a1a1a / #000000）、次級文字色（#727272）、淺邊框（#e1e1e1）、商品卡片石質工作室背景漸層（linear-gradient(180deg, #efeeec 0%, #f6f5f3 50%, #fbfaf9 100%)）。
• 排版比例：品牌定製無襯線字體堆疊、H1/H2（28px/36px 或 24px/32px, letter-spacing: 0.4px）、眉題 Pretitle（10px/16px, uppercase, letter-spacing: 1px）、商品標題與價格（14px/20px）。
• 佈局與柵格：Header 高度（88px，左右內邊距 48px）、4 列商品/品類網格（grid-template-columns: repeat(4, 1fr), gap: 32px 16px, 左右邊距 64px）、3 列品牌文化網格（repeat(3, 1fr)）。

Phase 5: 1:1 像素級頁面重構與全功能商品商城 (index.html, css/, js/)

1. 首頁 1:1 視覺重構 (index.html + css/lv-styles.css)：
   • 嚴格按照原站 Section 順序、寬高比（16:9 大片、4:5 商品與品類卡片）及內聯 SVG 構建 DOM。
   • 實現吸頂導航狀態機：在首屏 Hero 上方為透明背景配純白文字/圖示；向下滾動超過閾值（60px）或滑鼠懸停時平滑切換為純白背景配純黑文字/圖示與底部細邊框。
2. 全量商品商城與交互引擎 (js/lv-app.js)：
   • 全量商品目錄頁 (#lv-catalog-view)：支援一鍵查看全部已上傳商品（如 86+ 款），提供品類膠囊篩選欄（Category Pills）、價格高低排序與一鍵返回首頁。
   • 分屏商品詳情模態框 (PDP)：點擊任意商品展示左側高清晰大圖舞台、右側 SKU 編號、價格、工藝材質描述及 Place in Cart 加購按鈕。
   • 即時搜尋抽屜 (Search Overlay)：支援按商品名、SKU、品類即時過濾並即時展示縮圖結果。
   • 持久化願望清單與購物袋 (Wishlist & Shopping Bag)：基於 localStorage 持久化收藏與加購狀態，即時更新頂部導航角標數量。
   • 在線商品上傳後台 (+ Upload Product CMS Drawer)：支援在網頁端直接填寫新商品名稱、SKU、價格、所屬分類、圖片路徑與描述，立即發布至全站目錄並持久化儲存。

Phase 6: 靜態程式碼、排版無障礙與 SEO/GEO 自動化審計 (scripts/)

1. 執行 python3 scripts/seo_geo_generator.py <project_dir> <base_url> 自動生成包含全量商品 URL 的 sitemap.xml、robots.txt 與 llms.txt。
2. 執行 python3 scripts/layout_typography_auditor.py <project_dir> 執行靜態品質閘門：
   • 確保全頁僅有一個主 <h1>；
   • 確保所有點擊事件綁定在 <button> 或 <a>（或透過 JS 事件委託綁定），杜絕非語義化 <div onclick>；
   • 確保所有文字輸入框具備 autocomplete 屬性與無障礙 <label>；
   • 確保所有交互控件具備 :focus-visible 樣式，達成 0 blocking errors, 0 interface guidelines。

Phase 7: 多視口真機視覺 QA 與交付報告 (scripts/visual_qa_verify.mjs)

1. 啟動本地 HTTP 預覽服務，使用 ego-browser 造訪本地克隆站。
2. 強制觸發全量圖片載入，驗證首頁圖片與全量目錄商品圖 loaded === total 且 brokenImages.length === 0。
3. 分別在桌面端（1440×900）與行動端（390×844）截取全流程對比圖（首頁各滾動位、全量商品目錄頁、PDP 詳情頁、CMS 上傳抽屜、行動端首屏），驗證行動端 scrollWidth <= innerWidth（零橫向溢出）。
4. 關閉 ego-browser TaskSpace（await task.finish({ keep: [] })），生成 CLONE_REPORT.md 並交付。

---

四、 配套自動化腳本清單 (scripts/)

• scripts/recon_and_harvest.mjs：真機彈窗穿透、DOM/ComputedStyle/SVG 提取、原站分段基準截圖與首頁高清晰圖片下載器。
• scripts/crawl_all_categories.mjs：全品類商品遞迴抓取、跨品類 SKU 去重、高清晰商品圖批量本地下載與 products.json / products-data.js 編譯器。
• scripts/seo_geo_generator.py：基於 data/products.json 自動生成 sitemap.xml、robots.txt 與 llms.txt。
• scripts/layout_typography_auditor.py：HTML/CSS 語義化、標題層級、表單與焦點可訪問性零錯誤審計工具。
• scripts/visual_qa_verify.mjs：本地伺服器自動掛載 + ego-browser 多視口截圖對比與斷鏈/溢出自動核驗腳本。