brand-video — 일관된 스타일의 무연고 비디오, 주문 제작
**/brand-video**로 호출합니다. 하나의 명령으로 다양한 룩을 제공합니다. 검증된 RestoreAssist 실행(9개 비디오 전달)을 기반으로 구축되었습니다. styles.md에서 스타일을 선택하고, 다른 모든 것은 일정하게 유지하여 배치 간, 브랜드 간 일관된 출력을 보장합니다.
입력 (누락된 경우에만 묻고, 합리적으로 추론)
- brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite 또는 클라이언트. 주장 + CTA + 음성을 설정합니다.
- style —
styles.md의 키값 (기본값flat-line). 이것이 "룩"/드롭다운 값입니다. - topic(s) — 하나의 각도 또는 배치 목록 (각 주제마다 하나의 비디오, 병렬 처리).
- voice —
ELEVENLABS_VOICE_ID(브랜드별;~/.hermes/.env에서 가져옴). 중요: 생성 전에 현재 값을 반드시 확인하세요 — 사용자가 변경합니다. - upload? — 기본값: 렌더링 + 스테이징만. 요청 시에만 YouTube 미등록 업로드.
파이프라인 (비디오당 하나의 슬러그 폴더, 디렉토리 공유 금지)
- 스크립트 →
<slug>/script.md: 하나의 깔끔한 VO 문단, 약 120–140 단어, 약 12–16개의 짧은 문장 (한 문장 = 하나의 시각적 비트 = 하나의 이미지), 문제→해결→CTA 순서. 브랜드 위키에 근거하여 주장을 뒷받침하며, 기능을 절대 허위로 만들지 마세요. 브랜드 CTA 라인으로 끝냅니다. - 보이스오버 → 번들
tts.py실행 (ELEVENLABS_API_KEY+ELEVENLABS_VOICE_ID+DIR읽음):cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py<slug>/voiceover.mp3+<slug>/transcript.json(비트)를 작성합니다. 비트 수를 확인하세요. - 이미지 → 비트당 하나, 프롬프트 = 선택한 스타일의 POSITIVE 토큰 + 해당 문장에 대한 구체적인 장면 + 스타일의 NEGATIVE 토큰, 가로 16:9, 제로 패딩된
<slug>/images/01.png …로 저장.- 프로덕션 / 헤드리스(기본값):
python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png>— Geminigemini-2.5-flash-image("Nano-Banana") HTTPS를 통해,GEMINI_API_KEY는 환경 변수에서 가져옴. 서버 측에서 작동하며 종단 간 검증됨. 앱 워커가 호출하는 방식입니다 (로컬 MCP 불필요). - 대화형(선택 사항): Claude 세션 내에서 실행 시
mcp__margot__image_generate사용; 슬러그 접두사가 붙은 파일명을 사용하여 병렬 충돌을 방지합니다 ([[parallel-agents-shared-output-collision]] 참조).
- 프로덕션 / 헤드리스(기본값):
- 스티칭 →
python3 <skill>/pipeline/stitch.py <slug>→<slug>/final-1080p.mp4(1920×1080@25, 비트의 이미지 타이밍 기반). 최종 길이가 보이스오버 길이와 일치하는지 확인하세요.
배치 및 새 룩
- 배치: 주제당 하나의 하위 에이전트를 디스패치합니다 (병렬), 각자 고유한 슬러그 디렉토리를 소유합니다. 정확한 에이전트 프롬프트 형태는 RestoreAssist 실행을 참조하세요.
- 재보이스 (음성 변경, 동일 스크립트/이미지): VO 재생성,
list.txt지속 시간을new_total/old_total로 재조정, 다시 스티칭합니다. (revoice 패턴.) - 룩 추가:
styles.md에 블록을 추가합니다 (positive/negative 토큰). 해당 키는 즉시 선택 가능한 스타일이 됩니다 — 이 레지스트리가 드롭다운의 데이터 소스입니다.
업로드 (YouTube, 선택 사항)
브라우저 파일 업로드는 비활성화되었습니다 (호스트 경로 거부됨). [[youtube-api-upload-restoreassist]]에 문서화된 YouTube Data API 경로를 사용하세요: Desktop OAuth 클라이언트 → ~/.hermes/yt-restoreassist-token.json의 토큰 → videos().insert privacyStatus=unlisted, category 27, not-for-kids; 채널 제목으로 가드; uploaded.json을 통해 멱등성 보장. OAuth 클라이언트의 GCP 프로젝트에서 YouTube Data API v3가 활성화되어 있어야 합니다.
가드레일
- 주장은 실제여야 합니다 (브랜드 위키/제품 진실). 플랫 일러스트 + 합성 음성 → YouTube AI 공개는 일반적으로 "아니요"입니다 (업로드 시 확인, AI 음악이 추가된 경우 "예"로 전환).
- 일관성을 위해 배치당 하나의 스타일을 유지하세요.
SKILL.md를 [[feedback-tight-code]] 당 200줄 이하로 유지하세요. - 참조 구현 + 자산:
/Users/phill-mac/restoreassist-videos/.