boyang-hu/website-rebuild-skill

해결하는 문제

이 프로젝트는 AI 에이전트가 고충실도의 검증 가능한 웹사이트 재구성을 수행할 수 있는 체계적인 방법을 제공합니다. 사이트의 시각적 외관만 캡처하는 단순한 "스크래핑" 도구와 달리, 이 도구는 소스 웹사이트를 기술 사양으로 취급하여 에이전트가 로직과 구조를 깔끔하고 유지 관리가 가능하며 독립적으로 실행 가능한 코드베이스로 리버스 엔지니어링할 수 있도록 합니다.

작동 방식

이 프로세스는 엄격한 다단계 파이프라인을 따릅니다:

1. 포렌식 미러링: 암호화 검증(SHA256)이 포함된 읽기 전용 스냅샷으로 사이트를 캡처합니다.
2. 리버스 엔지니어링: 압축된 코드를 디컴파일하고 소스에 매핑하여 추적 가능한 감사 추적을 생성합니다.
3. 정량적 검증: 5계층 자동 테스트 스위트(콘솔, 네트워크, DOM, 지오메트리, 픽셀 단위 비교)를 사용하여 재구성된 결과물이 원본과 정확히 동일하게 작동하는지 확인합니다.
4. 소스 재구성: 코드를 읽기 쉬운 모듈로 리팩토링하여 사용자가 기능적이고 독립적인 프로젝트를 소유할 수 있도록 합니다.

대상 사용자

복잡한 웹 아키텍처(WebGL, React Server Components, 최신 빌드 도구 출력 포함)를 연구, 학습 또는 포크하려는 개발자와 연구자를 위해 설계되었으며, 엄격한 자동 등가성 테스트를 통과하는 고충실도의 검증 가능한 복제본을 생성할 수 있습니다.

주요 특징

• 검증 가능한 등가성: 픽셀 단위의 일치(meanAbsDiff 0.00)와 바이트 수준의 일관성을 달성하여 복제본이 소스와 기능적으로 동일함을 보장합니다.
• 에이전트 준비 완료: Agent Skills 오픈 사양을 따르므로 다양한 AI 에이전트 런타임과 호환됩니다.
• 제로 의존성 파이프라인: 핵심 워크플로우는 제로 의존성 Node.js 툴체인을 사용하여 신뢰성과 감사 가능성을 보장합니다.
• 복원력: Wayback Machine 아카이브에서 "죽은" 웹사이트를 복구하고 재구성하는 기능을 포함합니다.
• 엄격한 규율: 버그, 특이 사항, 레거시 코드를 조용히 "수정"하는 대신 문서화하는 엄격한 방법론을 강제하여 복제본이 원본을 정확하게 반영하도록 유지합니다.