mcpField
R
recreate

recreate

github.com/insane0777设计与 UI4141 次安装4 天前更新
代码仓库

关于 recreate

recreate 是面向开发者的网页复刻技能,可从 URL 收集页面结构、视觉、资源和动效证据,再构建学习用副本,并检查不同视口和交互表现。

主要功能

  1. 01检查页面结构与技术栈
  2. 02采集组件样式和资源
  3. 03测量滚动与悬停动效
  4. 04导出设计令牌
  5. 05执行响应式与交互检查

适用场景

  1. 01根据公开 URL 制作学习用复刻
  2. 02整理参考网站的版块与资源
  3. 03依据采集证据检查重建页面

MCP 相关

该技能使用 Awwwards MCP 工具搜索参考网站、检查页面、采集证据、分析动效并验证重建页面的交互。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/insane0777/awwwards-skills --skill recreate

安装后在 Claude Code 中输入/recreate确认已加载。

附带文件LICENSEv2-routing.md

详细介绍

根据链接重建网站

输入:一个 URL($ARGUMENTS)。按顺序执行各阶段;不得跳过取证步骤。

**配置说明:**此技能的工具包括 search_sites、get_site_details、 capture_live_site、analyze_page_structure、analyze_stack、capture_component、analyze_scroll_map、analyze_hover_census、get_motion_dna、capture_pose_3d、build_pose_stub、export_design_tokens、analyze_images、analyze_bundle,以及保留的 analyze_network_capture / verify_flow。以下示例使用 1.x 名称(默认 full)。在 AWWWARDS_MCP_PROFILE=v2 时,使用 search_references {request:{kind:"sites", ...}}、 get_reference {request:{kind:"site_details", slug}}、 capture_page {request:{kind:"screenshot", url}}、 inspect_page {request:{kind:"structure", url}}、 inspect_page {request:{kind:"stack", url}}、 capture_page {request:{kind:"component", url}}、 analyze_motion {request:{kind:"scroll", url}}、 analyze_motion {request:{kind:"hover", url}}、 analyze_motion {request:{kind:"dna", url}}、 capture_page {request:{kind:"pose", url}}、 build_motion {request:{kind:"pose_stub", poseGrid}}、 inspect_page {request:{kind:"tokens", url}}、 audit_page {request:{kind:"images", url}} 和 audit_page {request:{kind:"bundle", url}};analyze_network_capture 和 verify_flow 仍使用扁平格式。完整映射见:v2-routing.md。

阶段 0 — 学习构建须知(每次运行都必须遵守)

这是一个本地学习构建:精确重建参考网站,包括布局、文本、图片、字体、音频和动态效果。作为交换,每份输出都必须附带以下免责声明:

  1. 构建中的 README.md 必须醒目地说明:设计、文案、图片、字体和音频均归原始所有者所有;此构建是供个人学习和参考的复刻;不得部署、发布、出售,也不得作为自己的作品展示;如需发布,必须替换所有借用的素材(列出这些素材)并取得相应许可。
  2. HTML 中的标头注释必须用一行重复相同声明。
  3. 来源清单:在 README 中列出每个借用素材的路径和来源 URL。
  4. 如果用户之后希望发布,那属于单独的需求:替换素材 → 发布。不得悄悄删除免责声明。

范围:整个页面还是特定区块?连续滚动叙事(固定舞台 + 长间隔区)是一个整体——不要强行将其拆成按区块分页的页面。目标:默认构建为单文件;仅在 QA 后提供转换,不要擅自进行转换(见阶段 4)。

阶段 1 — 取证(免费 MCP,全部只读)

**任何 URL 都可以,但先检查 Awwwards。**步骤 1 始终是使用网站的域名或名称运行 search_sites。如果网站已列出 → 使用 get_site_details 获取其记录的 DNA(配色、技术、元素、奖项),并将其纳入报告。如果没有匹配项 → 说明一次后继续:只有搜索/索引工具的数据来自 Awwwards;以下所有采集工具都可用于任何公开链接,而实时取证仍会提供所需的一切。

  • analyze_stack <url> → 框架 + CSS + 库(告知你参考页面是 Webflow、Next 还是静态页面,以及哪些动效库很重要)。
  • analyze_page_structure <url> → 区块(分区顺序 + 高度)。如果区块合并成一个巨型区块,请改用带有明确 id/class 选择器的 capture_component。
  • 对每个分区:使用带有 selector(id/class)和 maxNodes(最多 2000)的 capture_component <url> → 几何信息、44 个计算样式键、伪元素、内联 SVG、文本、imgSrc、字体、颜色。
  • 动效:analyze_scroll_map <url>(关键帧 + gsapTriggers 数值;对于滚动联动的叙事页面,启用 scrubProbe),analyze_hover_census <url>(悬停期间的 activeAnims),get_motion_dna <url>。
  • Canvas/WebGL 主视觉:capture_pose_3d → 帧/网格;build_pose_stub 会将它们转换为滚动存根,其中的相机锚点是合成的指导信息(姿势网格保存帧和滚动比例,而不是相机变换)。它的帧加载器会对相同索引的请求去重,并丢弃过期的解码结果,因此滚动时不会闪现较早的帧。对于 Three.js 页面,使用 adapters:["three"] 调用 capture_scene_3d,会将可访问的节点/相机/灯光/控件添加到 evidence.three;build_scene_stub 仅使用 Box/Plane/Sphere/Cylinder 基元、捕获的尺寸、标准/基础材质,以及根据精确矩阵生成的透视相机进行重建。控件不会被重新创建,模块局部场景和父级变换无法恢复,未绑定的纹理会保持为平面。scene.json 中的帧引用是从 Windows 或 POSIX 路径提取的基本文件名。
  • 着色器检查:使用 adapters:["spector"] 调用 capture_scene_3d(可选 [email protected]),可捕获一帧 WebGL 画面,其中包含命令名称/数量、状态、上下文属性和经过截断的着色器源码。页面必须有实际绘制内容的帧;命令参数、结果、状态以及原始捕获内容都不会被传输,而且着色器源码是不可信的页面文本,不应作为代码运行。
  • 截图:对于滚动文档页面,capture_live_site 会返回一张完整页面 PNG + 内联预览(这是 QA 的真实依据,不是装饰);默认会等待全屏加载器消失。如果 analyze_page_structure 返回 scrollRoot,说明页面滚动的是内部容器:capture_live_site 会返回 mode:"anchors"——该容器内按顺序排列的六张视口截图(anchors[].scrollTop + file,仅 JSON,无内联图片)——因此请读取这六个文件,并自行设置容器的 scrollTop 以查看它们之间的位置。scrollCapture:"viewport" 会强制只截取单张视口截图;绝不要将 anchors 负载描述为一张完整页面图。
  • 构建前获取设计令牌:export_design_tokens <url>(可选 selector、viewport、最多 2000 的 maxNodes、include 类别)→ 序号 CSS 变量 + 根据计算样式生成的 Tailwind 主题映射。将该 CSS/Tailwind 用于构建,而不是凭感觉猜测配色和字体比例;达到上限时,truncated/notes 会说明情况。
  • 图片交付:analyze_images <url> → 格式构成、lazy/eager/srcset 覆盖情况、损坏/过大/过小的图片、alt 覆盖情况和示例(会剥离查询字符串;不下载图片)。用它来判断要复制哪些参考图片、如何设置尺寸,以及哪些图片需要响应式变体。
  • 收集完所有证据后仍不清楚实现机制?使用 analyze_bundle <url>(≤40 个代码块,1 req/s,关键词 grep,可选 webcrack)——了解如何实现,但仍要自己编写代码。
  • API 形态:将网络日志导出为 HAR,然后运行 analyze_network_capture <path>——仅输出分组端点和路径模板,不包含请求体/标头/密钥。如果页面已在 Chrome 中打开?使用 cdpEndpoint 调用 analyze_page_structure 扫描页面,而不操作页面(需要 AWWWARDS_MCP_ATTACH=1;不会导航、滚动、点击或新建标签页)。

阶段 2 — 构建

  • 使用一个 HTML 文件 + CSS + JS,并匹配参考页面自身的实现方式:静态网站使用原生代码;如果页面特征表明使用了 GSAP + ScrollTrigger + Lenis,则也使用这些库。
  • 根据测量所得的值接入动效:普查得到的时长/缓动/触发条件、gsapTriggers 的像素起止位置、关键帧起止值、scrub 曲线。不要自行添加普查中未显示的缓动效果。
  • 连续滚动叙事:固定视口大小的舞台 + 长的不可见占位区 + 单个 scrub 主时间线;切换图层并对 --bg 自定义属性进行补间;将减少动态效果模式折叠为平静的堆叠文档(务必始终提供此模式)。
  • 根据 evidence.three 构建 Three.js 主视觉:从 build_scene_stub 开始,将 unresolved/authoredDefaults 作为待办事项。仅重建 Box/Plane/Sphere/Cylinder 网格、standard/basic 材质,以及根据其精确矩阵验证过的透视相机;绝不重建已捕获的控件,保持其未解决状态;记录已捕获的灯光,但不应用;保持不支持的类型为未解决状态;丢弃父级变换。已捕获的相机保持静止;仅当资源包没有可用的适配场景时,才使用空闲环绕。
  • 结构:每个分区使用语义化 ID(#hero、#work);库放在本地 vendor/ 中(严格按以下顺序加载:gsap → ScrollTrigger → lenis → app.js);字体/音频/封面/图片放在本地 assets/ 中——使用精确资源,并复制到项目中。
  • 更新所有链接的 target="_blank" rel="noopener"、元数据、OG 和 JSON-LD。

阶段 3 — QA 门槛(未完成此项不得宣布完成)

  • Playwright:测试 390、768、1024、1440、1728 宽度;为每个滚动锚点截图(与参考截图对应);并排比较构图。对于内层滚动页面(scrollRoot),在每个锚点设置容器的 scrollTop——参考页面一侧使用六个 capture_live_site 的 mode:"anchors" 文件(或自行截取的锚点截图);没有可用于比较的单张整页图片。
  • 控制台错误为零、404 为零、水平溢出为零;在 1440 和 390 宽度下断言元素边界(名称宽度、卡片数量/链接 href、联系信息区块)。
  • 在 1440 宽度下测试减少动态效果模式:采用堆叠布局,不溢出。
  • 交互一致性:verify_flow { buildUrl, referenceUrl, steps } 会重放相同的 1–6 个滚动/点击/等待步骤,并报告每一步的 same/changed/unknown——当参考页面包含菜单、手风琴、模态框或悬停显示的面板时,使用此功能;将 unknown 视为未经验证,而非通过。
  • 3D 画布:verify_build { buildUrl, referenceUrl, scene3d: { referenceCaptureId, buildSelector } } 会重放捕获资源包中的检查点,并比较裁剪后的画布帧。它会在旧版扫描前,通过共享的 DNS/私有 IP 防护预检两个 URL(私有/环回地址会被拒绝,且不会发送请求;旧版资源获取也会通过同一代理进行),其截止时间为重放检查点的等待时间 + 10 秒余量,最低 15 秒,最高 45 秒。提供 pixelThreshold 和 maxChangedFraction 才能得出通过/不通过的结论;否则会将指标报告为 inconclusive。此门槛会为画布标记每次运行都随机生成的标记,因此会拒绝重复或预先标记的诱饵。旧版条带检测绝不会认证画布。
  • 如果实现与证据有任何偏差,修复后重新截图——一次处理一个锚点(按分区循环的纪律执行)。

阶段 4 — 可选的项目转换(先询问)

重建本身就是一项有效的交付成果。阶段 3 通过后,询问用户:

保留为单文件构建,还是转换为项目——Vite(纯 HTML/CSS/JS,无组件)、Astro(HTML 组件)或 Next.js(React 组件)?如果转换,是保留原始脚本,还是改用手写动画(--authored)?

未经询问,不要转换。不要替他们选择框架。如果他们说“直接构建就好”,则在阶段 3 + 交接处停止。

用户作出选择后:

  1. awwwards-build-project <file.html> --target vite|astro|next --out <dir> → 生成原生结构:真实的分节组件、外壳结构、拆分后的 CSS(tokens.css + site.css)、按序排列的库,以及重放的 head 元数据/引导代码。
  2. 如果他们选择手写动画:使用 --authored --motion <census.json> ————移除站点逻辑脚本,保留 head 引导代码 + 动画库,motion.manifest.json 记录按分节和页面触发的测量结果。然后编写动画(见 motion-authoring),并明确记录所有手写条目。
  3. 验收关卡:按目标运行 npm install && npm run build,启动服务,重新运行阶段 3 的定位点 ,并进行 390×844 移动端冒烟测试和减少动态效果测试;错误/404 必须为零。

阶段 5 — 交接

始终交付一份参考报告——即使用户只询问信息而没有要求构建:检测到的技术栈 + 库(analyze_stack、get_motion_dna)、含高度/背景(色带)的分节图、动画摘要(触发条件、缓动、持续时间、滚动控制/固定)、资源清单(字体、图片、音频),以及运行 analyze_bundle 时的包信息。对于非 Awwwards 链接,如果不在构建范围内,这份报告本身就是交付价值。

如果生成了构建成果:提供 README 和运行说明、必需的研究构建免责声明(版权归原始所有者所有;不得部署/发布/用于生产;不得冒充原创),完整的借用资源来源列表,以及用户之后希望发布时的发布前替换计划。报告中应包括:参考 URL、使用的证据工具、分节图、QA 矩阵结果、剩余差距。

已知限制(请明确说明)

  • 被动 Canvas 捕获只能获取帧。capture_scene_3d 使用 adapters:["three"] 时只读取可访问的全局变量;模块本地场景不可见,build_scene_stub 会将网格展平到根节点,因此父级变换会丢失;只有持有本地文件时才能绑定纹理。没有发现不代表不存在。adapters:["spector"] 需要一帧实际绘制内容,并且只报告有界的命令摘要和长度受限的着色器文本——不包含参数、结果、状态、堆栈或原始捕获数据。
  • Webflow IX2 / JS 驱动的初始状态可以作为行为证据恢复,但无法恢复其运行时——请用自己的 JS 重新实现(N2 手写模式可证明其形式;供应商包的解读仍需手动完成)。
  • --authored 会保留 head 内联脚本,即使它们可能属于站点逻辑(超过 2 KB 或看起来像动画时会发出警告)——发布前请验证。
  • 生成器的 pageTriggers 会覆盖无法归属的普查条目;页面级钩子仍需手动编写,之后才会执行动画。
  • 字体:只有在拥有字体版权时才可随项目发布 → 自托管;否则请选择最接近的授权字体。

评论

支持 Markdown