Jane-xiaoer/claude-skill-web-clone
web-clone
Verified网站复刻 / 克隆方法论。USE WHEN 用户说 复刻网站、克隆网站、clone website、抄个站、仿站、 照着这个站做一个、reproduce site、还原某个网页效果、把这个站搬下来改成我的、 复刻某个交互/WebGL/Canvas/Three.js 效果。提供「先拿真源码 → 判路径 → 逆向拆解 → 搭工程 → 替换内容」的可移植决策树,覆盖静态站 / React-Vue-Next 内容站 / WebGL-Canvas 重前端站三大分支,并强制核对任何 AI 二手分析里的可执行代码。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.4 KB |
| references/assessment.md | markdown | 3.5 KB |
| references/complex-playbooks.md | markdown | 2.3 KB |
| references/deliverables.md | markdown | 5.0 KB |
| references/design-dna.md | markdown | 11.5 KB |
| references/effect-extraction.md | markdown | 5.2 KB |
| references/marbles-case.md | markdown | 3.3 KB |
| references/reverse-engineering.md | markdown | 3.5 KB |
| references/static-mirror.md | markdown | 4.9 KB |
| scripts/asset-harvest.mjsexecutable | script | 3.8 KB |
| scripts/audit-clone.mjsexecutable | script | 5.4 KB |
| scripts/compare-recon.mjsexecutable | script | 10.8 KB |
| scripts/dna-scaffold.mjs | script | 11.6 KB |
| scripts/init-clone.mjsexecutable | script | 3.2 KB |
| scripts/interaction-probe.mjs | script | 12.2 KB |
| scripts/lib/playwright-loader.mjsexecutable | script | 948 B |
| scripts/mirror-site.mjs | script | 6.2 KB |
| scripts/network-capture.mjsexecutable | script | 4.2 KB |
| scripts/recon-site.mjsexecutable | script | 8.7 KB |
| scripts/route-crawl.mjs | script | 7.8 KB |
| scripts/sourcemap-hunt.mjsexecutable | script | 3.6 KB |
| scripts/visual-diff.mjsexecutable | script | 5.8 KB |
references/effect-extraction.md
View on GitHub# 特效提取的证据纪律 + Baseline 闸门(WebGL/Canvas 逆向分支强化)
`reverse-engineering.md` 讲"怎么读懂渲染架构";本篇讲**逆向特效时怎么不骗自己**,
以及找不到真源码时的兜底路线。三件套:**证据分级 → no-compensation → baseline-first 闸门**。
> 纪律范式受 [lixiaolin94/skills · web-shader-extractor](https://github.com/lixiaolin94/skills) 启发(该仓库无 LICENSE,
> 默认保留所有权利——这里**只借方法概念、全部用本 skill 自己的话重写,未复制其代码或原文**)。
> 它和 web-clone 头号铁律「真源码至上」同魂,只是把"标行号"升级成了系统化的证据制度。
## 一、证据分级(每条结论都打标签)
写 TEARDOWN 时,渲染管线的每个关键事实都标一个级别,**默认按最低级算**:
| 标签 | 含义 | 例子 |
|---|---|---|
| `SOURCE` | 直接、绑定到目标的硬证据 | 公开真源码行、source-map 还原的模块、运行时对象 dump、抓到的 shader/WGSL 文本、帧捕获、带 hash 的网络响应体 |
| `PARTIAL` | 下一步探针的把手,还不够定论 | 类/函数/字段名、minified bundle 切片、框架对象、拿到 shader 但缺 uniform/pass/输入状态 |
| `GUESS` | 没有直接证据的重建值 | 视觉拟合、命名推断、套用默认值、手调魔数、任何"看起来对"的行为复原 |
- **未标 = 当 GUESS。** 别让没证据的东西混进"已知"。
- 这是把 marbles 教训("AI 把解析求交臆造成 ray-marching")制度化:**凡是 GUESS 级的实现,照抄前必须先升级到 SOURCE。**
## 二、no-compensation(不靠调参掩盖不懂)
> **严禁**为了让画面"看起来对",去改亮度 / 速度 / 位置 / 噪声值,来掩盖时序、颜色、FBO、资源、坐标系或状态模型上的真错误。
- 拟合出来的某个常数让输出更像了 → **它仍是 GUESS**,并写明"要拿到什么证据才能升级"。
- 接线类事实(pass 顺序、坐标变换、时间单位、输入耦合)**不会因为画面像了就算对**,必须独立追到证据为止。
- 对应 web-clone 老规矩:验证不了的如实写,**别伪造"拖动成功"**。
## 三、baseline-first 闸门(先复现,再重构)
逆向特效时**最容易犯的错**是边抠边重写边美化,最后既不像原站也说不清哪步错了。改成分闸:
```
定位渲染面 → 捕获最小真相 → RAW REPLAY(原样最小复现)→ ✅BASELINE 逐帧比对通过
↓ 通过后才允许
PROJECTIZE(重构成可编辑工程)→ PACKAGE
```
- **RAW REPLAY**:用抓到的真实 draw call / shader / uniform / 顶点数据,做一个**尽量小、尽量原样**的可运行复现,不优化、不换框架、不改参数。
- **BASELINE 闸门**:RAW REPLAY 必须和原站逐帧(或多帧采样)视觉一致,才算过。**没过这道闸,不准进重构。**
- 过闸后再 PROJECTIZE:换成可维护写法(raw WebGL / Three.js TSL / Babylon 等),每处仍标证据级别。
- 收尾三态,如实标注:`DONE_BASELINE_VERIFIED`(复现且验证)/ `DONE_PROJECTIZED`(已工程化)/ `DONE_BASELINE_WITH_GAPS`(复现但有记录在案的缺口)。
## 四、找不到真源码时——运行时捕获兜底
web-clone 第一动作永远是"去 GitHub / source-map 找真源码"。但**特效站经常无源、minified 到底**。
这时不要退回"看着像就照着写"(那是 GUESS),而是去**渲染边界抓运行时真相**:
- 在 WebGL/WebGPU 上下文拦截:实际的 draw call、绑定的 program、编译过的 shader 源、uniform 值、FBO/纹理尺寸、blend/depth 状态。
- 工具方向:spector.js 式的帧捕获、`WebGLRenderingContext` 原型打补丁记录调用、`getShaderSource` 拿编译后的 shader、preload script 在页面脚本前注入钩子。
- 抓到的这些算 `SOURCE` 级——它们就是新的"真源码",喂给 baseline-first 流程。
## 五、什么时候委托 web-shader-extractor
如果你已经装了 `web-shader-extractor`(`npx skills add lixiaolin94/skills` 里的那个 skill),
**遇到下面情况直接把特效那一段委托给它,web-clone 只当总入口**:
- 站是 WebGL/WebGPU/重 Canvas 特效,且 GitHub + source-map 都找不到真源码;
- 需要运行时帧捕获、逐帧比对、shader/uniform 级别的抠取;
- 想要"先 baseline 复现、再独立工程化"的完整带闸流程。
委托产物(最小可复现的 baseline + 证据包)拿回来后,**再并入 `~/projects/website-clones/<站名>-clone/`**,
按 web-clone 的产物规范补 NOTES/TEARDOWN,并继续走 Step 5 验证 + Step 6 替换。
没装它也不影响:上面四节的纪律本身就能照着做,web-shader-extractor 只是把第四节的捕获机器做成了现成工具。
## 与既有产物的衔接
- TEARDOWN.md 的"A. 真实技术拆解"每条加证据标签(`SOURCE`/`PARTIAL`/`GUESS`)。
- "B. 二手分析校验表"本来就是在抓 GUESS 冒充 SOURCE,口径一致。
- baseline 复现物建议留在 `<站名>-clone/RECON/baseline/`,和原始截图一起作为"验证过"的铁证。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |