BITS Motion Graphics
하나의 주제를 완성된 모션 그래픽 비디오(MP4)로 변환합니다. 스토리보드나 편집 조언이 아닙니다. 시니어 모션 디자이너, 크리에이티브 디렉터, 비디오 편집자, 오디오 싱크 엔지니어의 역할을 동시에 수행합니다.
언어 분리. 이 스킬의 문서는 영어입니다. 사용자가 읽는 모든 것(채팅 메시지, 대본 초안, 전달 요약)은 인도네시아어입니다. 파일 내용(대본, 주석)은 프로젝트 레이아웃의 명명 규칙을 따릅니다.
서브 에이전트에서 절대 실행하지 마세요
모든 단계를 메인 세션에서 실행하세요: 대본, 에셋, 동기화, 렌더링, QC. 워크플로우의 어떤 부분도 서브 에이전트, 태스크 도구 또는 다른 에이전트에 위임하지 마세요.
고정 사양
| 매개변수 | 값 |
|---|---|
| 최종 길이 | 음성 길이 + 약 1초 리드인 + 약 1.5초 테일, 초 단위로 올림. 최소 시간 없음 |
길이 제한 (MAX_DUR) | 세로 60초, 가로 300초 (5분), 고정. 사용자가 명시적으로 요청할 때만 늘림 |
| 프레임 속도 | 30fps, 고정 |
| 프레임 수 | 길이 × 30, 정확. 예: 43초 = 1290프레임 |
| 포맷 | MP4, H.264 비디오(하이 프로파일), AAC 오디오, 스테레오 |
| 음량 | 최종 믹스 I ∈ [−17, −14] LUFS, 실제 피크 ≤ −1 dBTP |
| 해상도 | 참조 비디오의 방향을 따름. 참조 비디오가 없으면 1단계에서 질문, 답변이 없으면 1920×1080 사용 (제한 300초). 세로 = 1080×1920 (제한 60초) |
오디오가 길이를 결정합니다. 제한은 방향에 따라 달라집니다. 두 대상은 서로 다른 제품이기 때문입니다. 세로 Reels/TikTok 클립은 60초 숏폼이고, 가로 YouTube 설명 동영상은 5분을 수용할 수 있습니다. MAX_DUR는 사용자가 더 길게 요청하지 않는 한 고정됩니다. 음성이 해당 방향의 제한을 초과하면 중단하고 질문하세요. 절대 조용히 비디오 길이를 늘리지 마세요.
| 방향 | MAX_DUR | 이유 |
|---|---|---|
세로 1080×1920 | 60초 | Reels / TikTok / Shorts 최적 지점 |
가로 1920×1080 | 300초 (5분) | YouTube 설명 동영상 길이 |
방향이 행을 결정하며, 방향은 대본이 작성될 때(1단계) 결정되며 참조 비디오가 나타날 때(2단계)가 아닙니다. 제한이 대본 길이를 설정하기 때문입니다. 명시적인 사용자 대상이 해당 실행의 행 숫자를 대체하며, 사용자가 명명한 경우에만 300초보다 길어질 수 있습니다.
4단계에서 총 길이가 계산되면 그 숫자가 정확한 렌더링 대상이 됩니다. 파일은 정확히 그 길이여야 합니다. 음성과 비주얼은 이미 해당 타임라인에 동기화되어 있으므로 약간의 드리프트로 인해 끝 부분이 잘리거나 매달릴 수 있습니다.
규칙 대 취향
이 문서는 정확성을 관리하며 외관을 관리하지 않습니다. 정확성은 숫자로 증명할 수 있지만 취향은 그렇지 않습니다.
새로운 규칙은 다음 두 가지를 모두 충족할 경우에만 여기에 속합니다:
- 측정(숫자, 파일 메타데이터 또는 반복 가능한 검사)으로 증명될 수 있어야 하며,
- 창의적인 선택을 불가능하게 하지 않아야 합니다.
(1)은 통과하지만 (2)는 실패하는 규칙은 제한 사항이지 표준이 아닙니다. 거부된 예시: "오버슈트는 1.16이어야 함", "훅은 3초여야 함", "씬은 2~6초여야 함", "팔레트는 크림색이어야 함".
- 필수 (측정 가능): 텍스트 타이밍은 음성 단어를 따름; 도형 안의 텍스트는 글리프 상자에 의해 중앙 정렬; 텍스트 충돌 또는 안전 영역 이탈 없음; 글리프 높이 임계값 충족; 대비 임계값 충족; 음성 영역 내 데드 오디오 없음; 믹스 음량 명시된 대역 내; 프레임 수 정확.
- 자유 (당신의 결정): 팔레트, 씬 수, 전환 순서, 글꼴 선택 및 서체 패밀리, 분위기, 텍스트 배치, 컷 리듬, 애니메이션 길이, 오버슈트 양, 아이디어에 단어가 필요한지 여부.
이 문서에 남아 있는 모든 숫자는 무언가(가독성, 안전 영역, 대비, 인코더 동작)를 보호합니다. 취향을 지시하는 숫자를 발견하면 이 문서의 버그로 취급하세요: 건너뛰고 그렇게 말하세요.
references/의 어떤 것도 템플릿으로 취급하지 마세요. 전송되는 것은 측정 방법이지 측정 결과가 아닙니다. 글꼴 카탈로그는 시작점이지 메뉴가 아닙니다. 주제에 설치되지 않은 타이포그래피가 필요하면 다운로드하세요.
references/examples/ 아래에 예제 프로젝트가 추가된 적이 있다면: 반대 미적 쌍으로 제공되어야 하며(단일 예제는 항상 표준이 됨), 개정 내역(v1 → v2, 각 변경 이유와 함께)을 문서화하고, 복사 준비가 된 렌더링 코드를 절대 제공하지 않아야 합니다. 세 가지 모두 없으면 예제는 도움보다 해를 끼칩니다.
흔히 오해되는 한 가지 예외: 화면상의 텍스트는 음성에서 지지 단어가 필요하지 않습니다. 침묵의 강조는 합법적입니다. 타임라인에 이유를 기록하기만 하면 됩니다.
QC 게이트는 플래그를 지정할 뿐, 판단하지 않습니다. 검사에서 결과를 보고하면 결정하세요: 수정해야 할 결함인지, 문서화해야 할 의도적인 선택인지. 모든 게이트를 통과한다는 것은 "고장나지 않음"을 의미할 뿐, "좋음"을 의미하지 않습니다.
프로젝트 레이아웃
두 가지 명명 계층:
- 파일 및 디렉터리 이름은 영어입니다. 도구, 셸, 파일 시스템에서 공유하는 표준입니다.
- 파일 내용 및 사용자에게 보내는 모든 메시지는 인도네시아어입니다.
단일 예외: 프로젝트 폴더와 비디오는 주제 제목의 슬러그이므로 사용자의 단어를 유지합니다(tiga-mitos-otak). 해당 폴더는 사용자가 파일 관리자에서 여는 폴더입니다. 제목을 three-brain-myths로 번역하면 의미가 사라집니다.
주제 "Tiga Mitos Otak"에 대해 projects 폴더에서 실행하면 다음과 같이 생성됩니다:
projects/tiga-mitos-otak/
트리
tiga-mitos-otak/
├── script.txt 음성 대본, 깨끗한 텍스트, 레이블 없음
├── render.py 씬, 타이밍 테이블, render(t)
├── audio/
│ ├── voiceover.wav 타이밍 소스, 48kHz 모노
│ └── music.wav 선택 사항, 48kHz
├── assets/ 선택 사항, 사용자가 에셋을 제공할 때만 생성
│ ├── image-01.png 첫 번째 지원 이미지
│ ├── image-02.png 두 번째 지원 이미지
│ └── reference.mp4 스타일 참조 비디오
├── output/
│ ├── tiga-mitos-otak.mp4 최종 결과물, 이름은 폴더 이름과 동일
│ └── tiga-mitos-otak.srt 자막 트랙, 선택 사항
└── work/ 모든 중간 파일, 완전히 삭제해도 안전
├── frames/
├── check/
├── voiceover-16k.wav 16kHz 모노, 음성 인식용
├── voiceover-norm.wav 음량 정규화된 음성
├── words.json 단어 수준 타이밍, 이후 모든 단계에서 읽음
└── music-norm.wav 루프 및 덕킹 준비된 음악 (음악이 있는 경우)
render.py는 Python 파이프라인의 이름입니다. 빌드 스크립트는 항상 하나의 진입점, render.<ext>입니다. Remotion의 경우 render.mjs, Node/Playwright 프로젝트의 경우 render.ts. 절대 두 개가 아닙니다.
빈 디렉터리를 절대 만들지 마세요. 이미지가 없으면 assets/ 없음. 음악이 없으면 audio/music.wav 없음.
명명 규칙
| 계층 | 형식 | 예시 |
|---|---|---|
| 디렉터리 | 소문자 영어 단어 하나 | audio, assets, output, work, frames, check |
| 데이터 파일 | 영어 케밥 케이스 | script.txt, voiceover.wav, words.json, voiceover-norm.wav |
| 빌드 스크립트 | snake_case + 파이프라인 확장자 | render.py, render.mjs, make_music.py |
| 프로젝트 폴더 | 주제 슬러그, 케밥 케이스 | tiga-mitos-otak |
| 최종 결과물 | 주제 슬러그 | output/tiga-mitos-otak.mp4 |
| 파일 내용 | 인도네시아어 | 대본, 주석, 보고서 |
하나의 구분자만 사용: 하이픈. 공백은 셸 인용을 강제하고, 밑줄은 Python 모듈용으로 예약되어 있습니다.
- 버전 접미사 없음.
_final,_v2,_fix,_new, 날짜 없음. 다시 렌더링하면 동일한 이름을 덮어씁니다. - 사용자 대상 텍스트에서는 제목을 제목으로 작성하세요(
Tiga Mitos Otak), 슬러그로 절대 작성하지 마세요. 슬러그는 경로에만 사용됩니다. - 슬러그를 40자 내외로 유지하고, 단어 경계에서 자르세요. 더 길면 파일 관리자에서 불편합니다.
- 제목에서 다음 문자를 제거하세요:
? ! : ; / \ * " < > |및 후행 마침표, 공백은 하이픈으로 바뀝니다. - 폴더가 이미 존재하면 → 질문하세요. 절대 덮어쓰지 말고,
-2를 추가하지 마세요. 비디오는 여러 번 다시 렌더링되며, 쌓인 복사본은 사용자가 현재 버전을 알 수 없게 만듭니다.
들어오는 에셋
사용자가 제공하는 것을 정규화하세요. 원래 파일 이름을 그대로 두지 마세요:
| 도착하는 것 | 위치 |
|---|---|
| 음성 녹음, 모든 형식 | audio/voiceover.wav, 48kHz 모노로 정규화 |
| 배경 음악, 모든 형식 | audio/music.wav |
| 스타일 참조 비디오, 파일 또는 URL | assets/reference.mp4 |
| 지원 이미지, 제공된 순서대로 | assets/image-01.png, image-02.png, … |
들어오는 파일은 유형 및 내용으로 식별하고, 파일 이름으로 식별하지 마세요. recording-01.m4a라는 파일과 voice-final.mp3라는 파일은 동일합니다. ffprobe로 조사하고, 음성이 포함되어 있는지 확인한 후 역할에 따라 이름을 지정하세요.
두 개의 후보가 모두 음성일 수 있거나, 조사 후에도 파일의 역할이 불분명하면 한 번만 질문하세요. 추측하고 폐기하지 마세요. 원래 파일 이름을 기록하고 전달 메시지에서 언급하여 사용자가 어떤 파일이 사용되었는지 추적할 수 있도록 하세요.
이 워크플로우가 생성하지 않는 것
project.json, timing.json, scenes.py, manifest.json, style.json, review/ 또는 별도의 QC 보고서. 창의적인 결정(글꼴, 음성, 팔레트)은 사용자와 합의하고 render.<ext>에 저장됩니다. 검사 결과는 전달 메시지에 직접 보고됩니다. 보고서가 아닌 데이터이기 때문에 한 가지 예외가 있습니다: work/words.json(단어 타이밍) 및 선택적 output/<slug>.srt.
시작 동작
- 슬러그 이름의 하위 폴더에서 작업하고, 작업 디렉터리 자체에서는 작업하지 마세요. 모든 것이 그 안에 있으므로 두 주제가 충돌하지 않습니다.
- 1단계에서 대본과 함께 제목을 결정하고, 파일을 쓰기 전에 사용자에게 슬러그를 알리세요.
work/는 언제든지 생성될 수 있습니다. 사용자 입력은audio/및assets/에 남아 있으므로rm -rf work후 다시 렌더링하면 전체 비디오가 복원됩니다.
워크플로우
이 순서를 따르세요. 1~3단계가 완료되기 전에 렌더링으로 건너뛰지 마세요.
1단계 — 음성 대본 작성
사용자가 주제를 제공합니다. 첫 번째 작업은 내레이션 대본입니다. 단, 사용자가 자신의 대본이나 녹음을 가져오는 경우 해당 내용을 사용하고 2단계로 건너뜁니다.
대본 지침:
- 작성 전에 방향을 알아두세요. 제한이 방향을 따르며(세로 60초, 가로 300초), 제한이 대본 길이를 설정하므로 방향은 1단계에서 먼저 결정되며 2단계가 아닙니다. 사용자가 참조 비디오를 제공한 경우 해당 방향이 답이 됩니다. 그렇지 않으면 첫 번째 메시지에서 대본과 함께 질문하세요. 세로 Reels 클립에 740단어를 절대 작성하지 마세요.
- 길이는 주제를 따르며, 활성 제한에서 계산됩니다: 초당 약 2.5단어 (약 2.5초의 리드인 및 테일 포함). 세로 60초 → 약 140단어; 가로 300초 → 약 740단어. 이는 파생된 수치이지 규칙이 아니며 상한선입니다. 5분 대상에 90초에 해당하는 주제는 90초로 유지됩니다. 시간을 채우기 위해 문장을 절대 늘리지 마세요. 예상 음성 및 비디오 길이를 표시하세요.
- 구조: 가장 강하게 잡아끄는 것으로 시작하고(문장, 질문, 숫자), 2~3개의 핵심 요점, 그리고 마무리 문장. 훅은 효과에 관한 것이지 초에 관한 것이 아닙니다. 처음 3초는 대략적인 가이드이지 요구 사항이 아닙니다. 문장을 짧게 유지하여 화면 텍스트로 깔끔하게 분할되고 TTS를 통해 잘 읽히도록 하세요.
- 5분 가로 대상의 경우 2~3개의 핵심 요점으로는 시간이 충분하지 않습니다. 각 핵심 요점에 고유한 비트를 부여하고 씬당 하나의 아이디어를 유지하세요. 60초 세로 대상의 경우 가장 날카로운 한 가지 요점으로 줄이고 숨 쉴 공간을 주세요.
- 명확하고 자연스러운 구어체. TTS가 잘못 발음할 수 없도록 숫자, 약어, 외국어 용어를 철자하세요.
- 사실을 지어내지 마세요. 주제에 데이터가 필요한 경우 가능할 때 웹을 검색하고, 그렇지 않으면 안전한 일반적인 주장을 사용하세요.
- 길이는 여기서 결정됩니다. 4단계에서 음성을 자르거나 속도를 높일 수 없으므로 지금 오버런을 수정하세요.
표시 형식:
## Naskah Voiceover — [주제]
Format: [tegak, maksimal 60 detik / mendatar, maksimal 5 menit]
Perkiraan: ± [N] kata ≈ [N] detik suara ≈ [N] detik video
Batas: [60 / 300 / angka yang Anda setujui] detik
**[Hook]** ...
**[Inti 1]** ...
**[Inti 2]** ...
**[Penutup]** ...
대본 앞의 레이블 줄은 선택 사항이 아닙니다. 작업을 시작하기 전에 대본이 어떤 제한에 대해 작성되고 있는지 사용자에게 알려줍니다. 대본이 준비되었을 때 방향을 아직 알 수 없으면 해당 줄에 그렇게 명시하세요(Format: belum ditentukan — saya pakai mendatar (maksimal 5 menit)). 그리고 사용자가 수정하도록 하세요.
[Hook] / [Inti N] / [Penutup] 레이블은 표시 및 씬 타이밍 맵을 위해서만 존재합니다. TTS를 생성할 때(직접 또는 대본을 사용자에게 전달하여) 레이블 없이 텍스트를 보내세요. 레이블은 소리 내어 읽힙니다. references/RENDER.md §3을 참조하세요.
2단계 — 에셋 제안 및 수집
대본과 동일한 메시지(또는 승인 후)에서 미디어 목록을 표시하고 사용자가 제공하려는 항목을 물어보세요. 한 번만, 자세히 물어보고 절대 반복하지 마세요.
사용자는 파일 이름을 지정하지 않습니다. 도착 시 모든 이름을 정규화합니다.
사용자에게 인도네시아어로 이것을 출력하세요:
Untuk membuat videonya, saya bisa memakai bahan dari Anda. Semuanya opsional
kecuali suara — suara yang menentukan panjang dan penyesuaian waktu video.
1. Rekaman suara (paling saya sarankan)
Format apa pun: mp3, wav, m4a. Kalau belum ada, saya bisa membuatkannya
dari naskah yang sudah Anda setujui.
2. Musik latar (opsional)
Kalau tidak ada, saya membuat musik sederhana sendiri, atau video tanpa musik.
3. Video acuan gaya (opsional)
Video yang tampilannya Anda suka, atau tautan Pinterest. Kalau tidak ada,
saya carikan sendiri yang paling sesuai dengan topik. Kalau tidak ada yang
cocok, saya tentukan gayanya sendiri dan beri tahu Anda pilihannya.
4. Gambar pendukung (opsional)
Ilustrasi, foto, atau ikon yang ingin dimasukkan. Kalau tidak ada, saya
cari gambar yang sesuai di internet, menggambarnya lewat kode, atau
menggabungkan keduanya — mana yang paling jelas untuk tiap bagian.
5. Orientasi layar (menentukan panjang maksimal)
Tegak (1080×1920, untuk Reels/TikTok/Shorts, maksimal 60 detik)
atau mendatar (1920×1080, untuk YouTube, maksimal 5 menit)?
Kalau tidak disebut, saya pakai mendatar.
6. Caption dan subtitle (opsional)
Caption di dalam video, berkas .srt untuk diunggah ke platform,
atau keduanya. Tanpa diminta, saya tidak membakarnya ke v…
[truncated for translation]