영상 제작 (진입)
출처: docs/MONTAR_VIDEO.md. 이 스킬은 실행 스크립트입니다. 세부 사항(추론 표, 전체 명령어, 병렬 처리, 자주 발생하는 문제)은 해당 문서에 섹션(§)별로 인용되어 있습니다. 또한 리포지토리의 CLAUDE.md 규칙을 숙지하세요. 이 규칙이 우선합니다.
단계 0 · 시작 (아무것도 묻지 않음)
- 시작 시간:
date '+%Y-%m-%d %H:%M:%S'. 저장합니다 (BRIEF.md › 시작및 보고서에 사용). node scripts/doctor.mjs(약 1초, 읽기 전용). "준비 완료" 출력 확인. 관련 워크플로에 ✗ 표시가 있다면 → 출력된 해결 방법을 적용합니다 (로컬 및 무료인 경우) 또는 인터뷰 응답과 함께 사용자에게 알립니다.ls brutos/ proyectos/실행. 프로젝트가 이미 존재하면 재개합니다 (BRIEF.md와informe.md를 읽음).brutos/의 파일명에 사람 이름이 있으면, 채팅에서는 이름 대신ffprobe로 길이와 해상도를 설명합니다.
단계 1 · 인터뷰: AskUserQuestion 한 번 호출 (3–4개 질문)
먼저 사용자의 문장에서 가능한 모든 것을 추론합니다 (§2). 사용자가 이미 말한 내용은 묻지 말고, 해당 질문을 예비 질문 중 다음 것으로 대체합니다. 각 질문: 2–4개의 옵션, 추천 옵션을 먼저 레이블에 "(추천)"을 붙이고 그 이유를 설명에 포함. 항상 자유 응답("기타")을 허용합니다. 각 질문의 상세 내용: §1.
| # | 헤더 | 질문 | 옵션 (맥락에 따른 추천) |
|---|---|---|---|
| 1 | 재료 | 어떤 영상과 어떤 재료로? | 발표자 녹화 (brutos/에 원본이 있음) · AI 음성 내레이션 (뉴스, 익스플레너; 녹화 없음) · 생성형 또는 프로모 (HyperFrames) |
| 2 | 템플릿 | 어떤 템플릿? | 1에 따라: clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / HyperFrames 워크플로 — 그리고 자유, 템플릿 없음. 1이 열려 있다면: 챕터별 긴 형식 · 짧은 형식 · 자유 |
| 3 | 스타일 | 어떤 스타일? | 카탈로그에서 2개를 골라 참조 경로(estilos/README.md)와 함께 제시 · 웹사이트나 영상에서 새로 만들기 (estilos-video §5). 자유 → 기타 |
| 4 | 포맷 | 길이와 포맷? | 16:9, 템플릿 길이 (Remotion) · 9:16 · 16:9 및 9:16 (video-corto에서 추천). 다른 길이 → 기타 |
예비 질문 (순서대로): 언어 · 음성 (기본값은 .env의 것, 모델 eleven_v4) · 음악 및 효과 (스타일의 것을 사용하거나 ElevenLabs로 새로 생성) · 폰트 (사용자 제공 또는 공식 조사) · 발표자 크롭 · 대상 및 배포처. 경로별 스타일 추천, 길이 및 실제 예시가 포함된 템플릿: §1 및 §1.1.
필수 항목이 누락된 경우에만 두 번째 질문: 어떤 원본(여러 개일 경우), 주제, URL.
다른 에이전트(Codex…): 질문 번호와 옵션 목록을 포함한 단일 메시지로 동일한 내용 전달.
단계 2 · 브리프
답변을 바탕으로 확정된 내용과 추론된 내용(출처 포함)을 한 문단으로 요약하고 즉시 무료 작업을 시작합니다. plantillas/<템플릿>/BRIEF.md를 기반으로 BRIEF.md를 작성합니다 (§3):
- Remotion:
tools/kaleidos nuevo …(빈 파일 생성) 실행 후, 생성된 파일을 채워진 템플릿으로 대체합니다. - HyperFrames:
npx hyperframes init이후 워크플로가 작성합니다 (init은 디렉토리 내 파일이 있으면 거부).
단계 3 · 라우팅 (정확한 명령어는 §4)
| 재료 | 경로 | 수행할 작업 |
|---|---|---|
| 발표자 녹화 | §4.1 | edicion-ponente 스킬을 따릅니다: tools/kaleidos nuevo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo를 백그라운드에서 실행 → 전체 전사본 읽기 → guion.json (plantillas/<템플릿>/의 골조 사용) → linea / media / capitulos |
| AI 음성 내레이션 | §4.2 | tools/kaleidos nuevo <slug> --narracion --estilo milikito --escenario → plantillas/<템플릿>/* 복사 → fuentes.md에 공식 출처 → locucion.json → 병렬로 images.mjs ‖ capture.mjs ‖ voz --simular 및 voz --max-caracteres N → transcribir → python3 plantillas/herramientas/cues.py <slug> → media → linea → media → capitulos |
| 생성형 또는 프로모 | §4.3 | /hyperframes 스킬 로드 (video-corto, product-launch-video, general-video… 선택), 프로젝트는 proyectos/<slug>/, 스타일은 init 후 frame.md로 |
| 새 스타일 또는 변형 | §4.4 | estilos-video 스킬 (§5 새 스타일, §6 변형) 및 사용 전 validar.mjs 통과 확인 |
내레이션에서 intro.previo는 포함, intro.hasta는 제외; 챕터 제목 레이블의 3,4초 동안 이벤트 없음; 말풍선은 x 0.2–0.25, y 0.16–0.17 (§4.2, 항목 6).
단계 4 · 병렬 처리 (§6)
경합하지 않는 작업은 동시에 실행: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ 조사 및 대본; preparar --paralelo (GPU로 크롭하는 동안 CPU는 대기) 및 전사본이 준비되는 즉시 대본 작성. 16GB에서는 다음을 동시에 실행하지 않음: recortar + transcribir + pose, 두 개의 GPU 단계, 두 개의 stills.mjs, 또는 el-audio.mjs와 voz. 장시간 프로세스는 전체 로그를 기록하며 백그라운드에서 실행 (ffmpeg에 대해 grep 사용 금지). Lambda는 --concurrencia max 사용.
단계 5 · 체크포인트 (§5)
- 유료 API:
voz --simular(문자 수 계산) 및 이미지 생성 전 이미지 수 확인; 브리프에서 요청하는 경우에만 Apify 사용,--dry-run및--budget포함. - Lambda 전에 항상 스틸 확인:
node motor/scripts/stills.mjs <slug> --at eventos→ 시트 열기 (motor/out/stills/<이름>/hoja.jpg) Read로 열고 실제로 확인 및 수정 (코드보다 대본 우선).estilos-video§7로 스타일 준수 확인. HyperFrames:npx hyperframes check --snapshots. - AWS:
node motor/scripts/lambda.mjs <slug> --dry-run --concurrencia max→ 리소스(함수, 사이트, 비공개 버킷, 업로드), 함수 수, 예상 비용 및 시간 표시 → 명시적 승인 대기. 사용자가 이미 이 요청에서 Lambda 렌더링을 명시적으로 요청했다면: 표시하고 기다리지 않고 실행. 리소스(버킷, 스택, IAM) 생성은 항상 별도의 승인이 필요. 배포된 Lambda가 없는 HyperFrames → 경고하고 로컬 렌더링 또는 배포 옵션 제공. - 출력:
ffprobe+ 프레임 수 계산, 분당 한 프레임 시트,python3 plantillas/herramientas/normalizar_audio.py resultados/<slug>.mp4 --en-sitio(Lambda 출력은 약 −13 LUFS). - 최종 보고서 (
proyectos/<slug>/informe.md+ 채팅 요약): 길이, 구조, 확인 사항(샘플링된 프레임, 전체 시청 아님), 경고, 불일치, 총 소요 시간 (시작 → MP4 확인,work/logs/tiempos.json분석 포함) 및 비용 (실제 Lambda + S3 + 전송;work/voz/manifest.json의 ElevenLabs 문자 수; 이미지; Apify). 추정 금액 없음: 가격을 모르면 소비된 수량을 제시. AWS에 남아 있는 것을 알림.
절대 위반하지 않는 규칙 (§8 및 §9)
- 개인정보 보호: 응답, 보고서, 그래픽 또는 레이블에 고객의 개인 데이터를 포함하지 않음; 개인 데이터가 포함된 전사본 일부를 인용하지 않음; 화면에 나타나는 개인 데이터는 모자이크 처리. 일반적인 레이블 사용.
.env: 값을 절대 표시하거나 URL에 포함하지 않음; doctor는 이름만 제공.- 콘텐츠: 그래픽은 음성 내용을 요약; 허위 내용 금지; 최신 정보는 공식 출처만 사용,
fuentes.md에 날짜와 함께 인용 (웹사이트 다운로드가 403을 반환하면 내장 브라우저로 읽기); 불일치 사항은 보고서에 기록; 법적 또는 임상 내용 → 전문가 검증 필요. brutos/및~/videos-opus는 읽기 전용. Remotion 4.0.529 정확히 사용. OFL/Apache 라이선스 폰트만 사용.