하프톤 콜라주 모션
창작 과정을 두 단계로 나눕니다: 먼저 시각적 참고 자료를 편집 가능한 사양으로 디코딩하고, 승인된 정지 프레임 또는 투명 레이어에서 애니메이션을 구축합니다. 기본적으로 로컬 호환 워크플로우를 사용하며, 각 생성기와 렌더러를 실제로 기록합니다.
제공 범위 선택
먼저 사용자가 원하는 수준을 판단합니다:
- 분석만: 분해 결과, 범용 프롬프트, JSON 시각적 사양 제공.
- 정지 프레임만: 분석을 완료하고 정지 프레임을 생성 및 선별합니다.
- 콜라주 모션: 정지 프레임 승인 후 무음 애니메이션 원본을 제작합니다.
- 전체 비디오: 이 스킬을 시각적 단계로 사용하고, 이후 비디오 제작 계약, 자막, 더빙, 디지털 휴먼 및 아카이빙 규칙을 따릅니다.
참조 이미지가 없는데 사용자가 명시적으로 "이 이미지를 분석해줘"라고 요청하는 경우, 먼저 이미지를 요청합니다. 설명만 있는 경우, 알려진 정보를 반복해서 묻지 않고 바로 사양 초안을 작성합니다.
실행 경로 선택
기본적으로 로컬 경로를 사용합니다:
- 정지 프레임 또는 레이어:
imagegen스킬을 로드하고 Codex 내장image_gen을 사용합니다. OpenAI API, CLI 또는 다른 이미지 생성 모델로 기본 전환하지 않습니다. - 간단한 레이어별 조립:
scripts/render_assembly.py를 사용합니다. - 복잡한 레이아웃, 여러 전환 또는 컴포넌트 수준 타임라인:
hyperframes스킬을 로드하고, 이 사양과 출처 선언을 그대로 사용합니다.
사용자가 명시적으로 Arcads, Nano Banana, Seedance 또는 Kling을 요청하고, 해당 도구를 현재 세션에서 호출할 수 있는 경우에만 references/provider-boundaries.md를 읽고 외부 경로로 진입합니다. 로컬 브랜드 이미지, 제품 이미지 또는 인물 이미지를 업로드하기 전에 업로드 위치, 비용 및 용도를 설명하고 사용자 확인을 받아야 합니다.
프롬프트, 파일 이름 또는 예상 모델을 기반으로 실제 제공자를 추론하지 마십시오. 실제로 호출되지 않은 모델은 "대상 프롬프트" 또는 "호환 스타일"로만 작성하고, 출력 출처로 작성하지 마십시오.
기본 제작 체인 (엄격한 기본값)
다음 순서를 엄격히 따릅니다:
- 참조 이미지 또는 설명을 디코딩하여 분해 결과, 범용 프롬프트 및 JSON 시각적 사양을 생성합니다.
- Codex 내장
image_gen을 사용하여 각 장면에 대해 개별적으로 완전한 정지 프레임을 생성합니다. 브랜드 이미지, 제품 이미지 또는 인물 참조는 모든 관련 호출에서 계속 표시되어야 합니다. - 생성 결과를 Codex 기본 생성 디렉토리에서 프로젝트의
assets/stills/로 복사합니다. 프로젝트가$CODEX_HOME/generated_images/아래 파일을 장기간 참조하지 못하게 합니다. - 사용자에게 완성된 정지 프레임을 보여줍니다. 사용자가 명시적으로 정지 프레임을 확인하기 전까지 애니메이션, FFmpeg 조립 계획 또는 공식 비디오를 생성해서는 안 됩니다.
- 정지 프레임이 확인되면 Codex 내장
image_gen을 사용하여 각 개별 종이 오려내기 요소를 생성합니다. 투명 PNG가 필요한 경우, 먼저 단색 크로마키 배경을 생성한 다음imagegen스킬이 지정한remove_chroma_key.py로컬 크로마키 제거 스크립트를 호출하고 알파 프리체크를 수행합니다. - 승인된 정지 프레임을 사용하여 최종 구도를 잠그고, 투명 레이어로
assembly-plan.json을 작성한 다음, 로컬 FFmpeg 또는 HyperFrames를 사용하여 빈 배경에서 요소를 하나씩 조립합니다. - 미디어 프로브, 키프레임 검사 및 출처 매니페스트를 완료합니다. 기본적으로
actual_still_provider: codex-image-gen,actual_motion_provider: local-ffmpeg또는hyperframes,external_uploads: false를 기록합니다.
사용자가 모든 정지 프레임 또는 투명 레이어를 직접 제공하는 경우 actual_still_provider를 user-supplied로 변경합니다. 실제로 외부 호출이 발생한 경우에만 Arcads, Nano Banana, Seedance 또는 Kling을 입력할 수 있습니다.
단계 A: 참조 디코딩
첫 디코딩 시 references/visual-contract.md와 references/schemas.md를 전체 읽습니다. 다음 순서로 출력합니다:
### 분해: 매체 및 기법, 색상 필드, 요소 및 절단선, 구도 및 계층, 단일 장면 아이디어, 텍스트, 안전 영역, 무드.### 범용 프롬프트: "위 이미지"에 의존하지 않는 자기 완결적 자연어 프롬프트로 작성합니다.### JSON 사양:assets/templates/collage-spec.json에서 복사하여 채우고, 유효한 JSON을 유지합니다.
관찰 내용을 재현 가능한 매개변수로 작성합니다. 예를 들어 "종이 느낌"이라고만 쓰지 말고 "검은색 흰색 원형 하프톤, 약 65 lpi, 흰색 가는 외곽선, 오른쪽 아래 6px 부드러운 그림자"와 같이 씁니다.
여러 참조 이미지가 있는 경우 각각을 개별적으로 디코딩한 후 공통 스타일 요약을 한 단락 추가합니다. 사용자가 "외관 유지, 색상만 변경"을 요청하는 경우 해당 필드만 변경하지만, 전체 JSON을 다시 출력합니다.
단계 B: 장면 계획
각 장면은 하나의 핵심 아이디어만 유지합니다. 각 장면에 대해 다음을 고정합니다:
- 배경색 및 캔버스 크기.
- 주요 요소, 보조 요소, 계층 및 최종 좌표.
- 텍스트 내용, 타이포그래피 및 편집 가능 방식.
- 빈 배경에서 완전한 구도까지의 진입 순서.
- 실제 인물, 디지털 휴먼, 자막, 로고 및 플랫폼 UI의 회피 영역.
assets/templates/assembly-plan.json에서 조립 계획을 수립합니다. 최종 영상은 우선적으로 layered 모드를 사용하며, 각 요소는 알파 채널이 있는 PNG로 제공됩니다. bands 모드는 전체 정지 프레임을 슬라이드인 하는 스트립으로 자르는 방식으로, 빠른 미리보기 또는 사용자가 명시적으로 동의한 단순화된 버전에만 사용할 수 있습니다.
단계 C: 정지 프레임 생성 및 승인
imagegen 스킬을 로드하고 Codex 내장 image_gen을 사용하여 먼저 완전한 정지 프레임을 생성하거나 조합한 다음 사용자에게 보여주어 승인을 받습니다. 브랜드 또는 제품 참조는 모든 관련 생성 호출에서 계속 표시되어야 합니다.
로컬 공식 모드는 다음 순서로 작동합니다:
- 각 장면에 대해 한 번의 독립적인 내장
image_gen호출을 시작하여 전체 구도 정지 프레임을 생성합니다. 다른 장면을 한 번의 호출로 큰 이미지에 합치지 마십시오. - 선택된 정지 프레임을 프로젝트
assets/stills/에 복사하고 최종 프롬프트와 참조 이미지 역할을 기록합니다. - 정지 프레임을 표시하고 사용자의 명시적 확인을 받습니다. 확인되지 않은 경우 프롬프트 조정 및 재생성만 허용됩니다.
- 확인 후 개별 콜라주 요소를 생성합니다.
imagegen의 크로마키 + 로컬 크로마키 제거 경로를 따라 투명 PNG를 얻고, 흰색 키라인과 부드러운 그림자를 유지합니다. - 승인된 정지 프레임을 사용하여 레이어의 크기, 좌표 및 계층을 보정합니다. 텍스트는 기본적으로 HyperFrames, HTML 또는 Remotion의 편집 가능한 텍스트 레이어로 유지됩니다.
- 장면 정지 프레임 및 레이어 목록을 내보낸 후 애니메이션 단계로 진입합니다.
내장 image_gen을 사용할 수 없거나 실패하는 경우, 자동으로 CLI로 전환하지 마십시오. 먼저 사용자에게 CLI/API 경로에 OPENAI_API_KEY가 필요함을 알리고, 사용자가 명시적으로 동의한 경우에만 전환합니다.
완전한 정지 프레임 하나만 있는 경우, 먼저 bands 모드를 사용하여 저비용 모션 미리보기를 할 수 있지만, 직사각형 스트립 슬라이드인을 실제 "요소별 조립"으로 설명해서는 안 됩니다.
단계 D: 로컬 레이어별 조립
먼저 사양과 계획을 검증합니다:
python3 .claude/skills/editorial-collage-motion/scripts/validate_collage.py \
--spec /absolute/path/collage-spec.json \
--plan /absolute/path/assembly-plan.json \
--project /absolute/path/project
그런 다음 무음 원본을 렌더링합니다:
python3 .claude/skills/editorial-collage-motion/scripts/render_assembly.py \
--project /absolute/path/project \
--plan /absolute/path/assembly-plan.json \
--output /absolute/path/project/renders/collage-assembly.mp4
애니메이션은 단색 빈 공간에서 시작해야 하며, 요소는 계획에 따라 화면 가장자리에서 진입하여 제자리에 배치되어야 합니다. 카메라 흔들림, 전체 이미지 이동 또는 지속적인 확대/축소로 조립을 가장하는 것은 금지됩니다. 배치 후에는 읽을 수 있는 충분한 시간을 확보합니다.
단계 E: 품질 관리 및 출처 선언
references/qc-and-provenance.md를 전체 읽고, 최소한 다음을 완료합니다:
- 미디어 프로브: 크기, 비율, 프레임 레이트, 길이, 코덱 및 디코딩 가능 여부.
- 첫 프레임, 각 장면 배치 전후, 장면 중간 지점 및 마지막 프레임 샘플링.
- 빈 공간 시작, 요소별 진입, 그림자 안정성, 텍스트 가독성, 안전 영역 및 화면 밀도 검사.
render-manifest.json이 실제 출력, 입력 계획 및 생성기와 일치하는지 확인.
제작 노트에 다음을 명확히 기재합니다:
actual_still_provideractual_motion_providerexternal_uploadscompatible_render여부 및 호환되는 시각적 사양
현재 세션에서 Arcads MCP를 호출하지 않은 경우, "Arcads 스타일 호환 렌더링" 또는 "editorial collage 로컬 렌더링"으로 고정하고, Nano Banana 또는 Seedance 네이티브 출력으로 작성하지 마십시오.
리소스
references/visual-contract.md: 스타일 용어, 엄격한 시각적 계약 및 반례.references/schemas.md: 시각적 사양 및 조립 계획 필드 설명.references/provider-boundaries.md: 로컬 및 외부 생성 경로의 권한 및 공개 경계.references/qc-and-provenance.md: 제공 품질 관리 및 출처 기록.assets/templates/collage-spec.json: 복사 가능한 시각적 사양 템플릿.assets/templates/assembly-plan.json: 복사 가능한 로컬 조립 계획 템플릿.assets/templates/assembly-plan-bands.json: 완전한 정지 프레임만 있을 때 사용하는 스트립 미리보기 템플릿.scripts/validate_collage.py: 사양, 계획 및 자산 사전 검사.scripts/render_assembly.py: FFmpeg 기반 확정적 레이어별 또는 스트립 어셈블러.