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>/
阅读并遵循:
- references/ui_clone_workflow.md
- references/multi_page_session_workflow.md(当涉及登录、多个页面或多个状态时)
源截取规则
如果用户提供了 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.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 克隆标准
当输入为 URL 时:
- 尽可能使用内置的浏览器/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、功能标签、推荐语、FAQ 文本和页脚文案。
- 除非用户明确要求结构更改,否则保留源布局、动画时间、区块顺序和组件结构。
- 清点栅格图片、首屏媒体、缩略图、头像、产品模型和装饰性照片。
- 当源图片不应保留时,使用
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 - 收紧模糊的措辞
- 保持令牌声明基于源内容
- 将不确定的陈述标记为推断
切勿凭空捏造:
- 克隆中不存在的颜色
- CSS 中未观察到的字体族
- 未提取的断点
- 需要您未捕获的运行时状态的交互
- 对您实际上未包含在会话中的页面或流程的覆盖声明
DESIGN.md 的必需章节:
- 视觉主题与氛围
- 调色板与角色
- 排版规则
- 组件样式
- 布局原则
- 深度与层级
- 做与不做
- 响应式行为
- 代理提示指南
最终响应
对于落地页混音模式,报告:
- 源 URL
- 截取文件夹和验证过的克隆路径
- 最终落地页文件夹和
index.html - 哪些项目文件提供了替换文案的信息
- 进行了多少次文案替换
- 生成了多少张图片以及保存位置
- 进行的桌面/移动端浏览器验证
- 任何限制,例如未捕获的交互或无法干净替换的素材
对于设计提取模式,报告:
- 如果是从实时 URL 克隆的,截取文件夹保存的位置
- 它是否包含单个
clone.html或多个带有各自clone.html的页面文件夹,以及可选的homepage.png/live.json - 输出文件夹保存的位置
- 它是否包含
DESIGN.md、README.md、preview.html和preview-dark.html - 如果生成了,
evidence.json保存的位置 - 结果是来自强克隆源还是较弱的回退
- 最终的合成中包含多少个页面或状态
- 任何值得注意的限制