코드 애니메이션 과학 영상
모든 화면은 Remotion으로 순수 코드로 그리고, 음향은 Python으로 합성합니다. 먼저 세 가지 시안과 미리보기를 제공하고, 사용자가 선택하면 brief.md를 작성한 후 장면별로 제작합니다.
필수 규칙
- 이 스킬의 절차만 사용합니다. 다른 워크플로나 프로젝트의 방식을 이 절차에 대체하지 마세요.
- 자료는 반드시 실제여야 하며 링크가 있어야 합니다. 각 자료를 직접 열거나 다운로드하여 확인하세요. 확인할 수 없는 항목은 '미확인'으로 표시하고, 2차 해석은 누가 해석했는지 명시하세요. 숫자를 지어내지 말고, 출처를 찾을 수 없는 내용은 쓰지 마세요.
- 각 단계마다 사용자 확인을 받고 진행합니다: 자료 목록 → 세 가지 시안과 미리보기 → 사운드 → 썸네일.
brief.md작성 후에는 파일 위치를 사용자에게 알려주세요. - 내레이터는 넣지 않습니다 (사용자가 요청한 경우 제외). 정보는 모두 화면 텍스트로 전달합니다. 배경 음악은 사용자가 제공한 것을 사용합니다(사용자가 사용 권한을 보유해야 함). 동작 효과음은 직접 합성하고 박자에 맞춥니다. 저장소에 음악 파일을 포함하지 않습니다.
- 텍스트: 겹치지 않게, 잘 보이게, 충분히 오래 머물게, 긴 문단을 쌓지 않게. 화면은 풍부하게, 주인공(사람, 동물, 사물)은 세밀하고 생동감 있게 그립니다.
- 기본 사양: 가로 1920×1080, 30fps; 사용자가 세로/틱톡/숏폼을 요청하면 1080×1920으로 설정합니다(
scenes.json의style을"vflash"로 설정). 길이는 배경 음악 길이와 같습니다(음악이 없으면 길이와 BPM을 지정할 수 있음).
작업 디렉토리
<주제>/ 예: ~/videos/<주제>
demo.mp3 / demo.mp4 사용자가 제공한 배경 음악, 참고 동영상(선택)
source/ sources.md(자료 목록), ref-notes.md(참고 동영상 분석), 원자료
previews/ plan-a.png, plan-b.mp4, plan-c.png(세 시안의 미리보기)
brief.md 확정된 전체 시안, 재사용 가능한 프롬프트
video/ Remotion 프로젝트 (new_project.py 또는 new_project.ps1로 생성)
qa/ 장면별 정지 프레임, 전체 영상 추출 프레임, review_log.md
<영상명>.mp4 최종 영상
썸네일/ 썸네일_3대4_세로.jpg, 썸네일_4대3_가로.jpg
0단계: 프로젝트 생성
python <skill>/scripts/new_project.py --project "<주제 디렉토리>"
# 배경 음악이 없을 때: ... --no-music --duration 60 --bpm 120
Windows에서는 scripts/new_project.ps1도 사용 가능합니다. 이 스크립트는 다음 작업을 순서대로 수행합니다:
- 환경을 확인합니다(
scripts/check_env.py). 부족한 사항이 있으면 출력합니다; 설치 전에 사용자 동의를 받습니다. - 작업 디렉토리를 생성합니다.
- 템플릿을 복사합니다.
- 글꼴을 복사합니다.
- npm install을 실행합니다.
- 박자를 측정하여
src/grid.json에 씁니다. - 첫 번째 버전의 믹스를 만듭니다.
전체 과정은 1–3분 정도 소요됩니다. 긴 명령을 백그라운드로 실행해야 하는 환경에서는 백그라운드로 시작한 후 출력을 폴링합니다(references/pitfalls.md 참조).
템플릿에는 약 12초 분량의 범용 플레이스홀더 예제가 포함되어 있어 프로젝트가 렌더링 가능한지 확인합니다. 주제를 변경한 후에는 장면, 자막, 효과음을 다시 작성해야 합니다. 전체 멀티 장면 예제는 examples/bait-color/에 있습니다(선택 사항이며 기본 콘텐츠는 아님).
1단계: 무엇을 만들지 명확히 묻기
사용자는 다음 원자료를 혼합하여 제공할 수 있습니다:
- 아이디어: 한 문장 주제도 가능.
- 원본 콘텐츠: 기사, 대본, 제품 URL, 코드 저장소, 데이터 테이블.
- 참고 동영상, 배경 음악.
최대 3개의 추가 질문만 하며, 시안에 영향을 주는 사항만 묻습니다: 길이, 화면 비율, 내레이터 여부, 지정 브랜드 색상 또는 글꼴. 사용자가 말하지 않은 것은 기본값을 사용하고 시안에 명시하여 사용자가 변경할 수 있게 합니다.
원자료 처리:
- 과학, 사실 기반 주제:
references/research.md에 따라 자료를 조사하고 확인하여source/sources.md에 작성하고 사용자에게 확인합니다. - 기사, 대본: 핵심 정보, 대상 독자, 반드시 포함되어야 할 사실을 추출합니다. 사실은 원자료에서만 가져오며, 확실하지 않은 것은 쓰지 않습니다.
- 제품 URL: 페이지를 읽고 제품명, 기능, 슬로건, 브랜드 색상을 기록합니다. 스크린샷이 필요하면 먼저 동의를 받습니다.
- 코드 저장소: README와 주요 파일을 읽고 기능 포인트를 추출합니다. 기능을 지어내지 않습니다.
- 참고 동영상:
- 링크 다운로드는 먼저 동의를 받습니다.
ffprobe로 사양을 측정합니다.ffmpeg -vf "select='gt(scene,0.3)',showinfo"로 장면 전환 지점을 찾습니다.- 초당 1프레임씩 추출하여 연락처 시트를 만듭니다.
- 장면 구조, 리듬, 색상 구성, 글꼴, 기법을
source/ref-notes.md에 기록합니다. - 구조와 기법만 참고하고, 소재나 대사는 가져오지 않습니다.
- 배경 음악: 프로젝트 생성 스크립트가 이미 박자를 측정하여 BPM, 섹션 경계, 드리프트를 출력합니다. 시안과 스토리보드는 이에 맞춰 구성합니다.
2단계: 세 가지 시안 제공
references/plans.md에 따라 작성합니다. 세 시안의 역할은 고정되어 있습니다:
| 시안 | 스타일 | 기술 | 전달 방식 |
|---|---|---|---|
| A | FLASH 애니메이션 스타일 (평면 일러스트) | Remotion + SVG 평면 일러스트 컴포넌트 | 안정적: 질문 → 실험/데이터 → 결론 → 세 가지 기억할 점 |
| B | 픽셀 카세트 스타일 (레트로 게임기 + CRT TV) | Canvas 2D 픽셀 캔버스 → WebGL CRT 셰이더 | 게임화: 카세트 선택 = 레벨 선택, HUD가 데이터 표시, 대화상자가 결론 제공, 결과 화면이 결과 제시 |
| C | 주제에 맞춰 제안: plans.md의 후보 목록에서 가장 적합한 것을 선택하거나, Remotion으로 구현 가능한 새로운 스타일 제안 | A, B와 모두 다름 | 다른 전달 방식: 원샷, 영화 전체를 관통하는 주인공, 역순, 하나의 비유로 설명 |
각 시안은 다음을 명확히 작성해야 합니다: 이름, 한 문장 요약, 스타일 (색상 값과 글꼴), 사양, 기술 조합, 장면별 화면 개요 (시간 구간 포함), 사운드, 예상 렌더링 시간, 난이도 및 위험, 그리고 이 원자료에 적합한 이유.
세 시안은 스타일, 기술, 전달 방식에서 명확히 달라야 하며, 단순히 색상만 바꾸면 안 됩니다.
3단계: 각 시안 미리보기 생성
video/src/preview/PlanA.tsx,PlanB.tsx,PlanC.tsx에 각각 시안을 가장 잘 대표하는 장면 하나를 구성합니다. 시간은 0부터 시작하며 길이는 2–4초입니다. 템플릿의 이 세 파일은 범용 플레이스홀더 예제이므로 다음과 같이 수정합니다:- A는
src/art/,src/ui/의 SVG 컴포넌트를 사용합니다. - B는
src/pixel/엔진을 사용하여PixelStage에 그립니다. - C는 새로 작성하며,
PlanC.tsx의 작성 방식을 따릅니다: 화면은 t에 의해서만 결정되며, 하나의 장면으로 구성합니다.
- A는
- 실행:
node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9- 기본적으로 각 시안에 대해 하나의 키프레임을 생성하며, 콜론 뒤는 프레임을 추출할 초입니다.
- 움직임 자체가 장점인 시안은
B:clip으로 작성하여 3초 클립을 생성합니다. - 스크립트는 프레임당 소요 시간과 전체 렌더링 시간 추정치를 출력하며, 이 값을 시안에 기입합니다.
- 미리보기 이미지를 먼저 직접 확인합니다: 텍스트가 넘치지 않는지, 요소가 겹치지 않는지, 화면이 너무 비어 있지 않은지, 세 스타일이 실제로 차이가 나는지 확인합니다. 수정한 후 사용자에게 전달합니다.
- 세 시안의 텍스트와 미리보기 이미지를 함께 사용자에게 전달합니다 (미리보기 이미지를 응답에 포함시킵니다; 각 도우미의 방식이 다를 수 있음). 사용자는 하나를 선택하거나 혼합 또는 수정을 요청할 수 있습니다; 변경 사항이 있으면 2단계 또는 3단계로 돌아가 사용자가 확인할 때까지 반복합니다.
4단계: brief.md 작성
사용자가 확인하면 references/brief-template.md에 따라 <주제>/brief.md를 작성합니다. 이 파일은 7개 섹션으로 구성됩니다: <role> <inputs> <direction> <structure> <build> <gotchas> <start>. 확인된 내용은 모두 실제로 작성하고, 기본값을 사용한 부분은 기본값임을 명시합니다. 작성 후 파일 위치를 사용자에게 알려줍니다.
이후 제작은 brief에 따라 엄격히 진행됩니다. 도중에 변경할 사항이 있으면 먼저 brief를 수정한 후 코드를 수정합니다. 사용자가 나중에 주제를 변경하거나 다른 도구에서 실행할 때도 이 brief를 그대로 사용할 수 있습니다.
5단계: 장면별 제작
-
먼저
src/scenes.json을 작성합니다:style은"flash"또는"pixel"로 작성하며, Root가 이에 따라 화면 세트를 선택합니다.- 장면 테이블은 박자로 작성하고, 장면 전환은 섹션 경계에 맞춥니다.
-
각 장면은 다음을 작성합니다:
- FLASH 스타일:
src/scenes/*.tsx에 컴포넌트를 작성하고,src/scenes/index.ts에 등록합니다. - 픽셀 스타일:
src/pixel/scenes.ts의PIXEL_SCENES에 그리기 함수(c, f) => void를 작성합니다. - C 스타일: 3단계의 미리보기 코드를 확장하여
Film.tsx에 연결하거나,PixelFilm.tsx를 참고하여 별도의 전체 영상 컴포넌트를 작성합니다. - 모든 텍스트는
src/captions.json에, 모든 효과음은src/sfx.json에 작성하며, 모두 동일한 박자 시스템을 사용합니다.
- FLASH 스타일:
-
각 장면을 완료할 때마다 순서대로 실행:
npm run typechecknpm run check(자막 검사, 문제 0개여야 함)node tools/stills.mjs --out ../qa <진입 초> <주요 동작 초> <퇴장 초>
그런 다음 각 이미지를 하나씩 확인하여 가림, 화면 밖으로 나감, 텍스트가 얼굴을 가림, 텍스트 겹침을 확인합니다. 수정 후 다음 장면으로 넘어갑니다.
-
영상 길이가 30초 이상인 경우, 모든 장면을 완료한 후 저해상도 초안을 먼저 렌더링합니다:
node tools/render.mjs --scale 0.5 --out out/draft.mp4. 리듬과 전환이 문제없는지 확인한 후 세부 사항을 정교하게 다듬습니다. -
스타일 규칙은
references/style-flash.md와references/style-pixel.md를 참조하고, 일반 규칙은references/craft.md를 참조합니다.
6단계: 사운드
규칙은 references/audio.md를 참조합니다:
- 효과음과 화면 동작은 동일한 박자에 작성합니다.
- 픽셀 스타일은
chip_*칩 음색을 사용합니다. - 타자기 효과는
rep필드를 사용하여 효과음을 반복합니다. - 기본 레벨이 최종 확정값입니다.
- 사용자가 너무 크거나 작거나 날카롭다고 하면,
--music-db와--sfx-db를 사용하여 여러 단계의 비교 파일을 생성하여 사용자에게 선택하도록 합니다. 오디오 트랙만 변경하고 화면은 다시 렌더링하지 않습니다.
7단계: 렌더링 및 검수
- 렌더링:
npm run sfx실행 후npm run render실행. 소요 시간은 3단계의 추정치를 참조합니다; 3200프레임 영상의 경우 FLASH 스타일은 약 1.8분, 픽셀 스타일은 약 6분 소요됩니다. ffprobe로 해상도, 프레임 레이트, 프레임 수, 길이를 확인하고,ebur128로 음량을 측정합니다.- 프레임 추출 이미지 생성:
python tools/qa_sheet.py out/film.mp4 ../qa/final(Windows에서는tools/qa_sheet.ps1도 사용 가능). 두 개의 이미지가 생성됩니다: 전체 연락처 시트와 각 셀 너비 360px의 모바일 버전. references/craft.md의 자가 점검표로 평가합니다. 7개 항목 각각 8점 이상이어야 합니다:- 가장 심각한 3개 문제와 그 시간 지점을 나열합니다.
- 문제가 있는 구간만 다시 렌더링(
node tools/render.mjs --frames 시작-끝)하고 전체 영상을 합성합니다. - 각 라운드의 점수와 문제는
qa/review_log.md에 기록합니다.
- 최종 영상을
<주제>/<영상명>.mp4에 복사합니다.
세로형 숏폼 영상 핵심 사항 (style = vflash)
- 전체 영상 컴포넌트는
src/vfilm/에 있습니다: VFilm, VOverlay, 범용 카드 및 태그, 미니멀 썸네일. 장면은vfilm/scenes.tsx의VSCENE_MAP에 등록합니다. - 자막 안전 영역: x 40–1040, y 240–1640; 텍스트 기본 표시 시간 ≥ 3.5초, 짧은 카드 ≥ 3초.
- 출처를 화면에 겹쳐 표시하지 마세요. 출처는
source/sources.md에만 기록합니다. 화면에는 최대 '예시'라고만 표시합니다. - 종료 제안: 번호가 매겨진 복습/투표 + 팔로우 유도. 카피 규칙은
references/publish-copy.md를 참조합니다(제목 ≤ 30자, 설명 ≤ 100자, 해시태그 포함). - 최종 영상 음량 -16 LUFS, 실제 피크 ≤ -2 dBTP:
python tools/loudnorm.py out/film.mp4. 배경 음악이 명확하게 들려야 합니다. - 전환점은 소절의 첫 번째 비트에 맞춥니다:
python tools/sync_check.py. 변속 곡선은beat_grid.py가grid.json의segments에 기록합니다. - 세로형 썸네일:
npm run vcover34/vcover43.
8단계: 썸네일
두 스타일 모두 3:4와 4:3 두 가지 버전이 있습니다; 세로형에는 미니멀 썸네일 세트도 있습니다:
- FLASH 스타일 (가로 구성):
npm run cover34,npm run cover43 - 픽셀 스타일:
npm run pixelcover34,npm run pixelcover43 - 세로형 미니멀:
npm run vcover34,npm run vcover43
모두 2배 해상도로 내보냅니다. 레이아웃 규칙은 해당 스타일의 문서와 references/publish-copy.md를 참조합니다. 숏폼 썸네일은 왼쪽 아래(재생 수 영역)를 피하고, 하단에 목록을 쌓지 마세요.
전달
사용자에게 알려줍니다:
- 최종 영상 경로,
brief.md경로, 프로젝트 디렉토리. - 이번 제작의 주요 창작 결정.
- 알려진 단점.
- 렌더링 소요 시간.
- 불확실하거나 사용자가 확인해야 하는 사실을 별도로 나열합니다.
스타일 변경, 새 스타일 추가
- 이 영상만 변경: 이 영상의
video/폴더 내 파일만 수정하고, Skill 템플릿은 건드리지 않습니다. 각 부분이 어떤 파일에 있는지는references/craft.md의 '스타일 분포 파일'을 참조합니다. 먼저 4–6장의 대표 정지 프레임을 생성하여 사용자에게 스타일을 확인받은 후 전체 영상을 제작합니다. - 앞으로 C 스타일 사용:
- 코드를
assets/template/src/<스타일명>/에 정리합니다. references/style-<스타일명>.md를 작성합니다.plans.md의 후보 목록에 '등록됨'으로 표시합니다.- 이 파일의 시안 테이블에 행을 추가합니다.
- 코드를
- 구현 불가능한 스타일: 이 워크플로는 코드로 벡터와 픽셀 이미지만 그립니다. 실사, 사실적인 3D, 사실적인 인물은 구현할 수 없으므로 사전에 사용자에게 알려야 합니다. 사실적인 인물이 필요한 경우, 사용자가 먼저 비디오 모델로 그린 스크린의 인물 클립을 생성하고, 코드는 배경과 텍스트만 담당하도록 할 수 있습니다.
참고 파일 (필요할 때만 읽기)
| 파일 | 내용 |
|---|---|
references/plans.md | 세 시안의 형식, C 시안 후보 목록, 미리보기 규칙, 사용자에게 전달할 때의 작성법 |
references/brief-template.md | brief.md 7개 섹션 템플릿 |
references/style-flash.md | FLASH 애니메이션 스타일: 스타일 규칙, 컴포넌트, 썸네일 |
references/style-pixel.md | 픽셀 카세트 스타일: 화면 핵심 포인트, 팔레트, 이중 해상도, 도트 폰트, 스프라이트, CRT, 썸네일 |
references/craft.md | 스토리보드 규칙, 자막 규칙, 장면별 자가 점검, 전체 영상 자가 점검 점수, 검수 목록, 스타일 분포 파일 |
references/remotion-kit.md | 템플릿 구조, 박자 시스템, 각 컴포넌트 API,常用 명령어 |
references/audio.md | 박자, 음색 테이블 (칩 음색 포함), 믹스 레벨 최종값, 튜닝 프로세스 |
references/research.md | 자료 조사 및 확인 방법 |
references/pitfalls.md | 경험한 함정 (작업 시작 전 반드시 읽을 것) |
references/credits.md | 참고 출처 및 글꼴 라이선스 |
references/publish-copy.md | 세로형 게시 카피, 투표 종료, 안전 영역, 음량 |
scripts/new_project.py, new_project.ps1, check_env.py, beat_grid.py, music_rms.py, qa_sheet.py | 프로젝트 생성, 환경 확인, 박자 측정, 레벨 측정, 프레임 추출 |
assets/template/ | Remotion 프로젝트 템플릿 (두 스타일의 모든 범용 컴포넌트와 플레이스홀더 예제 포함) |
assets/fonts/ | Fusion Pixel 12px 도트 폰트 (OFL) |
examples/bait-color/ | 전체 멀티 장면 예제 (선택 사항 참고, 기본 템플릿 아님) |