Motion match: 모든 애니메이션 측정, 재구축, 동일한 움직임 증명
"이렇게 움직이게 해줘"를 숫자로 바꿉니다: 모든 컷, 그리고 각 움직이는 요소의 시작, 지속 시간, 이징, 오버슈트, 이동, 회전, 형태 변화. 이 움직임을 사용자가 작업하는 도구(CSS, Web Animations API, Framer Motion, GSAP, Remotion, SwiftUI, After Effects)에서 재구축한 후 프레임 단위로 비교하여 타이밍이 ±0.08초 이내로 일치할 때까지 반복합니다. 참조 움직임 없이 정지 이미지만 있나요? UI 진입에는 Director 모드(아래)를, 릴과 설명 영상에는 Story 모드를 사용하세요: Claude가 움직임을 설계하고, 제작한 다음 동일한 스크립트로 자체 렌더링을 측정하여 "부드러움"을 주장이 아닌 확인으로 만듭니다. 광고로 편집할 비디오 클립(UGC, AI 생성, 촬영 영상)이 있나요? Edit 모드를 사용하세요: 동일한 측정, Director 규칙 및 리뷰를 푸티지에 적용합니다. 방법은 NiazMorshed2007/reanimate 및 rossark0/rossark-motion-skill(MIT 라이선스)에서 적용하였습니다. 스크립트는 자체 제작입니다.
<skill>은 이 스킬의 폴더입니다. 작업은 현재 폴더의 ./motion-match/<name>/에 들어갑니다:
ref/(참조 분석), ours/(우리 렌더링 분석), compare-N/(각 비교 라운드), spec.md.
설정 (처음 한 번)
PATH에 ffmpeg/ffprobe와 numpy 및 Pillow가 있는 Python 3이 필요합니다.
- 확인:
python3 -c "import numpy, PIL". 실패하면 해당 라이브러리가 있는 Python(기존 프로젝트 venv)을 찾고, 없으면 사용자에게 한 번 물어본 후:python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow를 실행하고python아래에서~/.motion-match/venv/bin/python을 사용하세요. 모든 스크립트는-I와 함께 실행하세요. - Director 및 Story 모드는 페이지를 헤드리스로 렌더링합니다:
pip install playwright && python -m playwright install chromium(한 번 물어보기). 설치할 수 없으면 대신 페이지를 화면 녹화하고 타이밍이 덜 정확하다고 말하세요. - 다른 설치는 없습니다. 어떤 것도 업로드되지 않습니다.
0. 범위 (측정 전 spec.md 상단에 작성)
- 대상: 사용자가 말한 대로 정확히 파일 + 시간 범위 (+ 크롭) ("처음 3초", "버튼만").
- 충실도: 모션 충실(기본값): 순서, 타이밍(±0.08초), 이징 패밀리, 오버슈트, 요소 크기 대비 이동, 스태거. 사용자 자신의 아트, 색상, 글꼴 및 단어. 픽셀 충실은 사용자가 요청하고 개인 연습용일 때만: 타인의 디자인, 로고, 캐릭터 및 음악은 그들의 것입니다. 복사본 게시를 돕지 마세요.
- 대상 도구: 모션이 들어갈 도구 또는 코드 (명확하지 않으면 한 번 물어보기: 출력 형식을 결정합니다).
- 참조 얻기: 사용자가 제공한 파일, 또는 사용자가 만든 화면 녹화(웹사이트 및 앱: 상호작용 녹화; 스킬은 사이트의 코드가 아닌 프레임에서 작동). 사용자가 특정 비디오를 요청한 경우에만 YouTube 또는 사이트에서 다운로드하여 자체 폴더에 저장하고 개인 참조 자료로 취급합니다.
1. 분석
python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h]
→ 소스 fps의 모든 프레임, sheets/timing_NN.png(모든 프레임: 타이밍, 이징, 후속 동작) 및 sheets/poses.png(초당 2개: 발생 상황). 모든 시트를 읽으세요. GIF도 동일하게 작동합니다.
2. 측정
- 컷 및 섹션:
python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align참조의 컷(장면 전환) 및 움직임을 시간과 함께 나열합니다. 절대 정지하지 않는 참조는 컷에서 분할됩니다. - 정확한 색상:
python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(전체 크기 프레임의 픽셀 좌표, 콘택트 시트 아님). - 각 움직이는 요소:
track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks](또는 배경이 아닌 모든 것에--not-bg HEX). 빛나거나 복잡한 참조에는 항상--region과 요소 고유의 색상을 제공하고, 인쇄된 visible-frame 범위가 합리적인지 확인하세요. 프레임별로 위치(cx cy), 크기(w h), 스쿼시(aspect), 가장자리, 페이드/성장(presence), 색상 및 회전(angle)을 기록합니다. - 각 움직임:
python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B(컷을 넘지 않는 하나의 움직임 창당 하나) → 시작, 끝, 지속 시간(ms 및 프레임), 이징 패밀리, 오버슈트, 안정화 시간 및 CSS, WAAPI, Framer Motion, GSAP 및 Remotion용 붙여넣기 준비 코드. 오류 ≤ 0.03이면 근접 일치; "단일 이징으로 맞지 않음"은 창을 분할하거나 포즈 체인(키프레임)임을 의미합니다. - 작은 움직임(2% 스쿼시, 5px 부동)은 시트에 표시되지 않지만 추적 번호에는 표시됩니다: 읽으세요.
- 작게 페이드 인하는 텍스트는 활동 곡선의 노이즈 근처에 있습니다: 대신
track_motion으로 측정하세요.
어떤 숫자가 어떤 종류의 움직임을 측정하는지
| 움직임 | 측정 방법 | 참고 |
|---|---|---|
| 이동, 슬라이드, 부동 | cx, cy | 피팅당 하나의 축 |
| 스케일, 성장, 스쿼시 | w, h, aspect | |
| 페이드 | presence (--colors와 함께) | |
| 회전, 스핀 | angle (도, 시계 방향 +, 360도 초과 연속) | 실루엣에서; 원형은 None: 원 위의 표시를 자체 요소로 추적하고 cx/cy를 피팅합니다. n-겹 대칭 도형(정사각형: 4)은 프레임당 < 180/n도가 필요하므로 빠른 스핀은 높은 fps 소스가 필요합니다. 영역 내 다른 같은 색상의 도형이 방해합니다: --region을 좁히세요 |
| 모프 (도형 → 도형) | --save-masks, 그 다음 shape_compare.py | 아래 참조 |
| 3D 뒤집기/카드 돌리기 | w (cos처럼 수축) + presence; 중간 지점에서 색상 반전 | 뒷면은 자체 요소입니다 |
| 경로 움직임 (호, 곡선) | cx 및 cy 모두, 경로를 따라 회전하면 angle도 포함 | 각 축을 피팅; 경로 모양은 시트에 있습니다 |
| 클립/마스크 공개, 와이프 | x1 또는 y1 (선행 가장자리), w/h | |
| 선 그리기 | presence | |
| 텍스트 분할 (단어/글자별) | 첫 번째와 마지막 단어 추적; 스태거는 시작 간격 ÷ (개수 − 1) | |
| 카운터, 차트 막대 | 막대: h/y0; 숫자: 시트 (눈대중) |
모프. track_motion.py ... --name blob --save-masks는 모든 프레임의 실루엣을 저장합니다(중앙 정렬, 동일 면적으로 스케일 조정). 그 다음:
python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B는track_blob.json에morph시리즈(0 = 첫 번째 도형, 1 = 마지막)를 추가합니다.fit_easing.py ... --prop morph는 시작, 끝 및 지속 시간을 제공합니다. 모프 진행은 면적을 따르므로 타이밍은 신뢰할 수 있지만 이징 이름은 붙여넣기 할 값이 아닙니다: 사양에서, 또는 추적할 수 있는 매개변수(w,aspect,angle)에서 이징을 가져오세요.- 우리 것 대 참조:
shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate]→ 도형 경로: 참조의 모든 중간 도형이 시간과 관계없이 우리 것에도 있는가 (PASS: 평균 ≤ 10%, 최악 ≤ 25% 전체 모프). 그런 다음fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK는 타이밍을 확인합니다.--rotate는 모프가 동시에 회전할 때 회전을 무시합니다(angle로 확인).
3. 모션 사양 작성 (spec.md; 모든 행이 체크 항목이 됨)
| # | 요소 | 속성 | 시작 → 끝 | 시작 s | 지속 s (프레임) | 이징 | 오버슈트 | 스태거 / 참고 | 출처 |
| 1 | card | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | 카드당 +0.08 s | track + fit_easing |
| 2 | icon | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | blob | morph | square → circle | 0.50 | 0.40 (12) | easeInOutCubic | — | shape path PASS | shape_compare |
| c | — | 컷 | — | 1.77, 2.33 | — | — | — | — | motion_compare self |
행에 "?"가 있으면 프레임을 아직 읽지 않았음을 의미합니다. 움직이지 않는 것도 기록하세요. 작업이 큰 경우 빌드하기 전에 사양을 사용자에게 보여주세요.
4. 빌드
사용자의 도구에서, 그들의 디자인으로. 사양에서 타이밍을 복사하고 해당 도구에 대한 피터의 출력에서 이징을 복사하세요. 레이아웃이 다를 때 요소 또는 프레임을 기준으로 거리를 매핑하세요. 포즈 체인: 부드럽고 오버슈트하지 않는 보간이 있는 키프레임; 참조가 오버슈트하고 안정화되면 스프링.
- 회전:
transform-origin을 명시적으로 설정하세요 (피벗 측정:cx, cy가 고정된 지점). - 모프: SVG 경로는 양 끝에 동일한 수와 종류의 명령이 필요합니다(또는 flubber / GSAP MorphSVG 사용); UI 레이아웃 모프(버튼 → 카드, 썸네일 → 페이지)는 FLIP 또는 공유 요소 전환(Framer
layoutId, View Transitions API)을 사용합니다; 모서리 반경/크기 모프는 일반 CSS입니다. - 3D: 부모에
perspective800–1200 px,backface-visibility: hidden, 두 면을 별도 레이어로.
5. 비교 및 수정 (2-5 라운드)
- 동일한 fps로 동일한 창 위에 우리 것을 렌더링하거나 화면 녹화합니다(참조와 동일한 방식으로 웹 페이지 녹화).
ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json(동일한 창, 크롭, fps 및 프레임 크기).motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N→ 오프셋, 모든 컷 및 시작/끝/지속 시간/피크 오류가 있는 움직임, ±0.08초 이내이면 PASS,activity.png(두 곡선) 및sheets/compare_NN.png(참조 | 우리 것 | 차이). 매 라운드 시트를 읽으세요.- 사양 행별: 같은 방식으로 우리 것을 추적한 다음
fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK→ 움직임별 타이밍 PASS/FAIL, 이동 및 이징 패밀리 일치. 모프 행:shape_compare.py --vs도 함께. - 증거가 가리키는 가장 작은 것을 수정하고, 다시 렌더링하고, 반복하세요. 5 라운드 후에도 여전히 실패하는 항목을 해당 숫자와 이유와 함께 보고하세요. 절대 묵묵히 허용 오차를 느슨하게 하지 마세요.
| 증상 | 일반적인 원인 | 수정 |
|---|---|---|
| 모든 것이 하나의 오프셋만큼 이동됨 | 시작 지연 또는 트리거 대기 시간 | 첫 번째 지연 조정 |
| 우리 것이 더 짧고 앞쪽에 치우침 | 이징이 너무 강함(expo 대 cubic) | 피팅된 베지어 사용 |
| 참조는 오버슈트하지만 우리 것은 아님 | 스프링/back 대 일반 이징 | 측정된 오버슈트에 맞춰진 back.out / 스프링 |
| 우리 것에서 움직임이 일찍 멈춤 | 보조 움직임 누락(드리프트, 푸시인) | 해당 창의 시트 확인 |
| 우리 것에 추가 움직임 또는 컷이 있음 | 참조에서 정지된 것이 애니메이션됨 | 제거 또는 지연 |
| 요소 번호가 점프함 | 추적이 다른 요소를 잡음 | --region 좁히기, 고유한 색상 사용 |
회전 이동은 맞지만 우리 것이 cx/cy에서 흔들림 | 잘못된 transform-origin | 측정된 정지 지점으로 피벗 이동 |
| 모프 타이밍 PASS, 도형 경로 FAIL | 경로가 다르게 보간됨(점 순서, 시작점) | 경로 점 재정렬/명령 일치; 모프 라이브러리 사용 |
6. 보고
충실도; 일치된 것과 사용자 자신의 것; 마지막 비교 테이블(컷 및 오류가 있는 움직임, PASS/FAIL); 요소별 행; activity.png 및 비교 시트 경로; 숫자와 이유가 포함된 모든 남은 차이점; 그리고 측정된(스크립트가 생성) 체크와 눈대중(시트를 본) 체크.
Director 모드: 정지 이미지 입력, 이에 맞게 설계된 모션
사용자가 참조 모션 없이 이미지(UI 스크린샷, 목업, 포스터, 제품 사진)를 제공하거나 Claude가 모션을 선택하도록 요청할 때 사용합니다. 작업은 평소와 같이 ./motion-match/<name>/에 들어갑니다(ours/, spec.md, check-N/). UI 진입이 아닌 비디오 조각의 경우 아래 Story 모드 내부의 단계를 따르세요.
- 이미지 읽기. 모든 요소(배경, 네비게이션, 헤드라인, 본문, 이미지, CTA, 카드, 아이콘)를 px 단위의 박스, 역할 및 순위와 함께 나열하세요: 하나의 초점, 그 다음 보조, 그 다음 크롬. 읽기 순서, 그룹(카드 행, 목록), 분위기(차분한/고급, 중립/제품, 장난기 있는) 및 특별한 모션을 암시하는 모든 것(토글 아이콘, 차트, 로고 마크, 곡선 경로, 뒤집을 수 있는 카드)을 기록하세요.
- 성격 선택 사용자가 지정하지 않으면 분위기에서 선택하세요. 옵션을 요청하면 세 가지를 모두 빌드하세요.
| 성격 | 진입 | 지속 시간 | 이징 | 이동 | 스태거 | 오버슈트 |
|---|---|---|---|---|---|---|
| 차분 | 페이드 + 상승 | 400–600 ms | easeOutQuart / cubic-bezier(.25,1,.5,1) | 8–16 px | 60–80 ms | 없음 |
| 중립 | 페이드 + 상승, 또는 스케일 .97→1 | 250–400 ms | easeOutCubic / cubic-bezier(.33,1,.68,1) | 12–24 px | 40–60 ms | 없음 |
| 장난기 | 상승 + 스케일 .9→1 | 스프링 | 스프링 (강성 300–400, 감쇠 20–26) | 16–32 px | 50–70 ms | 3–8% |
- 역할별 특수 모션 선택 (용어; 값은 시작점이며 성격에 따라 스케일됨):
| 모션 | 사용처 | 기본값 |
|---|---|---|
| 모프 | 아이콘 토글(메뉴 ↔ 닫기, 재생 ↔ 일시정지), 카드나 시트로 확장되는 버튼, 도형 로고 | 300–500 ms easeInOutCubic; FLIP/공유 요소를 통한 레이아웃 모프 |
| 회전 | 토글/쉐브론 아이콘, 새로고침, 기울어진 진입 | 아이콘 90–180° 200–300 ms easeOutCubic; 진입 −6…−10° → 0, 성격의 이징 사용; 로더 360° 선형 0.8–1.2 s 루프 |
| 3D 뒤집기 / 기울이기 | 두 면이 있는 카드, 가격 토글, 호버 깊이 | 뒤집기 rotateY 180° 500–700 ms easeInOutCubic; 호버 기울이기 ≤ 8° |
| 경로 모션 | 이동하는 것(비행기, 경로를 따라가는 점, 커서) | easeInOutSine, 경로 따라 회전, 0.8–1.6 s |
| 클립 / 마스크 공개 | 히어로 이미지, 큰 헤드라인 | inset 또는 원형 클립, 500–800 ms easeOutQuart |
| 텍스트 분할 | 주요 헤드라인만 | 단어 간격 40–60 ms, 글자 간격 15–30 ms; 전체 줄 ≤ 1 s |
| 선 그리기 | 아이콘, 서명, 차트, 밑줄 | stroke-dashoffset, 600–1000 ms easeInOutCubic |
| 카운터 / 차트 성장 | 숫자, 막대, 링 | 숫자 800–1200 ms easeOutExpo; 막대 기준선부터, 스태거 40–60 ms |
| 시차 / 깊이 | 레이어드 히어로, 스크롬 장면 | 레이어 속도 스크롤의 0.2–0.6; 지원 시 스크롤 타임라인 |
- 다음 규칙에 따라 안무:
- 순서: 배경/컨테이너 → 초점 → 헤드라인 → 보조 → CTA. 크롬(네비게이션)은 마지막, 또는 페이지를 프레임하는 경우 첫 번째에 빠른 150 ms 페이드로.
- 크기가 지속 시간을 결정합니다 (아이콘은 하한에 ...