boyang-hu/website-rebuild-skill

解決する課題

このプロジェクトは、AIエージェントが高忠実度で検証可能なWebサイト再構築を実行するための体系的な方法を提供します。サイトの視覚的な外観のみをキャプチャする単純な「スクレイピング」ツールとは異なり、このツールはソースWebサイトを技術仕様として扱い、エージェントがロジックと構造をクリーンで保守性が高く、独立して実行可能なコードベースにリバースエンジニアリングできるようにします。

仕組み

このプロセスは、厳格な多段階パイプラインに従います：

1. フォレンジックミラーリング：暗号学的検証 (SHA256) を備えた読み取り専用スナップショットとしてサイトをキャプチャします。
2. リバースエンジニアリング：圧縮されたコードを逆コンパイルしてソースにマッピングし、追跡可能な監査証跡を作成します。
3. 定量的検証：5層の自動テストスイート（コンソール、ネットワーク、DOM、ジオメトリ、およびピクセルパーフェクト比較）を使用して、再構築されたサイトがオリジナルと全く同じように動作することを保証します。
4. ソース再構築：コードを読み取り可能なモジュールにリファクタリングし、ユーザーが機能的で独立したプロジェクトを所有できるようにします。

対象ユーザー

複雑なWebアーキテクチャ（WebGL、React Server Components、最新のビルドツール出力を含む）を研究、学習、またはフォークしたい開発者や研究者向けに設計されており、厳格な自動等価性テストに合格する高忠実度で検証可能なレプリカを作成できます。

ハイライト

• 検証可能な等価性：ピクセルパーフェクトな一致 (meanAbsDiff 0.00) とバイトレベルの整合性を実現し、レプリカがソースと機能的に同一であることを保証します。
• エージェント対応：Agent Skills オープン仕様に従っており、さまざまなAIエージェントランタイムと互換性があります。
• ゼロ依存パイプライン：コアワークフローはゼロ依存の Node.js ツールチェーンを使用し、信頼性と監査可能性を確保します。
• レジリエンス：Wayback Machine のアーカイブから「死んだ」Webサイトを救出し、再構築する機能を備えています。
• 厳格な規律：バグ、癖、レガシーコードを黙って「修正」するのではなく文書化する厳格な手法を強制し、レプリカがオリジナルの正確な反映であり続けることを保証します。