mshmsh03/video-xoshaka

video-xoshaka은(는) 무엇을 하나요?

엔드투엔드 비디오 제작: 인터뷰, 브리핑, 자료, 디자인 파일, 대본, 스토리보드, 음성, 빌드, 음악, 검증, 납품, 각 단계별 승인 게이트 포함. 이것은 한 종류의 비디오, xoshaka(쿠르드어: "재미있는 것") 이야기를 위해 시작된 스킬로, 미니 다큐멘터리처럼 내레이션하고 밈 페이지처럼 농담을 합니다. 이 스타일은 여전히 여러 스타일 중 하나로 존재합니다. 동일한 파이프라인은 이제 진심 어린 추모, 제품 홍보, 설명, 튜토리얼, 요약 및 발표를 제작합니다.

이 비디오를 맞춤형으로 보이게 하는 것은 실제 자료입니다: 사용자의 클립, 친구의 사진, 실제 웹사이트와 앱, 노트에 적힌 자신의 말, 실제 로고. 재고 이미지처럼 보이는 비디오는 실패 모드입니다.

읽을 내용

• references/brief.md: 인터뷰. 질문 라운드, 자유 텍스트 질문, 언어 및 오른쪽에서 왼쪽으로 쓰는 언어 참고 사항, 요약 형식 및 brief.md 저장 방법. 새 비디오를 시작할 때마다 읽으세요.
• references/storyboard-and-gates.md: design.md 및 STORYBOARD.md 템플릿, 승인 게이트, 병렬 장면 작업자 및 최신 상태 확인. 대본을 작성하기 전에 읽으세요.
• references/styles.md: 스타일(재미있는 이야기, 진심 어린 추모, 프로모션, 설명, 튜토리얼, 요약, 발표, 자막 전용), 각각의 형태, 어조, 길이 및 음악 분위기, 형식 및 플랫폼 안전 영역. 브리핑 직후에 읽으세요.
• references/story-and-comedy.md: 자료 찾기 및 비공개로 유지할 내용, story.json 작성, 단어에 시각 자료 타이밍 맞추기, 코믹 플레이북(재미있는 스타일용).
• references/production.md: 프로젝트 설정, 컴포넌트, 형식, 스크린샷, 검증 및 이미 경험한 함정. 빌드하기 전에 읽으세요.
• references/music.md: HeyGen 음악 설정(Windows/WSL 로그인 포함), 트랙 선택, 덕킹 및 무음 처리.
• references/toolbox.md: 이 워크플로우에서 사용하는 모든 도구, 스킬 및 CLI와 각각을 사용해야 하는 시기: Remotion 스킬, media-use, HeyGen, Kokoro, ElevenLabs, ffmpeg, 헤드리스 Chrome 및 번들 스크립트.

워크플로우

1. 사용자 인터뷰 후 브리핑 저장

사용자의 답변이 무엇을 만들지 결정하므로, 다른 작업을 하기 전에 먼저 질문하세요. references/brief.md를 따르세요:

1. 1라운드, 기본 사항(AskUserQuestion, 최대 4개 질문): 스타일, 게시 위치(형식 결정), 길이, 음성.
2. 2라운드, 모양과 느낌: 어조, 화면에 표시할 내용(사진과 클립, 목업의 스크린샷, 굵은 텍스트와 그래픽, 지도 또는 다이어그램), 색상 및 브랜드, 음악.
3. 3라운드, 자료 및 안전: 실명 사용 여부, 이름이 포함된 스크린샷 사용 여부, 자막, 엔딩.
4. 자유 텍스트 라운드, 채팅에서: 한 문장으로 요점, 포함할 실제 순간과 사실, 진심 어린 대사 또는 정확한 클 투 액션, 피하거나 절대 보여주지 말아야 할 것, 누가 누구인지, 참고할 만한 것, 파일 위치.
5. 언어: 비디오가 영어로만 되어 있지 않다면, 어떤 언어인지 묻고 음성 및 텍스트 렌더링이 해당 언어를 지원하는지 확인하세요(brief.md, "언어 및 오른쪽에서 왼쪽으로 쓰는 텍스트" 참조).
6. 요약 및 확인: 브리핑을 사용자의 말로 짧은 목록으로 다시 진술하고, "바꿀 내용이 있나요?"라고 물은 후 프로젝트 루트에 brief.md로 저장하세요.

사용자가 이미 말한 내용은 건너뛰고, 각 질문에 대한 기본값을 권장하며, 스타일에 맞게 옵션을 조정하고, 필요한 것만 물어보세요. 사용자가 "그냥 만들어 주세요"라고 말하면 1라운드만 물어보고, 요약에서 가정 사항을 나열한 후, 음성, 표시될 수 있는 사람, 비공개로 남겨야 할 사항은 사용자가 결정하도록 남겨두세요. public/photos/ 디렉토리를 만들고 파일 이름을 알려주세요: me와 이야기에 나오는 각 사람당 하나씩. 비디오 클립과 GIF도 작동합니다.

brief.md는 계약서입니다. 이후 모든 단계는 이를 따릅니다. 사용자가 마음을 바꾸면 먼저 brief.md를 업데이트한 다음 작업을 업데이트하세요. 전달 메시지에서 결과가 브리핑과 어떻게 일치하는지 설명하고 일치하지 않는 사항을 명시하세요.

사용자가 이야기("X가 사라고 해서 친구 Y와 함께 샀어요")나 메시지("새 메뉴를 출시합니다")를 제공했다면, 그것이 뼈대입니다. 다른 모든 것은 사용자의 자료에서 비롯됩니다.

2. 자료 수집

• 사용자의 노트(볼트, 저널, 프로젝트 폴더, Git 기록): 날짜별 타임라인, 사람 및 전환점, 비디오에서 제외할 비공개 항목 목록을 위해 연구 서브 에이전트를 보내세요(story-and-comedy.md 참조). 비디오에 비공개 정보를 넣지 마세요.
• 사용자의 미디어: 각 클립과 사진을 직접 확인하세요. 클립당 여러 프레임에서 번호판, 배지 및 화면을 확인하고 자르기 영역(focusY)을 결정하세요. 클립에 여러 사람이 나오는 경우 누가 누군지 물어보세요.
• 사용자의 작업: 라이브 사이트(헤드리스 Chrome, 데스크탑 및 휴대폰)의 스크린샷과 저장소에 있는 기존 앱 스크린샷.
• 브랜드 자산: 사용자의 실제 로고, 다시 그리지 마세요(media-use resolve --type logo 명령어는 공식 마크를 찾습니다). 사용자의 색상 및 글꼴.
• 프로모션 또는 튜토리얼을 위한 사실: 모든 숫자, 가격, 기능 및 단계는 사용자 또는 확인한 내용에서 가져옵니다. 주장을 지어내지 마세요.

3. 디자인 파일, 대본 및 스토리보드

먼저 design.md(팔레트, 글꼴, 로고, 모션 및 텍스트 규칙, 브리핑 및 사용자의 실제 브랜드 자산을 기반으로 함, 템플릿은 storyboard-and-gates.md에 있음)를 작성하세요. 그런 다음 story-and-comedy.md와 styles.md에서 선택한 스타일에 맞는 형태에 따라 story.json을 작성하세요. 그런 다음 STORYBOARD.md를 작성하세요: 장면당 한 행씩, 대사, 화면에 표시할 내용, 사운드 및 각 시각 자료가 도착하는 단어. 처음 2~3초 안에 후크로 시작하세요. 게이트: 사용자에게 대사와 스토리보드 표를 보여주고 빌드 전에 승인을 기다리세요. 단어를 변경하는 것은 지금은 저렴하지만 나중에는 비쌉니다. 농담 뒤에 숨은 실제 이야기와 진심 어린 대사를 사용자에게 직접 물어보세요. 게시 위치를 기록하세요: 릴스, 틱톡 및 쇼츠는 자막을 더 높게 배치해야 합니다(styles.md, "안전 영역").

4. 음성

내레이션이 없는 비디오(이 경우 자막이 단어를 전달함)인 경우 이 단계를 건너뛰세요. 그렇지 않으면 scripts/voice-samples.mjs로 샘플을 생성하고, 폴더를 열어 사용자가 직접 들어보고 선택하게 하세요(bm_george는 속도 1.1에서 코미디에 잘 작동했습니다; 더 차분한 음성은 추모 및 튜토리얼에 적합합니다). 그런 다음 scripts/make-voice.mjs를 실행하세요. 각 장면의 길이와 "breaks" 정렬 라인을 출력합니다. 단어 타이밍을 출력하고 어떤 단어도 1초를 넘지 않는지 확인하세요(production.md, "Pitfalls"). 다른 음성 소스는 toolbox.md에 있습니다.

5. 미리보기 일찍 열기

프로젝트가 실행되는 즉시 Remotion Studio(npx remotion studio)를 시작하고 미리보기를 열어 사용자가 빌드하는 동안 보고 방향을 잡을 수 있게 하세요. 사용자가 파일을 요청하거나 게시할 비디오를 전달할 때 MP4를 렌더링하고, 사용자가 계속 반복 작업하는 동안에는 미리보기가 결과물입니다.

6. 빌드

템플릿과 스크립트를 스캐폴드하고 복사하세요(production.md). 각 장면에 대해 컴포넌트(일반적으로 BeatScene과 시각 자료)를 작성하고, assets/template/src/story/scenes/(그리고 해당 폴더가 존재하는 경우 assets/examples/scenes/)에서 가져와서 조정하세요. 모든 시각 자료를 wordAt(...)를 사용하여 단어에 시간을 맞추세요. StoryVideo.tsx에서 타임라인을 유지하세요: 페이드 전환, 챕터 변경 시 슬라이드 및 휙 소리. 선택한 형식에 맞게 컴포지션 크기를 설정하세요. 기억에 의존하지 말고 STORYBOARD.md와 design.md를 기반으로 빌드하세요. 약 5개 이상의 독립적인 장면이 있는 경우 장면당 하나의 서브 에이전트로 병렬로 빌드하고(storyboard-and-gates.md 참조), 직접 조립하고 이음새를 확인하세요. Remotion 자체에는 Remotion 스킬을 사용하세요(toolbox.md). 사용자가 채팅 외부에서 코드를 편집한 경우 덮어쓰지 말고 의도적인 것으로 간주하거나 물어보세요.

7. 음악 및 사운드

실제 음악을 사용하고(music.md), 스타일에 맞는 분위기로 사용하세요(styles.md). 필요한 경우 media-use와 HeyGen CLI를 설치하고, 사용자가 로그인하도록 한 후 몇 가지 분위기를 검색하고, 메인 트랙과 두 개의 대안을 다운로드하고, 길이를 측정하고, MUSIC_GAIN을 설정하고, 트랙의 자연스러운 끝을 고려하여 계획하세요. 사운드 효과는 스타일이 원할 때만 사용하세요.

8. 검증 후 렌더링 승인 받기

• 모든 주요 시각 자료와 각 장면의 끝의 스틸 이미지를 확인하세요(scripts/stills.mjs).
• 프로모션 및 튜토리얼의 사실 확인: 모든 숫자, 이름 및 단계를 해당 출처와 대조하세요.
• 미리보기 게이트: Studio 미리보기 또는 주요 스틸 이미지를 보여주고 변경할 사항을 물어보세요. 사용자가 미리보기를 승인하거나 명시적으로 파일을 요청한 후에만 최종 MP4를 렌더링하세요.
• 새로운 버전명의 파일로 렌더링하세요.
• 오디오 측정 (scripts/check-audio.mjs).
• 최종 MP4의 프레임 확인으로 시간에 민감한 사항이 없는지 확인하세요.
• 비디오를 열어 보여주세요.

9. 전달

다음을 보고하세요:

• 파일 경로, 길이 및 크기
• 업데이트인 경우 변경된 사항
• 확인한 사항 및 오디오를 들을 수 없었다는 점
• 미해결 질문: 누가 누군지, 음악 분위기, 길이를 줄일지 여부

원칙

• 실제 vs 일반. 사용자의 클립, 친구, 실제 화면 및 로고.
• 어조는 목적에 맞게. 재미있는 것은 하나의 옵션입니다. 작별 인사, 제품 출시 및 튜토리얼은 각각 고유한 어조가 필요합니다. 어울리지 않는 곳에 농담을 억지로 넣지 마세요.
• 초반에 후크, 장면당 하나의 아이디어. 요점은 처음 2~3초 안에 보여야 하며, 모든 장면은 그 존재 가치를 증명해야 합니다.
• 시각 자료는 단어에 맞춰서. 시각 자료가 해당 단어에 맞춰 도착하는 것은 어떤 추가 효과보다 낫습니다. "더 좋게" 또는 "더 재미있게" 요청받으면 볼륨을 높이기 전에 타이밍과 단어를 다듬으세요.
• 하나의 핵심 비트. 진심 어린 대사, 행동 유도 또는 핵심 메시지를 명확히 진술하고 여운을 남기세요.
• 개인정보 보호는 기능입니다. 사용자의 노트에는 다른 사람이 보면 안 되는 내용이 포함되어 있습니다. 사용자는 당신이 묻지 않아도 그런 내용을 빼줄 것을 신뢰합니다.
• 사람에 대해 추측하지 마세요. 내레이터 음성은 이름이 아닌 직접 들어보고 선택하게 하세요. 그룹 클립에서 누가 누군지 확인하세요. 자료가 뒷받침하지 않는 인용문, 감정 또는 주장을 지어내지 마세요.
• 정직한 전달. 확인한 사항과 확인할 수 없었던 사항(오디오는 청취로 확인)을 말하세요. 길이가 요청한 것보다 길어졌다면 그렇게 말하고 가장 쉬운 컷을 제안하세요.