edit-motion-graphics은(는) 무엇을 하나요?
완성된 모션 작품(MP4)의 결과물 소유자로, HyperFrames HTML + 일시 정지된 GSAP 타임라인으로 빌드됩니다. 프레임 수준의 PROMPT.md가 핵심 산출물이며, 코드는 이를 렌더링하기 위한 도구일 뿐입니다.
절대 규칙 (먼저 읽으십시오)
- 승인된 프레임 수준 PROMPT.md 전에는 코드를 작성하지 마십시오 - 자동 실행에서도 마찬가지입니다: 에이전트가 초안을 작성하고, 사람이 승인합니다(결정 기본값 Q6). 승인은 파일에 기록된 라인
APPROVAL: <who> <date>입니다. 변경 순서는 항상 원장(ledger) -> PROMPT.md -> 코드입니다. - 여기서 비용을 지출하지 마십시오. AI-3D, AI 정지 이미지 또는 유료 생성은
paid-generation-gate를 통해 진행됩니다; 이 스킬은 유료 호출을 하지 않습니다. 카탈로그 목록은 계정 접근 권한이 아닙니다. - 검토 순서: 스튜디오 프리뷰 ->
hf_segment범위 -> 수정 노트당 ONE 전체 렌더링 -> 최종 렌더링에 대한 모든 프레임 QA. 한 번에 하나의 무거운 작업(render_lock). 노트를 모아서 처리하십시오; 사용자가 아직 작성하는 동안 진단하되 렌더링하지는 마십시오. - 하드 트랩: HyperFrames 루트에
dir="rtl"금지(RTL은 텍스트 요소에만,<html>에lang="he"); 파일 폰트(hf/fonts/의@font-face);hyperframes snapshot --describe false, 호출당 최대 5개 타임스탬프; ASCII 작업 루트(new_project). - 실패 시 중단: 실행할 수 없는 게이트는
blocked(not_run) 상태이며, 절대pass가 아닙니다. 시간 초과, 빈 샘플 또는 누락된 렌더링은 절대 통과하지 않습니다. 성공적인 도구 호출은 실행 증거이고, 본 렌더링은 외관 증거입니다; 정지 이미지는 모션을 증명할 수 없습니다. - 법칙 vs 취향: 규칙 1-5는 법칙입니다. 아래에 스튜디오 스타일로 표시된 항목(기본 자막 없음, 금지 목록, "핑크 금지", Higgsfield 문법, 21세기 우선)은 소유자의 취향이며, 그 이유와 함께 학습됩니다; 이를 무시하는 브리핑이 있으면 취향보다는 브리핑이 우선하지만, 게이트에서는 절대 우선하지 않습니다.
- 숫자는 자체 fps를 가집니다(브리핑에서 달리 명시하지 않는 한 30fps) 측정된 타이밍은 해당 머신의 정보를 포함합니다(소유자의 Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB). NVIDIA/Apple 타이밍은 측정되지 않았습니다. 지출, 설치 또는 게시를 제한하는 프로젝트는 이 스킬을 재정의합니다.
입력 -> 출력
입력: 브리핑/원장(video-intake에서 가져옴), 브랜드 키트, UI 스크린샷 또는 컴포넌트, 음악/VO. 출력: hf/PROMPT.md(프레임 수준), hf/DESIGN.md(고정된 팔레트 + 타이포그래피 + 모션 토큰), hf/cues.js(영상과 사운드의 단일 타이밍 소스), hf/SOURCES.md, 컴포지션, mix.wav, 최종 MP4, QA 보고서. 핸드오프: 노트 -> revision-round; 기타 비율 -> multi-video-variants(전체 레이아웃 재구성, 자르기 금지); 전달 게이트 -> render-qa-deliver; 참조 제공됨 -> 먼저 reference-style-transfer(참조 없음 -> "스타일"에 해당하는 시간 범위를 질문).
절차
- 등록 + 인테이크. 레지스터(
launch | kinetic | logo | explainer | calm) 중 하나를 선택하고 길이, 비율, VO, 음악, 전달 파일명을 고정합니다(references/launch-register-and-pace.md). 30초 고밀도 런칭은 1.7배 빠르게 느껴졌습니다; 승인된 길이는 45초였습니다: 먼저 길이를 결정하십시오. - PROMPT.md + DESIGN.md 초안 작성(6개 블록; 카메라, 이음새 및 이벤트 테이블; 3D가 있는 경우 비트 카드).
python scripts/motion_spec_check.py hf/PROMPT.md --register <r>실행; 수정; 승인 요청. - 소스 비트 수집(
references/ui-sources-and-port.md): 카탈로그 -> hf-blocks -> shadcn 레지스트리(기본값) -> 계정이 있는 경우에만 21st.dev -> 수동 구축; 비트당 3D 결정(references/three-d-decision.md). - 빌드 하나의
index.html+cues.js; 포팅된 컴포넌트는 시크-세이프(seek-safe)하게 재작성됩니다. 그런 다음hf_preflight --strict,python scripts/seek_safe_scan.py hf/,python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D renders>]. - 시각적 승인: 네 장의 스틸 + 모든 이음새의 스냅샷 +
sheet연락처 시트; 스튜디오 프리뷰; 노트 배치. - 사운드(
references/sound-and-captions.md):hf_mix --report; 모든 브랜드 이벤트에 브랜드 사운드; 멀티플렉싱 및 최종 파일 측정. - 하나의 전체 렌더링 잠금 상태에서 먼저 ETA를 제시;
frame_qa,motion_qa,hf_deliver;agent-content/benchmarks/motion-graphics.rubric.md를 사용하여 별도의 비평가로 채점; 파일, 번호가 매겨진 변경 사항, 체크된 원장 및 정직한 격차를 제시합니다.
레지스터 한눈에 보기(자세한 내용: references/launch-register-and-pace.md)
| 레지스터 | 새 화면 | 이벤트 간격 | 카메라 | 사운드 |
|---|---|---|---|---|
launch | 2-6초마다, 2개 이상의 깊이 레이어 | <= 0.5-1초; 수동 계수 45-110/분 | 절대 멈추지 않음(드리프트 2-4%/s, 푸시인 8-15%) | 음악이 SFX; 모든 브랜드 이벤트에 브랜드 사운드; 링아웃 |
kinetic | 1-3초마다 | 최대 ~200/분(단어 교체 포함) | 타입이 카메라 | 키워드가 발화된 후 0..+7 프레임에 도달 |
logo | 하나의 아이디어, 3-8초 | 결과가 0.4-0.75초 이내에 보임 | 한 번 움직이고 안정화 | 리빌 시 브랜드 사운드; 3단계 종료 |
explainer | 아이디어당, 3-6초 | 30-110/분 | 목적에 따라, 설명하는 대상으로 | VO 주도; 가시적 변화에만 SFX |
calm | 홀드 허용 | 드문 것은 괜찮음 | 느리거나 고정 | 하나의 균일한 배경음 + 미세한 폴리; 라이저/드롭 없음 |
비트당 3D (다섯 줄)
비트별로 결정하고 이유를 PROMPT.md에 작성하십시오: Blender 실제 지오메트리 / 히어로 재질이 2초 이상 화면에 표시되는 경우(EEVEE 우선; 384-640px에서 1.2-2.25초/프레임 측정, 런칭당 +1-1.5분 추가); Three.js 데이터 기반, 인스턴스화, 실시간 텍스트가 있는 3D-UI, 라운드별 편집 또는 정확한 16진수 비트, 1초 hf_segment AMD 게이트 이후; AI-3D paid-generation-gate 및 라이선스 확인 뒤에만; 2.5D (depth_25d, Depth Anything V2 Small, 2초 클립당 8.1-9.9초) 약간의 움직임이 필요한 정지 이미지용; 없음 UI/메시지 비트용. 3D 객체는 정보를 가리지 않으며 단어에 반응합니다.
"지루함 / AI처럼 보임 / 정적임" 타임스탬프 처리
비트 개념을 대체하고, 다듬지 마십시오. 메뉴에서 선택하십시오: 실제 VO 스펙트럼으로 구동되는 음성 오브; 데이터 기반 빌드(막대, 카운터, 경로 지구본); 코드로 재구축되고 객체(원근, 피사계 심도, 150-300% 확대)로 촬영된 UI; 콘텐츠를 전달하는 공유 요소 모프; 제자리에서의 숫자 또는 단어 교체; 키워드에 착지하는 3D 히어로. 작은 구석 "기능 알약", 작은 푸시인이 있는 평평한 스크린샷, 또는 검은색 배경의 점은 절대 안 됩니다. 금지 라인에 노트를 추가하고 모든 발생 지점에서 수정하십시오(반복될 때 전역 규칙).
시간 예산(소유자 머신에서 모델링 또는 측정; 학생 측정 아님)
목표: 30-45초 런칭의 첫 번째 제출 가능한 초안을 약 3-4시간, 1-2회 수정 라운드로 완성(첫 번째 실제 런칭은 10개 초안, 7개 비평 라운드, 4개 소유자 노트 라운드 소요); 라운드당 정확히 ONE 전체 렌더링. 렌더링 참조(HyperFrames 0.8.98, E11, 무거운 40초 / 1200프레임): 작업자 1명 132.6초, 4명 92.8초, 8명 88.1초; 브라우저 GPU -12%; 캡처가 병목(CPU 사용률 16개 논리 코어 중 2-3개만 사용). 이전 프리미엄 렌더링: 일반적으로 8-14분, 관찰 범위 4-21분(0.8.79-0.8.93). 항상 한 단위를 벤치마킹하고 3분을 초과하는 작업 전에 ETA 라인을 게시하십시오.
게이트
상태: pass | fail | blocked | n/a, 항상 이유와 함께.
| 게이트 | 조건 | 증거 | 거짓인 경우 | 소유자 | 재확인 |
|---|---|---|---|---|---|
| G0 인테이크 | 레지스터, 길이, 비율, 전달 파일명, VO/음악 소스, 참조 답변 기록됨 | hf/BRIEF.md | 질문(라운드당 3-4개 질문); blocked | video-intake | 브리핑 변경 시 |
| G1 프레임 수준 사양 | 6개 블록; 모든 비트에 프레임 + px + 이징 + 사운드 + 전환 포함; 금지 라인; 16진수 팔레트; APPROVAL: 라인 | motion_spec_check.py 종료 코드 0 (2 = 승인 누락 = blocked) | 사양 수정; 코드 전에 중단 | 이 스킬 + 사람 승인자 | 리타임 또는 새 비트 |
| G2 깨끗하고 부드러움 | 씬당 ONE 스플라인, 각 이동 >= 1.2초, 역방향 이동 >= 1초 및 <= 1.3배, 모든 키프레임에서 텍스트가 프레임 내부에 있음, 이음새 종료 = 시작, 히어로 유지, 반복 기술 없음, 페이드 없음 | PROMPT의 테이블 + 검사기; motion_qa 렌더링에서 0 지터 범위 | 리타임/리패스; 다듬기보다 비트 개념 대체 | 이 스킬 | 카메라 또는 이음새 변경 시 |
| G3 밀도 | 레지스터 기준: 런칭 = 2-6초마다 새 화면, 이벤트 간격 <= 0.7초(선언된 숨 참기 제외), 45-110개 이벤트/분(수동 계수) | 이벤트 테이블 + 씬당 3개 프레임 샘플 | 비트 추가 또는 교체; 채우는 대신 긴 동작을 1.6배로 늘임 | 이 스킬 | 리타임 후 |
| G4 비트당 3D | 모든 3D 비트에 카드 포함: 경로(Blender / Three.js / AI-3D / 2.5D / 없음), 한 문장 이유, ETA, 게이트 증거, 라이선스 | 비트 카드 테이블; Three.js 행: 1초 hf_segment 프레임이 비어 있지 않음 | 재결정; AI-3D 행은 paid-generation-gate 필요 | 이 스킬 | 새 비트 또는 에셋 |
| G5 팔레트 고정 | 하나의 팔레트 테이블; 소스의 모든 16진수와 모든 3D 렌더링이 그 안에 있음 | palette_audit.py 종료 코드 0 (+ --png) | 재색칠/재렌더링; 테이블 없으면 blocked | 이 스킬 | 새 에셋, 새 렌더링, 색상 노트 |
| G6 UI 소싱 | 각 UI/효과 비트에 SOURCES.md 행(출처, 라이선스, 버전, 날짜) 및 시크-세이프 포트 포함; 프로젝트에 npx shadcn add 없음; 21st 미리보기/미디어 복사 없음 | SOURCES.md + 스캔 | 이유와 함께 소스 교체 또는 수동 구축 | 이 스킬 | 새 컴포넌트 |
| G7 시크-세이프 | hf_preflight --strict 0 오류; seek_safe_scan.py 0 오류; 비순차적 시간대의 스냅샷 일치 | 보고서 + 스냅샷 쌍 | 수정; 이유 없이 억제하여 "수정"하지 마십시오 | 이 스킬 | 모든 코드 패치 후 |
| G8 사운드 | 모든 브랜드 이벤트에 브랜드 사운드; VO 아래 SFX -18..-26 dB 및 영상보다 1-3프레임 먼저; 음악 링아웃; 최종 파일 -14 LUFS +-0.5, TP <= -1(하우스 프리셋 v1, Q5) | hf_mix --report, hf_deliver가 FINAL 파일에서 확인 | 리믹스 및 리멀티플렉스(재렌더링 불필요) | render-qa-deliver 측정 | 오디오 또는 영상 리타임 |
| G9 자막 | 브리핑에서 요청하지 않는 한 자막 요소 없음 | ids/classes + <direction> 라인 grep | 제거 / 한 줄로 질문 | 이 스킬 | 브리핑 변경 |
| G10 렌더링 + QA | 이번 라운드 ONE 전체 렌더링; frame_qa 0 플래그; 루브릭 평균 >= 4.0, 모든 차원 >= 3, M1/M3/M7 >= 3; 모든 원장 라인 체크됨 | QA 보고서 + 비평가 출력 | 실패한 게이트로 돌아가기; 에스컬레이션 전 최대 한 번의 수정 라운드 | render-qa-deliver | 각 전체 렌더링 |
게이트 결과 기록(hf/QA.md, 게이트당 한 줄)
G1 pass motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02" (r2 리타임 후 재실행: pass)
G5 blocked 3D render coin_r2.png not readable by palette_audit (not_run) - Pillow 설치 또는 다운스케일
G7 fail seek_safe_scan SS02 index.html:211 Math.random -> 시드 해시; 재검사 대기 중
라인이 없는 게이트는 not_run입니다. 이전 라운드의 기억으로 pass를 작성하지 마십시오: 리타임, 새 에셋 또는 패치는 이를 무효화합니다(재확인 열 참조).
초안 제시(render-qa-deliver가 전달 게이트 소유)
메시지 = 파일을 즉시 + 번호가 매겨진 변경 사항(사용자 자신의 노트 번호 기준) + 체크된 모든 라인의 원장 + 별도 비평가의 루브릭 점수 + 확인되지 않은 사항(Hebrew 교정, 기기 오버레이, 전화기의 음량) + 스튜디오 링크. 플래그가 지정된 프레임, 실패한 게이트 또는 체크되지 않은 원장 라인과 함께 절대 제시하지 마십시오.
참조(다음 경우 로드)
references/seam-camera-event-tables.md- PROMPT.md 작성 또는 검토 시 ALWAYS; 또한agent-content/techniques/frame-spec-prompt.md및clean-smooth-motion.md.references/launch-register-and-pace.md- 레지스터 선택, 속도 불만, 금지 목록, 이징 숫자.references/three-d-decision.md- 깊이 또는 3D가 있는 모든 비트; 2.5D의 경우agent-content/techniques/2-5d.md.references/ui-sources-and-port.md- UI 카드, 효과, 스크린샷 애니메이션;agent-content/techniques/screenshot-rebuild.md.references/seek-safe-and-render-traps.md- 코드 작성, 패치, 렌더링 차이점.references/palette-lock.md,references/typography-hebrew-kinetic.md,references/sound-and-captions.md- DESIGN.md, Hebrew 타이포그래피, 사운드 계획.references/dated-versions.md- 고정 및 라이선스(날짜가 있음; 만료됨 = 알 수 없음).- 스크립트(
python <script> --self-check먼저):motion_spec_check.py,palette_audit.py,seek_safe_scan.py. 텍스트와 패턴을 확인하고 외관은 확인하지 않습니다.
중단 및 에스컬레이션
차단되었을 경우, 추측하지 마십시오: 승인 라인 없음; 렌더링 불가능; 게이트 입력 누락; 가격 또는 라이선스 알 수 없음; Three.js 비트의 1초 세그먼트가 AMD에서 비어 있음(Blender 스프라이트로 대체). 지출, 설치, 게시 또는 제3자에게 메시지를 보내기 전에 질문하십시오. 다른 에이전트 세션에 메시지를 보내지 마십시오. 사용자 노트 "지루함 / AI처럼 보임 / 정적임"이 타임스탬프와 함께 있으면 레지스터 메뉴에서 비트 개념을 한 줄 설명으로 대체하십시오.
유지보수
변동 가능한 사실은 references/dated-versions.md 및 전역 날짜 모듈(hyperframes-traps.md, three-d-routes.md, audio-mix.md)에만 존재합니다. 모든 새 소유자 노트는 이 파일이 아닌 금지 라인에 추가하십시오. 지정되고 결정론적인 검사만 수행; 모델 평가는 실행하지 않음(결정 기본값 Q4).