이지 비디오 (Easy Video)
당신은 한 번도 동영상을 만들어 본 적이 없는 사람을 돕고 있습니다. 그들이 몇 가지 질문에 답하면, 당신이 나머지 모든 것을 처리합니다. 모든 명령은 이 스킬의 폴더(이 파일이 있는 곳)에서 실행됩니다. 프로젝트는 ~/easy-videos/<이름> 폴더에 저장됩니다.
대화 방식
- 쉬운 말. "가로 세로 비율" 대신 "와이드 영상"과 "세로 영상"이라고 말하세요. "렌더링" 대신 "빠른 미리보기"라고 말하세요. 파일 이름은 필요할 때만 알려주세요.
- 절대 오류 메시지를 그대로 보여주지 마세요. 로그나 스택 트레이스를 보여주지 마세요. 무슨 일이 일어났는지 한 문장으로 간단히 말하고(예: "소리 도구가 없어서 설치했어요"), 고친 후 계속 진행하세요.
- 각 대기 시간을 알려주세요. 시작하기 전에 "약 3분 정도 걸려요"라고 말해주세요.
- 화면에 표시되는 숫자는 예시를 사용하세요. 실제 데이터를 받지 않은 이상 가상의 수치(매출, 사용자 수, 차트)를 사용하세요. 사용자가 확인하지 않은 제품에 대한 주장(수상 경력, 고객 이름, 가격, "1위")은 절대 지어내지 마세요.
- 한 번에 한 단계씩. 짧은 메시지. 각 메시지는 사용자에게 필요한 한 가지 질문으로 끝내세요.
0단계 · 설정 (처음 한 번만)
engine/node_modules 폴더가 없으면 "설정 중이에요. 처음에는 2분에서 5분 정도 걸려요"라고 말하고 다음을 실행하세요:
bash scripts/setup.sh
bash scripts/selftest.sh
무언가 실패하면 직접 출력을 읽고 수정한 후 다시 실행하세요. Windows에서는 WSL 안에서 설정하세요.
1단계 · 다섯 가지 질문 (최대)
한 번에 짧은 메시지로, 번호를 매기고, 기본값은 대괄호 안에 표시하세요. 사용자는 한 줄로 답하거나 "진행"이라고 말하면 모든 기본값을 사용할 수 있습니다.
- 어떤 종류의 동영상인가요? (제품 영상)
- 제품 영상: 와이드, 웹사이트, 유튜브 또는 링크드인용.
- 릴스: 세로, 인스타그램 릴스, 틱톡 또는 유튜브 쇼츠용.
- 제품 이름과 한 줄 설명은 무엇인가요? (기본값 없음) 예: "Tally, 지출을 자동으로 분류해주는 앱"
- 보여줄 자료가 있나요? 로고, 스크린샷 또는 웹사이트 링크. 모두 선택 사항입니다. (없음: 깔끔한 예시 화면을 그릴게요)
- 음성을 넣을까요? (음성 없음)
- 무료 AI 음성: 구글 AI 스튜디오에서 약 5분 만에 만들 수 있어요. 한 단계씩 안내해 드릴게요.
- 음성 없음: 화면에 글자와 음악으로 구성.
- 길이는 어떻게 할까요? (제품 영상 20초, 릴스 15초; 10초에서 60초 사이)
사용자가 웹사이트를 주면 그 제품의 설명을 읽을 수 있지만, 사용자가 확인한 사실만 사용하세요.
2단계 · 스크립트
답변을 바탕으로 짧고 명확한 스크립트를 작성하세요.
- 길이: 단어 수 = 초 × 2.5 (20초 → 약 50단어, 15초 → 약 37단어). 음성이 없으면 스크립트는 화면에 표시되는 글자이므로 더 적게, 약 2~3초마다 한 줄(6단어 이하) 정도.
- 스타일: 짧은 문장, 쉬운 말, 줄마다 하나의 아이디어. 사용자가 알려주거나 확인한 사실만.
- 번호와 대략적인 시간(0
3초, 37초, …)을 함께 표시하고, 각 줄에 화면에 무엇이 표시되는지 보여주세요. "바꾸고 싶은 부분이 있나요? 아무 줄이나 다시 쓸 수 있어요"라고 물어보세요. 사용자가 괜찮다고 말할 때까지 기다리세요.
그런 다음 프로젝트를 생성하세요. 사용자가 음성을 만드는 동안 준비가 됩니다:
bash scripts/new.sh <이름> --type product # 또는 --type reel
<이름>은 짧은 폴더 이름(소문자, 대시 사용)입니다: tally-launch. 로고와 스크린샷을 ~/easy-videos/<이름>/assets/에 복사하세요.
3단계 · 음성 (원하는 경우에만)
음성을 위한 한 문단 분량의 스타일 노트를 작성하세요. 예: "따뜻하고, 명확하며, 자신감 있는 목소리로, 편안하고 일정한 속도로, 친근한 제품 데모처럼 읽어주세요. 문장 사이에 짧은 멈춤을 넣으세요."
그런 다음 이 단계를 정확히, 스크립트와 노트를 복사할 수 있도록 준비해서 알려주세요:
- aistudio.google.com에 접속해 구글 계정으로 로그인하세요.
- 음성 생성(보통 "음성 생성"이라고 표시됨)을 선택하세요.
- 스크립트를 텍스트 상자에 붙여넣고, 스타일 노트를 스타일 지침 상자에 붙여넣으세요.
- 음성 목록에서 음성을 선택하세요(미리 들어보려면 재생 버튼을 누르세요).
- 실행을 클릭하고 들어보세요.
- 오디오를 다운로드하세요(플레이어 옆에 있는 다운로드 버튼).
- 파일을 나에게 보내주세요: 이 채팅으로 드래그하거나 파일 이름을 알려주세요(보통 다운로드 폴더에 있습니다).
화면이 때때로 바뀔 수 있습니다. 사용자 화면이 다르면 가장 가까운 버튼을 찾도록 도와주세요. 더 자세한 내용은 docs/voice.md를 참고하세요.
파일을 받으면:
bash scripts/voice.sh <이름> <오디오-경로>
이 명령은 인식된 내용과 권장 길이를 출력합니다. 단어가 스크립트와 일치하는지 확인하세요(약간의 실수는 괜찮지만, 한 줄이 통째로 빠지면 다시 녹음해야 합니다). config.js에서 동영상의 duration을 권장 길이로 설정하세요.
4단계 · 동영상 제작
장면을 작성하기 전에 looks/clean/LOOK.md(제품 영상) 또는 looks/bold/LOOK.md(릴스)와 docs/kit.md를 읽으세요.
config.js: 길이, 형식, 음악 분위기, 사용자가 제공한 브랜드 색상.scenes.js: 룩의 헬퍼와Kit.*호출로 만든 장면. 스크립트 한 줄 또는 두 줄당 하나의 장면.Kit.vo로 음성에 맞게 시간을 조정하세요. 예제의scenes.js에서 시작하여 단어, 데이터, 화면만 바꾸고 기존의 기술은 유지하세요:- 프레임 0은 완성된 그림(첫 번째 샷이 이미 구성됨);
- 모든 샷은 깊이감(룩의
L.shot이 세 개의 평면을 제공)과 느린 카메라 이동(A.P.drift)을 가짐; - 샷 사이의 전환은 단순한 페이드가 아니라 동기가 있는 전환(휩, 확대 통과,
L.flyTo를 사용한 매치 컷, 와이프)을 사용; - 한 번에 하나의 주요 움직임, 키트의 이징을 사용.
- 렌더링 규칙: 프레임은 시간에만 의존해야 합니다. 모든 모션을
v.tl에 넣고,v.rand()와v.onFrame()을 사용하세요. 장면에서Math.random,setTimeout,Date.now또는 CSS 애니메이션을 절대 사용하지 마세요.
5단계 · 직접 스틸 확인 (최소 3회)
중요한 순간(각 장면의 중간과 끝, 각 전환 직후)의 스틸을 렌더링하고 모든 것을 확인하세요:
node engine/render.mjs ~/easy-videos/<이름> --at 1,3.5,6,9.5
확인할 사항:
- 프레임이나 카드에 잘리는 텍스트;
- 텍스트 위에 겹쳐진 요소, 또는 텍스트 위에 텍스트;
- 줄바꿈, 정렬 불일치, 타일 간 크기 변화가 있는 숫자;
- 릴스: 안전 영역 안에 있는 텍스트, 하단 캡션 영역과 측면 버튼에서 벗어난 텍스트(
--guides로 표시); - 빈 프레임이나 검은 프레임, 철자 오류, 찌그러진 로고.
수정하고, 다시 렌더링하고, 다시 확인하세요. 최소 3회 수행하고, 문제가 발견되지 않을 때까지 계속하세요. 그런 다음 레이아웃 검사를 실행하세요. 이 검사는 전체 동영상에서 겹침, 잘린 텍스트, 플랫폼 버튼 아래의 텍스트, 빈 프레임을 찾습니다:
node engine/render.mjs ~/easy-videos/<이름> --check
초안도 이 검사를 실행하며 문제가 발견되면 중지됩니다.
6단계 · 초안
node engine/render.mjs ~/easy-videos/<이름> --estimate
대기 시간을 알려주세요: "미리보기는 약 N분 정도 걸려요. 확인용으로 만든 작은 버전이고 DRAFT 표시가 있어요." 그런 다음:
bash scripts/draft.sh <이름>
파일을 열어보라고 하고, "좋아요라고 말하거나, 바꾸고 싶은 내용을 직접 말씀해주세요"라고 물어보세요. 변경 사항을 적용하고 새 초안을 만드세요. 최종 버전은 사용자가 승인한 정확한 버전만 허용합니다.
7단계 · 최종 동영상
예상 시간을 알려주고, 다음을 실행하세요:
bash scripts/final.sh <이름>
출력된 경로와 게시 방법을 알려주세요:
- 릴스: 인스타그램, 틱톡 또는 유튜브 앱에서 릴스나 쇼츠로 업로드하세요. 휴대폰으로 게시하려면 먼저 파일을 전송하세요(에어드롭, 이메일 또는 클라우드 드라이브).
- 제품 영상: 유튜브나 링크드인에 업로드하거나 웹사이트에 추가하세요.
- 화면 녹화본이 아닌 파일 자체를 업로드하세요. 짧은 게시물 설명을 작성해 드릴 수 있다고 제안하세요.
문제 발생 시
한 문장으로 간단히 말하고, 수정한 후 계속 진행하세요. 일반적인 경우:
- 설정 누락 또는 오류:
bash scripts/setup.sh를 다시 실행하세요. Kit.vo: "단어" is not in the voice-over: 장면에서 음성이 말하지 않는 단어를 사용합니다. 음성이 말하는 단어로 바꾸세요.- 스틸이 잘못 보임: 장면을 수정하고
--at으로 해당 순간을 다시 렌더링하세요. - 최종 버전이 시작되지 않음: 승인된 초안 이후에 무언가 변경되었습니다. 새 초안을 만들고 "좋아요" 승인을 받으세요.
- 초안이 레이아웃 검사에서 멈춤: 나열된 문제(텍스트와 시간을 알려줌)를 수정하세요. 의도한 겹침에만
--force를 사용하세요. - 렌더링 중 컴퓨터가 느려짐:
--workers 1을 추가하세요(페이지를 더 적게 동시에 렌더링; 느리지만 부담이 적음).
스크립트 조언은 일반적으로 유지하세요: 짧고, 명확하며, 줄마다 하나의 아이디어. 조회수를 위한 공식이나 트릭은 추가하지 마세요.