Communitygithub.com

FoodFuturesApp/landing

用於變更 Food Futures 網站(website/)時,確保其與線上 Framer 網站一致,或當被問及重建進度時使用。執行 tools/parity/parity.py 並說明如何解讀與修復其輸出。

landing 是什麼?

此技能旨在維護 website/ 目錄中 Food Futures 網站的像素級重建,使其與線上 Framer 站點(foodfutures.framer.website)完全一致。它透過執行 tools/parity/parity.py 腳本來比對不同解析度下的渲染結果,並提供詳細的輸出解讀指南,協助開發者區分真正的佈局差異與因反鋸齒、輪播時序等造成的正常偏差。技能也記錄了首次重建過程中的實戰教訓,例如避免使用無單位的 line-height、正確處理 Framer 圖片屬性與 CSS 隱藏元素,以及測試時以 `behavior: 'instant'` 進行滾動。最後,它明確指出一些刻意保留的差異(如無 Framer 標章、加入焦點環與減少動畫支援),提醒開發者不應修復這些項目。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FoodFuturesApp/landing/tree/HEAD/.claude/skills/website-parity

在你喜歡的 AI 中提問

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

說明文件

網站一致性檢查

website/ 中的重建版本必須與 https://foodfutures.framer.website/ 保持一致,精準到子畫素級別。除非 Vineeth 要求進行有意的變更,否則請維持此狀態。

  1. 啟動網站:cd website && python3 -m http.server 8000(在背景執行)。
  2. 執行 .venv/bin/python tools/parity/parity.py 1440 1000 810 390。首次使用需先執行:python3 -m venv .venv && .venv/bin/pip install playwright pillow。
  3. 解讀結果:
    • layout: identical 且頁面高度相等即表示符合標準。
    • 像素差異低於約 1% 屬於反鋸齒現象。線上官網在 GPU 層上渲染大型陳述,因此看起來會稍微柔和。
    • 「How it Works」區塊每 5 秒自動切換,因此若畫面捕捉到不同卡片會產生差異,這屬於時序問題,並非錯誤。
  4. 當某個位置出現偏移時,請先比對兩個站點上該元素的計算樣式再進行編輯。首次建置的經驗總結:
    • 行高應使用 em 單位,而非無單位數值。Chrome 會對 1.3em 進行四捨五入,但對 1.3 則直接取整,導致每行產生 0.05px 的偏差。
    • Framer 圖片使用 object-fit: cover(其「fill」模式)或 contain(其「fit」模式)。
    • 當 svg { display: block } 被設定後,svg[hidden] 需要額外定義 [hidden] { display: none }。
    • CSS scroll-behavior: smooth 會影響程式化滾動行為,因此測試時必須使用 behavior: 'instant' 進行滾動。

刻意保留的差異(請勿「修復」):無「Made in Framer」標章;加入了焦點環、選取顏色與減少動畫支援;手機模擬螢幕在手機裝置上為空白,與線上官網一致。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能