비디오 → 슈퍼프롬프트은(는) 무엇을 하나요?
목표
사용 가능한 모든 참조 영상을 빌더가 바로 사용할 수 있는 프롬프트로 변환합니다. 이 프롬프트는 영상이 보여주는 내용, 움직임 방식, 재구축 방법, 필요한 에셋이나 생성 미디어를 포착합니다. 기본 출력은 하나의 붙여넣기 가능한 프롬프트이며, 사용자가 아티클, 에셋 팩 또는 구현을 요청한 경우에는 다릅니다.
워크플로우
-
소스 영상 찾기.
- 로컬 경로, 업로드된 파일, URL, 브라우저에서 볼 수 있는 영상, 아티클 에셋, 또는 저장소 미디어를 허용합니다.
- 영상이 참조되었지만 접근할 수 없는 경우, 세부 사항을 임의로 만들기 전에 정확한 파일이나 URL을 요청합니다.
- 사용자가 정확한 재현을 원하는 경우, 프롬프트를 작성하기 전에 해당 영상과 연결된 소스 HTML/CSS/JS 또는 로컬 페이지를 검사합니다.
-
영상을 기술적으로 검사합니다.
- 로컬 파일의 경우
ffprobe를 실행하여 재생 시간, 해상도, 프레임레이트, 코덱, 파일 크기를 확인합니다. ffmpeg를 사용하여 대표 프레임을 추출하며, 균일한 썸네일보다 타임라인의 주요 지점을 선호합니다.- 권장되는 빠른 검사:
ffprobe -v error -show_entries format=duration,size:stream=width,height,r_frame_rate -of json "$VIDEO" mkdir -p /tmp/video-frames ffmpeg -y -i "$VIDEO" -vf fps=1 /tmp/video-frames/frame-%03d.jpg - 길거나 스크롤이 많은 영상의 경우 시작/중간/끝과 보이는 전환 순간도 함께 추출합니다.
- 로컬 파일의 경우
-
계층별로 분석합니다.
- 스토리: 페이지/앱의 목적, 감정적 흐름, 섹션 순서, 비트 간 전환.
- 화면/레이아웃: 뷰포트 프레이밍, 그리드, 고정 영역, 카드, 미디어, 오버레이, 여백, 내비게이션, 푸터.
- 모션: 나타나는 타이밍, 이징, 패럴랙스, 마스크, 고정 섹션, 스크롤 스크러빙, 호버/탭 상태, 반복되는 주변 모션, 카메라 움직임.
- 시각 디자인: 타이포그래피, 색상 팔레트, 표면, 테두리, 그림자, 질감, 아이콘, 이미지/비디오 처리.
- 기술 재구축: CSS/네이티브 API, IntersectionObserver, Web Animations API, GSAP ScrollTrigger, Lenis, Framer Motion/Motion One, Three.js/WebGL, 캔버스, video.currentTime 스크러빙, 캐러셀, 또는 기타 도메인 라이브러리.
- 접근성/성능: reduced motion, 모바일 동작, 터치/키보드 상태, 지연 로딩, 비디오 프리로드, 픽셀 비율 제한, 정적 대체.
-
에셋 계획.
- 에셋 맵을 생성합니다. 제공된 정확한 URL, 사용된 로컬 파일명, 또는 아직 생성이 필요한 에셋의 자리표시자 이름을 포함합니다.
- AI 에셋이 필요한 경우, 이미지 플레이트, 비디오 클립, WebGL/캔버스 요소, 포스터, 스프라이트, 마스크, 텍스처 오버레이에 대한 별도의 프롬프트를 만듭니다.
- 사용자가 특정 모델이나 API를 지정한 경우, 프롬프트에 정확히 그대로 보존하고 이미지 프롬프트와 비디오 프롬프트를 분리합니다.
-
슈퍼프롬프트 작성.
- 사용자가 다른 형식을 요청하지 않는 한, 붙여넣기 가능한 프롬프트를 위해 단일 펜스
text블록을 사용합니다. - 최종적으로 구축할 대상과 참조 경계(정확한 재현 vs 영감을 받은 각색)로 시작합니다.
- 포함할 내용: 에셋 맵, 브랜드/콘텐츠, 전반적인 디자인 언어, 레이아웃 규칙, 섹션별 구성, 모션 시스템, 스크롤 시스템, 비디오 동작, WebGL/Three.js 동작, 반응형 요구사항, 접근성/성능, 안티패턴.
- 주요 섹션마다 목적, 레이아웃, 시각적 세부 사항, 애니메이션, 상호작용, 스크롤 동작, 라이브러리/API 선택, reduced-motion 대체를 지정합니다.
- “아름답게 만들어”, “비슷한 애니메이션”, “멋진 전환” 같은 모호한 표현을 피합니다. 취향을 구체적인 빌드 지침으로 변환합니다.
- 사용자가 다른 형식을 요청하지 않는 한, 붙여넣기 가능한 프롬프트를 위해 단일 펜스
-
최종 확정 전에 확인합니다.
- 프롬프트의 모든 에셋 경로/URL이 존재하거나 명확하게 자리표시자로 표시되어 있는지 확인합니다.
- 스크린샷/프레임이 생성된 경우 파일이 비어 있지 않고 대표성을 띠는지 확인합니다.
- 아티클이나 저장소 결과물을 작성하는 경우, 로컬 워크스페이스 지침을 따르고 더티 워크트리 스테이징을 좁게 유지하며 필요할 때 커밋합니다.
출력 모드
- 프롬프트만: 붙여넣기 가능한 프롬프트를 제공하고, 유용할 경우 그 위에 짧은 에셋 맵을 추가합니다.
- 아티클: 로컬 프레임/비디오 증거, 매니페스트, 프롬프트와 함께
content.md를 생성합니다. 현재 저장소의 아티클 규칙을 따릅니다. - 구현 개요: 프롬프트 뒤에 빌드 계획과 QA 체크리스트를 추가합니다.
- 에셋 생성 팩: 프롬프트를 배경 이미지, 비디오 클립, 스프라이트/WebGL, 포스터, 최종 페이지 프롬프트로 분할합니다.
품질 기준
- 프롬프트는 원본 영상을 보지 않고도 상호작용을 재구축할 수 있을 정도로 길어야 합니다.
- 영상의 순서, 템포, 눈에 띄는 특성을 보존해야 합니다.
- 정확한 모션 메커니즘(고정 섹션, 스크러빙된 타임라인,
video.currentTime, 패럴랙스 레이어, 불투명도 나타남, 변환, 마스크, 셰이더, 파티클 필드, 호버 상태, 또는 캐러셀 물리)을 명명해야 합니다. - 매번 모바일 동작과 reduced-motion 동작을 포함해야 합니다.
- 무엇을 피해야 하는지 명시해야 합니다. 특히 일반적인 랜딩 페이지 섹션, 장식용 블롭, 일치하지 않는 스톡 미디어, 스크롤 스크러빙이 필요할 때 자동 재생만 사용하는 비디오, 텍스트 겹침을 피해야 합니다.
참고 자료
- 처음부터 최종 프롬프트를 작성하거나 사용자가 “전체 상세 프롬프트”를 요청할 때
references/superprompt-template.md를 읽으세요.