关于 recreate
recreate 是面向开发者的网页复刻技能,可从 URL 收集页面结构、视觉、资源和动效证据,再构建学习用副本,并检查不同视口和交互表现。
主要功能
- 01检查页面结构与技术栈
- 02采集组件样式和资源
- 03测量滚动与悬停动效
- 04导出设计令牌
- 05执行响应式与交互检查
适用场景
- 01根据公开 URL 制作学习用复刻
- 02整理参考网站的版块与资源
- 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 — 学习构建须知(每次运行都必须遵守)
这是一个本地学习构建:精确重建参考网站,包括布局、文本、图片、字体、音频和动态效果。作为交换,每份输出都必须附带以下免责声明:
- 构建中的 README.md 必须醒目地说明:设计、文案、图片、字体和音频均归原始所有者所有;此构建是供个人学习和参考的复刻;不得部署、发布、出售,也不得作为自己的作品展示;如需发布,必须替换所有借用的素材(列出这些素材)并取得相应许可。
- HTML 中的标头注释必须用一行重复相同声明。
- 来源清单:在 README 中列出每个借用素材的路径和来源 URL。
- 如果用户之后希望发布,那属于单独的需求:替换素材 → 发布。不得悄悄删除免责声明。
范围:整个页面还是特定区块?连续滚动叙事(固定舞台 + 长间隔区)是一个整体——不要强行将其拆成按区块分页的页面。目标:默认构建为单文件;仅在 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 + 交接处停止。
用户作出选择后:
awwwards-build-project <file.html> --target vite|astro|next --out <dir>→ 生成原生结构:真实的分节组件、外壳结构、拆分后的 CSS(tokens.css+site.css)、按序排列的库,以及重放的 head 元数据/引导代码。- 如果他们选择手写动画:使用
--authored --motion <census.json>————移除站点逻辑脚本,保留 head 引导代码 + 动画库,motion.manifest.json记录按分节和页面触发的测量结果。然后编写动画(见motion-authoring),并明确记录所有手写条目。 - 验收关卡:按目标运行
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会覆盖无法归属的普查条目;页面级钩子仍需手动编写,之后才会执行动画。 - 字体:只有在拥有字体版权时才可随项目发布 → 自托管;否则请选择最接近的授权字体。