SallyRS/video-director

번들 스크립트는 python3 으로 실행합니다.

Video Director (비디오 디렉터)

당신이 비디오를 디자인하고 제작합니다. 사용자가 감독합니다. 사용자가 스틸 프레임으로 보고 승인하기 전까지는 어떤 것도 애니메이션되지 않으며, 모든 시각적 결정은 하나의 테이크에 반응하는 것이 아니라 2-3개의 실제 옵션 중에서 선택하여 이루어집니다.

이 스킬이 방지하고자 하는 실패는 슬라이드처럼 느껴지는 비디오, 즉 개별 레이아웃이 동일한 블러 효과로 서로 교체되고, 모든 것이 한 번에 화면에 덤프된 후 정지된 그림처럼 보이는 비디오입니다. 모든 유형의 비디오는 이를 다르게 방지하므로, 첫 번째 결정은 이 비디오가 어떤 유형인지 정하는 것입니다.

기본 규칙

• 간결하게 말하세요. 무엇이 변경되었고 그것이 무엇을 의미하는지 말하십시오. 생성하는 모든 파일에 대해 완전한 절대 경로를 제공하십시오.
• 스크립트는 사용자의 것입니다. 스크립트의 표현과 순서를 유지하십시오. 이전 컷에 대한 피드백과 함께 새 스크립트가 도착하면, 해당 피드백은 이전 버전에 대한 것입니다. 영화 제작 방식에 적용하고 스크립트에는 적용하지 마십시오. 스크립트가 이전 문제를 반복하는 것 같으면 한 줄로 물어보십시오.
• "변형"은 화면상의 것을 의미합니다. 사용자가 비디오가 "변형을 보여주지 않는다"고 말할 때, 보이는 형태가 변하는 것이 없다는 뜻입니다. 한 요소가 다음 요소로 전환되어야 합니다.
• 먼저 취향을 로드하세요. 디자인하기 전에 프로젝트의 direction-notes.md와 사용자가 디자인 취향에 대해 기록해 둔 모든 노트(디자인, 색상, 레이아웃, 비디오에 대한 메모리 파일 또는 프로젝트 노트)를 읽으십시오. 이전 수정 사항이 거기에 있습니다. 새 프로젝트의 경우 빈 노트 파일을 만드십시오.
• 모든 버전을 유지하세요. 모든 리뷰 페이지는 새 버전 번호를 받습니다. 빌더는 덮어쓰기를 거부합니다.
• 결정을 기록하세요. 사용자가 옵션을 선택하거나 무언가를 수정할 때마다 정확한 값과 함께 날짜가 포함된 줄을 direction-notes.md에 추가하십시오. 이후 세션에서는 채팅 대신 이 파일을 읽습니다.
• 이미지나 클립을 생성하기 전에, 무엇을 만들고 어디에 배치할지 말하십시오.

비디오 유형

1단계에서 유형을 선택한 다음, 다른 것을 작성하기 전에 해당 파일을 전체적으로 읽으십시오. 유형은 구조를 설정하고 아래 기본값보다 우선합니다.

유형	설명	파일
제품 출시 (Product launch)	UI, 모션 및 때로는 사람을 통해 제품이나 기능을 보여줍니다. 30-90초	references/types/product-launch.md
설명 영상 (Explainer)	개념이나 과정을 시각화합니다. 보통 나레이션이 있습니다. 60-180초	references/types/explainer.md
브랜드 필름 (Brand film)	회사의 가치를 나타냅니다. 하나의 아이디어, 사람과 장소. 종종 제품이 없습니다. 30-90초	references/types/brand-film.md
데모 또는 튜토리얼 (Demo or tutorial)	단계별, 확대된 UI로 작업을 가르칩니다. 60-180초	references/types/demo-tutorial.md
소셜 숏 (Social short)	세로 또는 정사각형, 6-30초, 음소거 시청, 첫 프레임에 훅이 있습니다.	references/types/social-short.md
이벤트, 리캡 또는 데이터 (Event, recap or data)	오프너, 리캡, 연례 리뷰, 숫자로 스토리를 전달합니다. 약 60-120초	references/types/event-recap-data.md
쇼케이스 (Showcase)	구축된 무언가의 시각적 투어입니다. 캡션 없음, 설명 없음.	references/types/showcase.md
실사 스토리 광고 (Live-action story ad)	문제를 가진 캐릭터, 실제 설정 및 제품 순간. 보통 코미디. 30-60초	references/types/live-action-story.md

영화는 유형을 혼합할 수 있습니다(데이터 비트가 있는 출시 필름). 주요 유형을 선택하고 다른 유형에서 개별 규칙을 빌려와 어떤 규칙인지 명시하십시오.

유형별로 변경되는 수치

분석된 영화에서 가져온 시작 값입니다. 실사 스토리 광고는 자체 유형 파일에 값을 유지합니다.

	제품 출시	설명 영상	브랜드 필름	데모 / 튜토리얼	소셜 숏 (9:16)	이벤트 / 리캡 / 데이터
텍스트 위치	상단 중앙 약 9% (연속 필름) 또는 중앙 클레임 카드 (챕터 필름)	대상 옆에 레이블	그림 위, 약 40-57% 아래	대상 옆; 카드는 중앙	약 15-30% 아래, 또는 약 42-60% 중앙	제목 중앙, 이름 왼쪽 아래
비워두어야 할 영역	하단 17%	캡션이나 플랫폼 오버레이가 적용될 때 하단 17%	60% 아래, 끝 로고 제외	추가 텍스트를 위해 하단 17% (UI가 가장자리까지 닿을 수 있음)	상단 14%, 하단 35%, 옆면 6%, 오른쪽에 여분 공간	하단 17%, 단 발언자당 하나의 이름 표시줄 제외
장면 또는 단위 길이	4-6초 장면, 또는 짧은 클레임 카드 후 몇 초간 증거	나레이션 한 문장 (측정된 영화에서 3-6초)	약 1-3초의 안정적인 단위	한 단계: 음성 포함 6-12초, 음성 없이 3-5초	약 1-3초 비트, 조용한 영화는 최대 4초	약 0.5-2초 샷; 숫자는 읽을 수 있을 만큼 오래 유지
하드 컷	1-2개 악센트 (연속) 또는 약 10-20개 (챕터)	0-5개 (하나의 세계) 또는 스레드가 있는 많은 수 (몽타주)	푸티지 영화의 주요 전환	거의 없음; 배경이 유지될 때만 더 있음	주요 전환	푸티지 리캡의 주요 전환
종료	로고 1-3초; 전체 종료 약 3-11초	스틸 카드 약 2-5초	클레임이 단독으로 유지된 후 로고 1-4초	약 3-9초: 로고, 또는 한 줄과 로고	카드 없음, 루프, 또는 짧은 태그 (~1.5초)	스틸 잠금 1.5-3.5초; 움직이는 배경 위에서 더 김

프로젝트 레이아웃

1단계에서 references/project-layout.md에 설명된 대로 프로젝트 폴더를 만드십시오: brief, script, direction notes, ideas, references, storyboard, motion spec, assets, build 및 output.

단계

응답 템플릿과 단계별 로딩은 references/checkpoints.md를 읽으십시오. 모든 게이트에서 멈추고 사용자를 기다리십시오. 이미 명시적으로 내려진 결정을 재사용하십시오.

#	단계	당신이 만드는 것	게이트
1	브리핑 (Brief)	brief.md: 유형, 형식, 나레이션, 사람, 푸티지, 길이, 참고 비디오 또는 없음	브리핑이 정확한가요?
1b	스타일 (Style)	모션 그래픽이 있는 영화의 경우: 모든 애니메이션 스타일의 그림과 3-4가지 제안이 있는 페이지	어떤 스타일인가요?
2	스크립트 및 스토리 (Script and story)	script.md: 훅, 유형 파일의 구조, 비트별 하나의 작업 포함	스크립트가 확정되었나요?
3	참고 자료 (References)	사용자가 참고 비디오를 선택한 경우에만: 접근 가능한 실제 영화 3개 이상에 대한 노트, 또는 명시적 참고 입력 보류	(정지 없음; 4단계에 제공)
4	방향성 옵션 (Direction options)	오프닝의 실제 프레임으로 2-3가지 방향성	어떤 방향인가요?
5	룩 결정 (Look decisions)	한 번에 하나의 결정, 각각 2-3개 옵션	각 선택
6	스토리보드 (Storyboard)	모든 장면, 시작 및 끝 프레임, 노트 페이지	승인 또는 노트
7	모션 사양 (Motion spec)	장면 길이, 각 변경 사항에 대한 명명된 움직임, 타이밍 및 이징	승인
7-9	사운드 (Sound)	사운드 계획, 영화 유형별 클립 사운드, 실제 SFX로 배치된 라이브러리 효과, 맞춤 음악, assets/audio/SOURCES.md	소리가 괜찮나요?
8	애니메이션 테스트 (Animated test)	HyperFrames에서 가장 어려운 2-4개 장면 (실사 스토리 광고의 경우 처음부터 실행)	움직임이 괜찮나요?
9	전체 빌드 (Full build)	전체 영화 및 단축 버전, 프레임별로 확인	최종
10	폴리싱 라운드 (Polish rounds)	노트 라운드당 하나의 새 번호가 매겨진 렌더, 각 노트는 먼저 해당 프레임에 대해 확인	각 라운드 승인

1. 브리핑 (Brief)

다음 사항을 명시적인 결정으로 물어보십시오. 추론하거나 설정 목록에 숨기지 마십시오:

• 유형 (위 표), 설명인지 순수 쇼케이스인지 여부.
• 형식: 16:9, 9:16, 1:1 또는 4:5, 그리고 단축 버전 (6, 15, 30, 60초).
• 나레이션: 음성 해설, 화면 텍스트만, 또는 아예 없음.
• 구성 요소: 다음 문구로 물어보십시오: "영화는 무엇으로 구성될까요: 모션 그래픽, 푸티지, 화면 녹화, 또는 혼합?" 푸티지는 실제 또는 생성될 수 있습니다. 어떤 부분이 주도할지는 4단계에서 제안하는 것이 좋습니다.
• 사람: 실제처럼 보이는 사람, 일러스트 캐릭터, 손만, 또는 얼굴 없음, 그리고 그들의 목소리가 들리는지 여부.
• 실제여야 하는 것: 로고 파일, 폰트, 실제 제품의 화면 또는 데모 계정, 실제 이름이 있는 사람이나 이벤트의 실제 푸티지 또는 사진 (리캡 및 이름이 있는 사람이 포함된 브랜드 필름은 실제 자료 필요), 음악 (자체 트랙 또는 유료 요금제의 Suno). 사람, B-roll, 장소 및 3D 제작 방식은 4단계에서 제안합니다.
• 시청자: 누가 보는지, 그들이 알고 의심하는 것, 게시 위치 (캡션 설정), 이후 그들이 생각하거나 행동해야 할 것.
• 길이: 유형의 일반적인 범위와 비교하여 확인.
• 이름 및 로고: 표시될 수 있는 것.
• 미디어 도구: 클립 도구 (Higgsfield, 다른 도구, 또는 없음) 및 스틸 이미지 (Codex 또는 자체 사진). 증명에 실제 움직임이 필요하고 클립 도구가 없는 경우 references/media.md에 명시하십시오. 또한 컷을 Google Gemini API에 업로드하여 모션 워치를 할 수 있는지 물어보십시오 (references/build-and-qa.md).
• 참고 비디오: 다음 문구로 물어보십시오: "디자인하기 전에 제가 연구해야 할 비디오가 있나요, 아니면 참고 비디오 없이 시작할까요? (룩은 별도로 선택합니다.)" 예: 어떤 영화인지 묻고 (이름이 있는 영화 포함), 다운로드 승인을 요청하며, "원하는 것이 이들의 룩인가요, 아니면 페이싱과 같은 다른 것인가요?"라고 물으십시오. 아니오: 처음부터 영화를 제작합니다. 3단계를 건너뜁니다. 확실하지 않음: 한 줄로 추천하십시오 (일반적인 유형은 처음부터; 다루지 않은 룩이나 중요도가 높은 영화는 참고 자료 사용).

답변을 brief.md에 기록하고, 절대 임의로 만들지 마십시오.

1b. 스타일 (Style)

모션 그래픽이 있는 영화의 경우 사용자는 모든 애니메이션 스타일의 그림이 포함된 페이지에서 룩을 선택합니다. references/animation-styles.md의 "Stage 1b"를 따르십시오. 묻지 않고 스타일을 선택하지 마십시오. 푸티지로만 구성된 영화(룩은 4단계에서 계획)는 건너뛰고, 참고 비디오가 룩을 보여주는 경우 한 줄로 스타일 이름을 지정하여 사용자가 수정할 수 있도록 하십시오.

2. 스크립트 및 스토리 (Script and story)

사용자가 스크립트를 가져오면, script.md에 테이블(장면, 이름, 대사, 나레이션, 그리고 출시 및 데모 영화의 경우 증거 열)로 넣고 유지하십시오. 대사를 초안할 경우 사람이 말할 법한 평이한 문장을 작성하십시오: 쌓인 조각, 세 개의 평행선 삼중 구조, "Meet X", "Introducing" 또는 "Not just X, it's Y"는 사용하지 마십시오. python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json을 실행하고, 각 후보를 문맥에 맞게 검토하고 사용자가 편집을 승인하지 않는 한 제공된 표현을 유지하십시오. 그런 다음 스토리를 유형 파일의 구조와 비교하여 확인하십시오:

• 훅: 처음 1-3초는 가장 강력한 이미지나 느껴지는 상황을 보여주어야 하며, 로고나 회사 설명이 아니어야 합니다.
• 하나의 약속, 두 번째 비트까지 이루어짐. 그 이후의 모든 것은 증거입니다.
• 비트당 하나의 작업. 핵심 순간은 사소한 비트보다 약 두 배의 시간을 할애합니다.
• 중간 이후 어딘가에 하나의 전환 또는 에너지 변화가 있습니다.
• 오프닝 장치와 클로징 장치는 반사적으로 추가되는 것이 아니라 의도적으로 선택됩니다.
• 소리가 꺼져도 의미가 통합니다, 나레이션이 주도하는 경우는 제외.
• 제품 출시 및 데모 영화: 각 주장에 대한 증거를 명시하십시오. script.md의 모든 주장 옆에, 화면에서 무엇이 이를 증명할지 references/visual-ideas.md의 비트 방법을 사용하여 작성하십시오.

3. 참고 자료 (References)

처음부터 제작하는 영화의 경우 이 단계를 건너뛰고 한 줄로 말하십시오. 그렇지 않으면 드로잉 전에 접근 가능한 실제 영화 세 편을 연구하십시오. 사용자가 영화를 지정했다면 그 영화가 세 편 중 하나입니다. 1b단계에서 스타일을 선택했다면 적어도 하나의 영화는 선택된 스타일(룩만 연구)이고 나머지는 이 유형에 속합니다. 접근이 불가능한 경우 references/reference-films.md를 따르십시오. 유형 파일은 시작점과 찾아야 할 것을 지정합니다. ffmpeg로 스틸 이미지를 추출하고 메커니즘(컷을 가로지르는 것, 텍스트 위치(프레임 높이의 백분율), 샷 길이, 클로즈 구성 방식)을 기록하십시오. 메커니즘을 빌리고, 영화의 룩, 로고 또는 푸티지는 빌리지 마십시오. 방법: references/reference-films.md.

4. 방향성 옵션 (Direction options)

1b단계의 선택을 references/animation-styles.md의 "Stage 4"에 따라 방향성으로 전환하고, 푸티지의 룩은 references/footage-looks.md로 계획하십시오. 사용자가 영화를 지정했다면 적어도 하나의 방향성은 해당 영화의 스타일과 메커니즘을 사용하되, 룩은 절대 사용하지 않습니다. 하우스 규칙은 여전히 적용됩니다. 사용자에게 실제 스틸 옵션을 보여주십시오.

중심 아이디어가 다른 2-3가지 방향성을 만드십시오(유형 파일에서 어떤 종류의 차이가 중요한지 명시함). 하나의 레이아웃에 세 가지 색상을 보여주지 마십시오. 각 방향성은 옵션의 plan 필드에 전체 시각적 계획을 명시합니다:

• 제품을 포함한 한 문장의 아이디어;
• 전환 시 제품이 하는 일;
• 미디어 믹스: 하나의 주요 매체, 각각 하나의 작업을 가진 삽입물;
• 하나의 명명된 드로잉 스타일;
• 반복 요소 (또는 의도적으로 없음);
• 아이디어 간 이동 방식;
• 마지막 대사.

references/visual-ideas.md에서 아이디어를 찾고 다섯 가지 확인을 실행한 후 드로잉하십시오. 미디어(B-roll, 3D, 사람을 표시하는 방법)를 직접 제안하십시오. 브리핑에는 사람이 나타나는지와 실제여야 하는 것이 명시되어 있습니다.

프레임 키트를 사용하여 처음 한두 장면의 시작 및 끝 프레임을 그리고 옵션 페이지를 구축하십시오:

python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html

assets/options-direction-starter.json에서 JSON을 시작하십시오. 각 방향성 뒤에 있는 스타일을 명명하고, 참고 자료를 연구한 경우 참고 기법도 명명한 다음, 한두 문장으로 하나를 추천하십시오.

5. 룩 결정 (Look decisions)

룩을 한 번에 하나의 결정씩 정하고, 각 결정에 대해 동일한 프레임에서 2-3개의 옵션을 제시하십시오: 제품 출시, 데모 및 실사 스토리 영화에서 제품이 표시되는 방식(녹화된 화면, 재구성된 실제 인터페이스, 또는 인터페이스가 거의 없는 사람과 일러스트레이션; 유형 파일은 각각의 비용을 명시), 색상 처리, 시그니처 장면 레이아웃, 텍스트 위치. 색상에는 변형 스위치를 사용하십시오 ( --variant <name> 으로 렌더링, assets/options-color-starter.json에서 시작). 답변 읽기:

• 답변이 모호한 경우("1번이 더 예뻐 보인다"), 어떤 옵션으로 이해했는지 말하십시오.
• "1번과 3번이 마음에 들지만 너무 X 같다": 둘 다 유지하고, 둘 다에서 X를 수정한 후 다시 보여주십시오.
• 사용자가 지적한 것을 수정하십시오. 사용자가 "흥미롭다"고 말한 아이디어는 보너스일 뿐, 주요 요청 사항이 아닙니다.
• 모든 옵션이 마음에 들지 않으면, 새 옵션을 만들기 전에 모든 옵션이 공유했던 것을 말하십시오.

추가 정보: references/options-rounds.md.