Communitygithub.com

Charlo-O/clone-design

端到端的网站克隆、落地页混音及 DESIGN.md 提取技能。当 Codex 被要求从 URL 逐像素克隆或复制网站/落地页、将源网站保存为当前项目本地落地页(同时保留布局并替换文案和图片素材)、将网站设计系统提取为 DESIGN.md、分析视觉语言,或综合多个截取的页面/状态以形成可复用的设计指南时使用。

clone-design 是什么?

这是一个端到端的网站克隆、落地页混音与设计系统提取技能,专为 AI 开发代理(如 Codex)设计。其核心流程是:首先从 URL 创建精确的 1:1 HTML 快照,并通过浏览器截图验证以保证无创意偏移;随后根据用户需求进入两种模式之一——模式 A“落地页混音”将克隆的页面适配到当前项目,包括替换文案和生成项目相关的栅格图片;模式 B“设计系统提取”则从单个或多个截取页面中提取颜色、排版、组件样式等设计规范,并生成结构化的 `DESIGN.md` 文件。该技能支持 Playwright 等浏览器工具进行 DOM 级克隆,并提供了详细的默认文件路径、脚本(如 `generate_design_md.py`)和严格的克隆标准。它适用于任何需要从现有网站快速获取灵感和设计资产,并安全地重构成自己的项目或学习其视觉语言的应用场景,尤其适合前端开发者、产品设计师和 AI 代理。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add Charlo-O/clone-design

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

clone-design 是做什么的?

先克隆一个网站,然后将其混音为项目特定的落地页,或将其蒸馏为 DESIGN.md。

默认姿态:保留源网站的渲染布局,在 1:1 克隆得到验证之前不进行任何创意偏移。只有在验证之后,才能为当前项目替换文案、图片和品牌特定内容。

何时使用

当用户要求以下操作时使用本技能:

  • 从 URL 克隆网站或落地页
  • 在适配前逐像素复制落地页
  • 将另一个网站的落地页转换为当前本地项目的落地页
  • 用当前项目文件夹中的文案替换克隆网站的文案
  • 用项目相关的生成栅格素材替换克隆网站的图片
  • 将网站转换为 DESIGN.md
  • 提取网站的设计系统
  • 分析页面的视觉语言
  • 分析已登录的产品 UI 或工作区
  • 综合来自多个页面或状态的设计指南
  • 将 UI 克隆转换为可复用的设计指南
  • 将实时 URL 直接转换为设计包

选择模式

模式 A:落地页混音

当用户希望克隆另一个落地页并将其适配到当前项目时使用。

流程:

URL -> 1:1 克隆 -> 验证过的本地页面 -> 项目文案映射 -> 图片生成素材 -> 最终落地页

阅读并遵循:

模式 B:设计系统提取

当用户需要 DESIGN.md、视觉语言分析或设计指南时使用。

流程:

URL 或 clone.html -> 截取 -> design-md/<slug>/

阅读并遵循:

源截取规则

如果用户提供了 URL:

  • 不要要求用户单独安装或运行 frontend-ui-clone
  • 首先创建自包含的 HTML 快照
  • 重用与 frontend-ui-clone 相同的克隆工作流和保真度阶梯
  • 将源素材保存在 captures/<slug>/ 下
  • 为每个截取的页面或状态包含 clone.html
  • 在有帮助时添加截图和令牌转储
  • 在混音或蒸馏之前,在浏览器中验证克隆

如果用户提供了本地的 .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.json
    • image-plan.json
    • qa/original-desktop.png
    • qa/clone-desktop.png
    • qa/final-desktop.png
    • 可选的移动端截图

设计提取输出:

  • 输出文件夹:design-md/<slug>/
  • 输出文件:
    • DESIGN.md
    • README.md
    • preview.html
    • preview-dark.html
  • 可选的证据文件:evidence.json

1:1 克隆标准

当输入为 URL 时:

  • 尽可能使用内置的浏览器/Playwright 工具
  • 使用与 frontend-ui-clone 相同的默认视口和滚动策略
  • 保留渲染后的 DOM、CSS、字体和已解析的资源 URL
  • 保留原始 DOM 结构、类名、区块顺序、间距、圆角、阴影、排版、渐变和响应式行为
  • 在验证过的克隆存在之前,不要重新设计、简化、重新品牌化或重新布局
  • 如果页面需要身份验证,让用户在浏览器中完成登录,并保持相同的浏览器上下文存活
  • 登录后,在同一会话中分别截取每个请求的页面或 UI 状态
  • 如果第一次截取存在空白首屏或明显的覆盖问题,使用与 frontend-ui-clone 相同的升级思路:
    • 级别 1:DOM + CSS 克隆
    • 级别 1a:带有针对性修复的混合克隆
    • 级别 1b:针对性的样式烘焙
  • 在大约 1440 x 900 的分辨率下进行桌面端截图 QA
  • 当页面是响应式时,在大约 390px 宽度下进行移动端截图 QA
  • 在继续之前修复可见的不匹配

除非用户明确要求这种广度,否则不要自动爬取整个已认证的应用程序。优先选择一组精选的关键页面或状态。

混音规则

将克隆的落地页适配到当前项目时:

  1. 在编写文案之前,检查当前项目文件夹以获取产品上下文。优先使用 README、PRODUCT.md、package.json、现有的落地页、文档、源字符串、截图和品牌素材。
  2. 在验证过的克隆上运行 scripts/extract_landing_inventory.py 来为文本和图片规划播种。
  3. 从原始可见文本到替换文本构建一个文案映射。保留相同的内容层次结构和近似的文本长度,以保持布局完整。
  4. 用项目相关的语言替换品牌名称、标题、副标题、CTA、功能标签、推荐语、FAQ 文本和页脚文案。
  5. 除非用户明确要求结构更改,否则保留源布局、动画时间、区块顺序和组件结构。
  6. 清点栅格图片、首屏媒体、缩略图、头像、产品模型和装饰性照片。
  7. 当源图片不应保留时,使用 imagegen 技能生成项目相关的栅格替换物。将生成的素材保存到 landing-pages/<slug>/assets/generated/,并更新 HTML/CSS 引用。
  8. 优先保留原始图片的尺寸、宽高比、裁剪行为、object-fit、边框半径和视觉重量。
  9. 除非用户要求,否则不要用生成的位图替换简单的 SVG 图标、矢量标记、CSS 渐变或几何装饰。
  10. 除非用户明确希望为私有参考克隆保留,否则移除或替换第三方品牌标志、名称、截图和商标。
  11. 在文案和图片替换后,在浏览器中验证最终的适配页面。修复文本溢出、图片损坏、移动端换行和布局偏移。

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
  • 收紧模糊的措辞
  • 保持令牌声明基于源内容
  • 将不确定的陈述标记为推断

切勿凭空捏造:

  • 克隆中不存在的颜色
  • CSS 中未观察到的字体族
  • 未提取的断点
  • 需要您未捕获的运行时状态的交互
  • 对您实际上未包含在会话中的页面或流程的覆盖声明

DESIGN.md 的必需章节:

  1. 视觉主题与氛围
  2. 调色板与角色
  3. 排版规则
  4. 组件样式
  5. 布局原则
  6. 深度与层级
  7. 做与不做
  8. 响应式行为
  9. 代理提示指南

最终响应

对于落地页混音模式,报告:

  • 源 URL
  • 截取文件夹和验证过的克隆路径
  • 最终落地页文件夹和 index.html
  • 哪些项目文件提供了替换文案的信息
  • 进行了多少次文案替换
  • 生成了多少张图片以及保存位置
  • 进行的桌面/移动端浏览器验证
  • 任何限制,例如未捕获的交互或无法干净替换的素材

对于设计提取模式,报告:

  • 如果是从实时 URL 克隆的,截取文件夹保存的位置
  • 它是否包含单个 clone.html 或多个带有各自 clone.html 的页面文件夹,以及可选的 homepage.png / live.json
  • 输出文件夹保存的位置
  • 它是否包含 DESIGN.md、README.md、preview.html 和 preview-dark.html
  • 如果生成了,evidence.json 保存的位置
  • 结果是来自强克隆源还是较弱的回退
  • 最终的合成中包含多少个页面或状态
  • 任何值得注意的限制

相关技能