Communitygithub.com

FoodFuturesApp/landing

用于更改 Food Futures 网站(website/)时,确保其与实时 Framer 站点保持一致,或回答重建进度问题。运行 tools/parity/parity.py 并解释如何读取和修复其输出。

landing 是什么?

该技能确保 `website/` 目录中的重建站点与 https://foodfutures.framer.website/ 子像素级别精确匹配。它通过运行基于 Playwright 的像素对比工具 `tools/parity/parity.py` 来检查布局一致性,并详细解释结果输出,包括识别抗锯齿差异、动画定时差异以及计算偏移的修复方法。技能提供了常见问题的具体解决方法,例如使用 `em` 单位行高避免视觉漂移、处理 Framer 图片的 `object-fit` 属性、修复 SVG 隐藏元素问题,以及注意 CSS `scroll-behavior` 对测试的影响。该技能适用于开发过程中与 Claude Code、Coder 或 Cursor 等 AI 代理协作的场景,帮助开发者快速定位并解决站点还原中的视觉差异,同时明确指出不应修复的故意差异(如省略 Made in 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(其“填充”模式)或 contain(其“适应”模式)。
    • 设置 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.

相关技能