reanimate은(는) 무엇을 하나요?
사용자가 지시한 대상을 참조(reference)와 동일한 방식으로 움직이도록 재구축하고, 프레임별 비교를 통해 증명하며, 비교가 통과할 때까지 계속 진행합니다. 결과물은 사용자 프로젝트의 코드와 증거(수치 및 나란히 비교 시트)이며, "적당히 비슷해 보인다"는 허용되지 않습니다.
"완료"의 의미
사용자의 말에서 충실도 수준을 선택하고 첫 번째 메시지에 명시하세요. 이 수준이 검증 기준을 결정합니다.
| 수준 | 사용 시기 | 일치해야 하는 항목 | 달라도 되는 항목 |
|---|---|---|---|
| motion-faithful (기본값) | "이 애니메이션을 복제해 주세요", "우리 것을 그들의 것처럼 느끼게 해주세요", "X와 같은 히어로지만 우리 버전으로" | 트리거, 시퀀스와 순서, 스태거, 각 단계의 타이밍(±80ms), 이징 패밀리, 요소 크기 대비 방향과 거리, 레이아웃 비율 | 복사본, 색상, 글꼴, 이미지, 브랜드 세부사항 |
| pixel-faithful | "정확히 일치시켜 주세요", "픽셀 단위로 완벽하게", "세부사항이 일치해야 함", "1:1" | 위 모든 항목 + 글꼴, 크기, 색상, 간격, 둥근 모서리, 그림자, 에셋; 평균 프레임 불일치 ≤ 2% | 사용자가 변경을 요청하지 않은 모든 것 |
| mixed | "X를 복제하고 Y를 추가해 주세요", "그들 것과 같지만 우리의 가격 티어로" | 복제된 부분은 위 수준 중 하나의 기준 충족 | 추가된 부분은 설명과 시각적 확인만 하되 복제된 동작을 깨뜨리지 않는지 검증 |
사용자는 하나의 섹션, 위젯, 페이지 또는 비디오의 시간 범위("처음 3초", "0:12~0:15")로 대상을 좁힐 수 있습니다. 그 부분만 정확히 복제하고, 페이지의 나머지는 가져오지 마세요.
워크플로우
아래 모든 내용은 사용자 프로젝트 내 .reanimate/<name>/ 디렉토리에 저장됩니다(증거를 커밋하지 않으려면 .gitignore에 추가). 각 라운드의 산출물을 보관하세요. 이것이 증거입니다.
0. 범위 설정
캡처 전에 .reanimate/<name>/spec.md 상단에 세 줄을 작성하세요:
- Target: 복제할 대상을 사용자가 말한 대로 정확히 명시(URL + 선택자 / 시간 범위 / "gif 속의 토글").
- Destination: 코드가 위치할 곳과 사용 스택 (
package.json, 기존 컴포넌트 및 이미 사용 중인 애니메이션 라이브러리를 읽고, 새로운 것을 도입하지 말고 일치시킴). - Fidelity: motion-faithful, pixel-faithful 또는 mixed, 그리고 mixed의 경우 추가 항목 목록.
요청과 저장소에서 추론할 수 있는 것은 추론하세요. 두 가지 해석이 서로 다른 작업으로 이어질 때만 질문하세요(예: 두 개의 후보 섹션이 있는 페이지에서 "히어로" 부분). 참조가 로그인이 필요한 페이지이거나 여기서 다운로드할 수 없는 YouTube/Loom 링크인 경우, 사용자에게 화면 녹화를 요청하고 그동안 다른 모든 작업을 계속하세요.
1. 설정
아래 <skill>은 이 SKILL.md가 위치한 디렉토리입니다. 스크립트는 Bun이 필요하며, 첫 실행 시 Playwright의 Chromium과 정적 ffmpeg(약 250MB)를 다운로드합니다.
bash <skill>/scripts/setup.sh # playwright, ffmpeg, pixelmatch를 한 번 설치하고 "ready" 출력
모든 스크립트는 bun <skill>/scripts/<name>.ts --help로 실행됩니다. 스크립트는 결정론적이며 하나의 규칙을 공유합니다: 참조와 클론을 동일한 뷰포트, 선택자 크롭, 트리거, 지속 시간 및 fps로 캡처해야 합니다. 그렇지 않으면 비교가 작업 결과가 아닌 설정 차이를 측정하게 됩니다.
2. 참조 캡처
references/capture.md에서 소스 유형에 대한 방법을 확인하세요. 요약:
- 웹사이트:
capture.ts --url … --out ref --selector <section> --trigger load|scroll|hover|click|none --duration … --track "<움직이는 요소들>".video.webm,frames/,inspect.json(선언된 애니메이션, 키프레임, 계산된 스타일, 글꼴, 감지된 라이브러리) 및track.json(각 애니메이션 프레임별 추적된 요소의 위치, 크기, 불투명도, 변환)을 얻습니다. CSS/WAAPI 모션의 경우inspect.json에 정확한 지속 시간, 지연 및 이징이 포함되는 경우가 많으므로 이를 사용하세요. 추정하는 것보다 낫습니다. - 비디오 또는 gif:
frames.ts --in file --out ref/frames --fps 10..30 --start … --end … --crop …. 먼저--probe로 프로브한 다음 몇 프레임을 보고 복제 중인 위젯의 크롭을 찾으세요. - 캔버스, WebGL, WebGPU, 3D (
inspect.json > canvases에 하나가 표시되거나 페이지가 three.js, Pixi, Babylon, Spline…을 사용하는 경우): 캡처에--clock virtual --gl --assets를 추가하고gl/summary.md를 읽으세요(gl.ts summary <out>). 셰이더 소스, 모든 상수 uniform, 씬 그래프, 렌더 패스, 텍스처와 모델, 그리고gl-track.json의 채널로 표시되는 각 애니메이션 uniform 또는 객체 속성을 얻습니다. 가상 시계는 모든 프레임을 정확하게 만들고 모든 캡처를 동일하게 만듭니다(랜덤 입자 포함).references/webgl.md를 읽으세요. - Lottie / Rive / 프로토타입 내보내기: 파일 자체가 명세서입니다. 읽고 픽셀에서 다시 유도하지 마세요.
그런 다음 레이블이 지정된 시트를 빌드하고 확인하세요: sheet.ts filmstrip --frames ref/frames --out ref/sheets. 이미지 뷰어로 모든 시트를 읽으세요. 이것은 사용자가 요청한 프레임별 검사입니다. 건너뛰거나 첫 번째 시트만 샘플링하지 마세요.
3. 모션 스펙 작성
references/analysis.md의 템플릿을 사용하여 spec.md를 작성하세요. 요소별, 속성별로 한 행씩: 트리거, 시작 시간, 지속 시간, 지연 또는 스태거, 시작 → 끝, 이징, 메모. 다음 선호도 순서대로 숫자를 얻으세요: inspect.json의 애니메이션 및 키프레임 → track.json에 대한 easing.ts, 또는 캔버스의 경우 gl-track.json --channel → 프레임 읽기(변경되는 첫 번째 프레임, 변경되는 마지막 프레임, 오버슈트 여부). 또한 모션이 의존하는 정적 사실을 기록하세요: 요소 크기 및 위치, z-순서, 오버플로 클리핑, 변환 기준점, 그리고 pixel-faithful 작업의 경우 글꼴, 색상, 간격 및 에셋.
스펙은 참조와 클론 간의 계약입니다. 모든 행은 5단계에서 검사 항목이 됩니다. 행에 "?"가 있으면 프레임 읽기를 완료하지 않은 것입니다.
4. 빌드
references/implementation.md(이징 테이블, 스태거 계산, 스크롤 및 호버 트리거, 축소 모션)에 따라 사용자의 스택으로 구현하세요. DOM 구조를 참조의 역할 구조와 가깝게 유지하여 추적된 선택자에 대응하는 요소가 있도록 하세요. 혼합 작업의 경우 추가 사항을 명확히 분리된 컴포넌트나 블록에 넣고 spec.md의 "Additions" 아래에 언급하세요.
클론이 참조와 동일한 방식으로 캡처될 수 있는 방법을 제공하세요: 참조 뷰포트에서 동일한 트리거로 컴포넌트를 렌더링하는 라우트 또는 정적 페이지. 개발 서버도 괜찮습니다(capture.ts --url http://localhost:5173/…). 독립형 HTML 파일도 작동합니다.
5. 검증, 수정, 반복
참조에 사용된 것과 동일한 명령으로 클론을 캡처하되 --url과 --out clone-N만 변경하세요. 그런 다음:
bun <skill>/scripts/compare.ts --ref ref/frames --clone clone-N/frames --out compare-N
bun <skill>/scripts/sheet.ts compare --ref ref/frames --clone clone-N/frames --diff compare-N/diff --out compare-N/sheets --every 2
bun <skill>/scripts/easing.ts --track clone-N/track.json --selector "<el>" --prop <translateY|opacity|…> --compare-track ref/track.json
캔버스 작업의 경우 gl.ts compare --ref ref --clone clone-N도 실행하여 캔버스 설정, 그리기 구조 및 모든 애니메이션 채널을 확인하세요.
references/verify.md에서 보고서 읽는 방법, 각 충실도 수준의 통과 기준 및 각 실패 유형에 일반적으로 필요한 수정 사항을 읽으세요. 직접 비교 시트를 매 라운드마다 확인하세요. 숫자는 문제가 있음을 알려주고 시트는 무엇이 문제인지 알려줍니다.
모든 스펙 행이 통과할 때까지 반복하세요. 각 라운드: 증거가 가리키는 가장 작은 것을 변경하고, 다시 캡처하고, 다시 비교하세요. 2~5라운드가 예상됩니다. 5라운드 후에도 여전히 실패하는 행이 있으면 중단하고 해당 행의 수치와 이유(누락된 글꼴, 사용자가 복사할 수 없는 셰이더 또는 모델, 근사한 물리 스프링)를 보고하세요. 조용히 임계값을 낮추거나 행을 삭제하지 마세요.
6. 보고
최종 메시지는 단독으로 완전해야 합니다:
- 충실도 수준 및 복제 대상, 추가된 사항.
- 코드 위치(파일) 및 동작 트리거 방법.
- 마지막 비교 라운드의 짧은 표: 타이밍 오류, 평균 불일치, 핵심 요소별 이징 일치 여부, 통과/실패.
- 최종 비교 시트 경로(환경에서 이미지를 표시할 수 있는 경우 이미지로 포함).
- 잔여 편차, 각각 수치와 이유.
라운드를 낭비하는 함정
- 참조와 클론 간의 다른 뷰포트 또는 크롭: 코드를 건드리기 전에 캡처를 수정하세요.
- 첫 번째 프레임과 마지막 프레임만으로 판단: 이징은 중간 프레임에 있습니다. 시트를 읽으세요.
- 글꼴: 다른 대체 글꼴은 모든 프레임의 픽셀을 변경합니다. pixel-faithful 작업의 경우 불일치를 판단하기 전에 동일한 글꼴(
inspect.json의 글꼴에서)을 로드하세요. motion-faithful 작업의 경우 텍스트 픽셀을 무시하고 타이밍 열을 읽으세요. - 로드된 페이지에서 기록된 참조 vs 콜드 캡처된 클론:
--wait-before를 사용하거나--trigger none과 애니메이션을 다시 시작하는--pre-js를 사용하여 둘 다 정지 상태에서 시작하도록 하세요. - 스크롤 기반 모션: 시간이 아닌 스크롤 위치의 함수입니다. 동일한
--scroll-steps와--scroll-ms로 둘 다 캡처하고, 초당이 아닌 스크롤 위치(track의scrollY)별로 비교하세요. - JS 라이브러리(GSAP, Framer Motion 스프링):
--playback-rate는 속도를 늦추지 않습니다.track.json과easing.ts(오버슈트와 "spring-like" 보고)를 사용하고 오버슈트와 정착 시간으로 스프링 매개변수를 조정하세요. - 다른 사람 화면의 비디오에는 커서, 브라우저 크롬 및 압축 노이즈가 있습니다. 이를 크롭아웃하고 노이즈를 쫓기보다
--pixel-threshold를 약간 올리세요(0.15). - 실제 시계로 캡처된 캔버스 및 WebGL: 소프트웨어 GL에서 프레임이 드롭되고 무작위 콘텐츠가 로드될 때마다 다르므로 비교가 기계를 측정합니다. 양쪽을
--clock virtual과 동일한--seed로 캡처하세요. - 스크린샷에서 셰이더 재구축: 트레이스에 이미 소스와 모든 상수가 있습니다. GLSL을 작성하기 전에
gl/shaders/와 고정 uniform을 읽으세요.