UI 모프 명세 (코스 06단계, 레벨 L3)
상태 목록을 작성하세요, 분위기가 아닙니다. Opus 5.5 출시 주간에 가장 많이 북마크된 프롬프트는 한 줄짜리가 아니었습니다: @twoclipping의 UI 모프 루프와 @verbove의 MakerMap 영화 모두 XML 명세를 사용했으며, 입력 요청, 방향, 비트별 상태 목록, 빌드 규칙 및 주의사항이 포함되었습니다. 이들의 아이디어: 하나의 도형이 끊기지 않는 것. 단일 요소가 상태마다 크기, 반경, 색상을 변경하며(버튼, 로더, 플레이어, 차트, 명령 팔레트), 커서가 실제 클릭으로 각 변경을 일으키고, 마지막 프레임이 첫 번째와 같아 영화가 루프됩니다.
요청 인수(비어 있을 수 있음), 한 번 표시:
크레딧: 6개 섹션 구성은 @twoclipping의 공개 템플릿(https://x.com/twoclipping/status/2103273003555402193; XML은 코스에서 말한 대로 스레드 답글이 아닌 본문에 있습니다)과 @verbove의 MakerMap 명세(https://x.com/verbove/status/2103483957266268381)를 따릅니다. 이 스킬의 템플릿은 motion-studio의 자체 언어로 작성되었습니다: assets/spec-template.xml
1. 입력 요청
AskUserQuestion 한 번으로 요청합니다(하위 에이전트는 요청할 수 없음, 당신이 합니다):
| 입력 | 기본값 | 규칙 |
|---|---|---|
| 제품 + URL | 필수 | 실제 UI를 캡처하고 URL이 있으면 /motion-studio:product-reel 3단계로 복사 |
| 스토리 순서대로 8~12개 상태 | 로고, CTA, 이메일 필드, 로더, 체크, 카드, 차트, 명령 팔레트 | 다운비트당 하나 |
| 상태당 실제 데이터 | 요청 | 제품의 레이블, 숫자, 이름; 플레이스홀더 없음 |
| 브랜드 색상, 글꼴, 강조색 하나 | 캡처 또는 studio.json에서 | 강조색 하나 |
| 트랙 | minimal 120 BPM 합성 | 제공된 트랙은 이 사용을 허용하고 다운비트에서 시작해야 함 |
| 포맷 | 9x16, 1x1, 16x9 | 동일 타임라인, 리프레임 |
| 루프 | 예 | 마지막 상태가 첫 번째로 다시 모프됨 |
2. 명세 작성
프로젝트에 docs/spec.xml로 템플릿을 복사하고 모든 [...]를 답변으로 채웁니다. 6개 섹션 모두 유지: <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. 모션 디렉터 하위 에이전트(motion-studio:motion-director)가 브리핑에서 초안을 작성할 수 있습니다. docs/ 아래에만 작성합니다.
3. 비트 그리드에 상태 배치
-
프로젝트: 필요한 경우
--loop로 스캐폴드 (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<제품> morph" --loop --duration <초> --install; 스킬 전용 설치에서는 동일한 플래그로node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ...를 사용하거나studio-init스킬을 호출합니다). -
그리드:
node tools/score.mjs --style minimal --bpm 120 --dur <초>, 또는 제공된 트랙을node tools/beats.mjs audio/<track>으로 측정합니다. -
정확한 다운비트 시간, 루프 검사 및 경고가 포함된 상태 목록:
node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "로고,CTA 버튼,이메일 필드,로더,체크,카드,차트,팔레트" --out docs/statelist.md플래그 사용 --states "a,b:2,c"또는--file list.txt순서대로 상태; :2는 상태를 두 마디 동안 유지--beats audio/beats.json측정된 그리드(파일이 존재할 때 기본값); --beats none무시--bpm N,--beats-per-bar N그리드 재정의 --no-loop루프 대신 종료되는 영화 --json각 상태의 시작, 종료 및 콘텐츠 타이밍을 포함한 한 줄 JSON 루프 길이가
studio.json의duration과 다를 때, 첫 번째 상태가 0초에 없을 때(트랙의 픽업), 또는 상태가 1초 미만으로 유지될 때 경고합니다. 계속하기 전에 지속 시간을 수정하거나 트랙을 자릅니다. -
docs/statelist.md의 커서 동작, 데이터 및 사운드 열을 채우고 테이블을docs/shotlist.md로 복사합니다.
4. 게이트
비트 그리드의 상태 목록을 보여주고 영화 코드를 작성하기 전에 사용자의 확인을 기다립니다(<start> 섹션에 명시되어 있으며 코스에도 그렇게 되어 있습니다). 거부된 목록은 코드로 우회하지 않고 다시 작성합니다. 결정을 docs/shotlist.md의 Status: 줄에 기록합니다.
5. 검증된 예제에서 빌드
assets/morph-loop.film.js를 film/film.js로 복사하고 적응시킵니다: 120 BPM에서 16초, 8상태 루프이며 모든 포맷으로 렌더링됩니다. STATES(1080px 단위 크기, 채우기 토큰), COPY 및 content 페인터를 승인된 목록과 실제 데이터로 교체합니다; 메커니즘은 유지:
| 메커니즘 | API | 규칙 |
|---|---|---|
| 상태 시간 | grid.bar(i) | 절대 초 사용 금지 |
| 컨테이너 크기, 반경, 색상 채널, 카메라 줌 | loopTrack(t, keys, dur, spring) | 키는 [0, duration] 범위; 이음매는 첫 번째 다운비트(이 예제) 또는 t = duration에서 한 번 변경 |
| 콘텐츠 인/아웃 | swapAlpha(t, start, nextStart) | 모프 시작 후 인, 다음 모프 전 아웃 |
| 커서 | x, y에 대한 loopTrack, cursor(g, x, y, { pressed }) | 다운비트에서 현재 요소 클릭 |
| 탭 및 목록 하이라이트 | indicator(t, stops, { width }) | 다른 스프링의 가장자리 |
| 사운드 | grid.bar 및 grid.beat의 cues | 누를 때 클릭, 모프 아래 스우시 |
| 그레인 및 기타 프레임 인덱스 노이즈 | grain(g, W, H, c.frame % LOOP_FRAMES, ...) (LOOP_FRAMES = Math.round(dur * fps)) | 비평은 hash(0)과 hash(duration, { wrap: false })를 비교합니다; 원시 프레임 인덱스로 시드된 노이즈는 끝이 프레임 0과 달라 루프 검사에 실패합니다 |
모든 패턴과 그 이유: references/morph-recipes.md.
studio.json에 "loop": true 및 duration을 루프 길이로 설정한 후 npm run lint를 실행합니다.
6. 비평 및 전달
/motion-studio:motion-reel에서 비평 루프를 실행합니다(최소 3라운드, 모든 축 >= 8, 미해결 P0 없음; 각 라운드는 혼합 렌더를 빌드하고 두 증명 패스를 먼저 실행합니다, 파이프라인 실행북 참조).
모프 루프의 경우 out/review/<fmt>/loop.png(라이브 패스만 해당; video/ 패스는 루프 창 없음)와 "루프 이음매" 메트릭(hash(0)이 hash(duration, { wrap: false })와 같음, 연속성 비율 <= 1.5; |end - first| 창은 검정색이어야 하며, 프레임 인덱스 그레인은 인덱스가 래핑되지 않으면 이를 깨뜨림), strip.png의 각 전환 중 레이블, contact.png의 각 다운비트에서 커서 위치를 확인합니다. 이음매 점프는 P0입니다. 그런 다음 npm run build를 실행합니다.
모프 영화 규칙
- 하나의 컨테이너, 절대 컷 금지. 상태는 크기, 반경, 채우기 및 내용만 다릅니다.
- 모든 변경은 커서가 일으킵니다; 상태가 스스로 변경되지 않습니다.
- 모든 비트에서 무언가 움직입니다: 누름, 타이핑, 카운터, 선 그리기, 하이라이트 단계.
- 실제 제품 데이터만 사용. 스프링은 최소한의 오버슈트만 허용; 타입에는 없음.
- 금지: 바운시 이징, 글로우, UI 크롬의 그라데이션, 입자 버스트, 데드 비트.
- 카메라가 스케일하는 모든 것에
will-change(또는 래스터화 트릭) 사용 금지.
다음: /motion-studio:springs 느낌 조정; /motion-studio:ship-formats 포맷별 리프레임 및 전달.