Web Clone 网站复刻方法论
一套「真源码至上」的网站复刻方法论与可执行侦察脚本,避免照抄 AI 臆造代码。
亮点:强制核查源站许可、明确'无LICENSE=保留所有权利、不得公开重部署'、删追踪脚本、产物审计(audit-clone)。扣分:整个流程大量自动化抓取/下载/镜像第三方站点与资产(asset-harvest、mirror-site、network-capture),未设置用户确认门槛或抓取范围/速率约束;版权素材处理仅靠事后许可检查,先抓后查;无明确回滚/恢复说明。
决策树自洽、有失败纪律(如 isTrusted=false 如实记录、GUESS 必须升级)。扣分:所有 13 个脚本不在本次证据文件内,可运行性无法核实;路径硬编码为 /Users/jane/.shared-skills 与 ~/projects,可移植性差;依赖 gh/Playwright/jq/node24+ 等环境假设未在 SKILL.md 内完整声明;异常输入下的失败反馈无法静态验证。
触发词明确(中英双语多措辞)、能力边界段非常清晰(能做/会简化/不承诺)、受众场景明确、对中文用户友好。扣分:脚本依赖 GitHub API、raw.githubusercontent 等境外服务,中国大陆网络可达性风险未披露;'委托 web-shader-extractor' 等外部 skill 依赖未说明获取方式。
文档分层好(SKILL.md+references+产物模板)、版本号 1.6.0、MIT 许可、致谢详细且区分了概念借用与代码复制。扣分:references/ 与 scripts/ 文件均不在证据内,install 依赖与实际结构一致性无法核实;无 CHANGELOG;无明确维护责任/更新路径承诺;硬编码个人路径削弱通用性。
方法论针对真实痛点(AI 臆造代码),流程具体可操作,边际价值明确。扣分:静态评审下'逐字节忠实复刻''hero 像素 diff 5/5'等效果声明无法执行验证;实际产出质量取决于不可见的脚本与用户环境,直接可用性证据有限。
致谢规范,旗舰案例(chiuhans111/marbles)可交叉溯源,证据分级(SOURCE/PARTIAL/GUESS)设计本身可审计。扣分:marbles 拆解与 oryzo.ai 案例正文不在证据内;无 CI/测试/第三方执行证据;关键结论(像素 diff 5/5、快 N 倍)均为作者自述。
- 13 个内置脚本与全部 references 文件未包含在本次证据中,方法论的运行性与引用内容均未经核实。
- 脚本路径硬编码为作者个人目录(/Users/jane/.shared-skills、~/projects/website-clones),其他用户需自行改造。
- 镜像/下载第三方站点资产发生在许可核查之前,且无抓取速率与范围约束,注意版权与目标站服务条款风险。
- 核心流程依赖 GitHub API、raw.githubusercontent 等境外服务,中国大陆网络环境下可能不可达,文中未披露。
- '逐字节忠实复刻''像素 diff 5/5'等效果声明均为作者自述,无独立验证材料。
这个 Skill 能做什么,适合哪些场景?
这是一个 Claude Code skill,把「复刻一个网站」变成可重复的六步流程:先找真源码、再浏览器侦察、按站点类型选路径、搭工程、验证并替换内容。它强制要求任何 AI 二手分析中的可执行代码必须逐行用真源码核对,并提供十多个 Playwright 脚本做截图、路由爬取、网络捕获、交互探测与视觉 diff。覆盖静态站、React/Vue/Next 内容站和 WebGL/Canvas 重前端三大分支,旗舰案例是对 1067 行单文件 marbles 玻璃弹珠站的逐字节复刻。
按六步决策树执行:Step 1 先用 gh api 在 GitHub 搜索原站真源码;找不到则运行 recon-site.mjs、route-crawl.mjs、network-capture.mjs、interaction-probe.mjs、sourcemap-hunt.mjs 等脚本做浏览器侦察并生成 RECON 产物;按侦察结果选路径——静态站用 wget --mirror 或 mirror-site.mjs 全量镜像,React/Vue/Next 站重建模板灌内容,WebGL 重前端做逐行逆向拆解;随后删追踪脚本、写 NOTES.md/TEARDOWN.md,用 compare-recon.mjs 和 visual-diff.mjs 生成原站 vs 克隆站对比报告;最后替换文字、媒体和品牌色。视觉复刻/爆改模式会生成 design-dna. 设计身份文件。
- 前端开发者看到一个 WebGL/Canvas 交互 demo,想知道真实实现原理并在本地复现学习
- 个人开发者想把自己的旧站或喜欢的开源主题站改成自己的版本(换文案、媒体、品牌色)
- 被 AI 生成的『复刻分析文档』坑过(代码全是臆造、跑不起来),需要一套强制真源码核对的工作流
- 需要对 Astro/Vite SSG/Hugo 等静态构建站做 1:1 离线镜像部署(含运行时 fetch 的字体、wasm 等资产)
- 多页面官网复刻,需要先爬路由地图、按页面类型抽模板,而不是只复刻首页
这个 Skill 有哪些优点和局限?
- 核心纪律明确:所有结论标 SOURCE/PARTIAL/GUESS 证据等级,未核对真源码的代码不允许照抄
- 脚本配套完整,从侦察、镜像、交互探测到 visual diff、CLONE_REPORT 一条龙
- 有旗舰实证案例(marbles)和 L1-L6 复杂度分级,不是空谈方法论
- 内置许可核查纪律:无 LICENSE 的站默认保留所有权利,禁止未授权公开重新部署
- 脚本路径硬编码了作者本机目录(/Users/jane/.shared-skills/...),其他用户需要改路径
- macOS 特有的 SSL_CERT_FILE 处理写死在命令示例里,跨平台需自行调整
- 依赖较多(Node、Playwright、gh、jq、wget),安装成本不低
- 仓库未提供自动化测试套件;部分结论依赖个别案例(marbles、oryzo.ai),泛化效果待验证
- 默认不承诺克隆登录、支付、服务端业务逻辑等,只能做前端替身
如何安装这个 Skill?
把仓库 clone 到 skills 目录:git clone https://github.com/Jane-xiaoer/claude-skill-web-clone.git ~/.claude/skills/web-clone 。脚本依赖 Node.js、Playwright、GitHub CLI(gh)、jq、wget/curl;源码未说明具体版本要求(仅在模板处提到 Node 24+ 和检查 package. engines)。
如何使用这个 Skill?
在 Claude Code / Codex / Cursor 中用自然语言触发,例如:「复刻这个网站: https://...」「逆向拆解这个 WebGL demo」「把这个站抄下来改成我的」。AI 会加载 SKILL.md 并按六步决策树走。工程产物默认落在 ~/projects/website-clones/<站名>-clone/;注意 macOS 下脚本示例用到 unset SSL_CERT_FILE 和 SSL_CERT_FILE=/etc/ssl/cert.pem 的本地怪癖处理,其他环境可能需调整。
这个 Skill 与同类方案有什么区别?
README 中提到参考了 lixiaolin94/skills 的 web-shader-extractor(特效提取方法)和 zanwei/design-dna(设计身份 schema),本 skill 将其整合进更完整的端到端复刻流程,但未与其他同类工具做正式对比。