boyang-hu/website-rebuild-skill

解决的问题

该项目为AI智能体提供了一种系统化的方法，以执行高保真、可验证的网站重构。与仅捕获网站视觉外观的简单“抓取”工具不同，该工具将源网站视为技术规范，使智能体能够将逻辑和结构逆向工程为干净、可维护且可独立运行的代码库。

工作原理

该过程遵循严格的多阶段流水线：

1. 取证镜像：将网站捕获为具有加密验证 (SHA256) 的只读快照。
2. 逆向工程：反编译并将压缩代码映射回源，创建可追溯的审计跟踪。
3. 量化验证：使用五层自动化测试套件（控制台、网络、DOM、几何和像素级完美比较）来确保重构后的表现与原始网站完全一致。
4. 源代码重构：将代码重构为可读的模块，允许用户拥有一个功能齐全、独立的独立项目。

适用人群

它专为希望通过创建通过严格自动化等效性测试的高保真、可验证副本来研究、学习或分叉复杂Web架构（包括 WebGL、React Server Components 和现代构建工具输出）的开发人员和研究人员而设计。

亮点

• 可验证的等效性：实现像素级匹配 (meanAbsDiff 0.00) 和字节级一致性，确保副本在功能上与源完全相同。
• 智能体就绪：遵循 Agent Skills 开放规范，使其与各种AI智能体运行时兼容。
• 零依赖流水线：核心工作流使用零依赖的 Node.js 工具链，以确保可靠性和可审计性。
• 弹性：包含从 Wayback Machine 存档中拯救和重构“死”网站的功能。
• 严格纪律：强制执行严格的方法论，即错误、怪癖和遗留代码会被记录下来，而不是被静默“修复”，确保副本始终是原始网站的准确反映。