Aliw02/reel-agent-skill

Reel Agent Skill: Diretor de Vídeo Interativo nível Hollywood

Visão Geral

Diretor de pós-produção interativo e coeditor para transformar gravações brutas de cabeça falante em reels verticais 9:16 de alto engajamento. Opera por gates de aprovação visuais rigorosos passo a passo: cada fase renderiza um preview observável, fornece uma crítica de diretor artístico e pausa para revisão do usuário antes de prosseguir.

---

Invariantes Principais e Padrões de Qualidade

1. Gates de Aprovação Interativos Estritos: Nunca execute o pipeline inteiro em um lote monolítico não guiado. Complete um estágio, renderize um preview observável (.mp4, contact sheet ou preview do Studio), critique o resultado visual e obtenha aprovação explícita do usuário antes de passar para o próximo estágio.
2. Legendas Cinéticas Bilíngues Executivas (Zero Emojis):
   • Sem Emojis: Emojis são estritamente proibidos para manter uma estética executiva e de elite.
   • Empilhamento Bilíngue: Texto primário em árabe no topo (negrito, alto contraste, brilho pulsante na palavra ativa), tradução secundária em inglês abaixo (legenda platina sutil #94A3B8).
   • Unidades de Frase Naturais: Agrupe legendas por significado semântico (2–5 palavras por respiração natural da fala), nunca cortes mecânicos arbitrários.
3. Motion Design Hollywood e Camadas 3D:
   • Elementos Flutuantes 3D: Incline gráficos com perspective e rotateX/rotateY para criar profundidade.
   • Contadores Numéricos: Anime figuras faladas, métricas e porcentagens com contagem dinâmica para cima/baixo.
   • Vídeo Limpo em Tela Cheia: Mantenha o palestrante sem máscara e nítido (sem máscaras de ovo translúcidas artificiais).
4. Coreografia de Câmera Dinâmica e Design de Som:
   • Zoom Inteligente (Punch-in): Zoom suave (1.12x–1.18x) centralizado no nível dos olhos do palestrante em frases enfatizadas.
   • SFX Sincronizados: Associe entradas de cartões visuais, zooms e transições com whooshes, pops e impactos sutis.
   • Áudio Masterizado: Voz nivelada a -16 LUFS com ducking suave de música de fundo dinâmica.

---

Pipeline Diretorial Interativo de 4 Estágios

[Gravação Bruta]
      │
      ▼
┌─────────────────────────────────────────────────────────────┐
│ Estágio 1: Corte de Silêncio Baseado em Ritmo e Fala       │
│ Saída: .temp/trimmed.mp4                                   │
│ Gate: Revise o preview do vídeo cortado e confirme o tempo │
└──────────────────────────────┬──────────────────────────────┘
                               │ (Aprovado pelo Usuário)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ Estágio 2: Geração de Legendas Bilíngues e Auditoria de     │
│ Dialeto                                                     │
│ Saída: .temp/captions_reviewed.json                        │
│ Gate: Revise o texto em árabe, tradução em inglês e cortes │
│ de frase                                                   │
└──────────────────────────────┬──────────────────────────────┘
                               │ (Aprovado pelo Usuário)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ Estágio 3: Gráficos 3D, Coreografia de Câmera e Preview    │
│ Saída: .temp/edit_plan.json + Preview ao Vivo Remotion     │
│ Studio                                                      │
│ Gate: Revise cartões 3D, zooms, contadores e transições    │
└──────────────────────────────┬──────────────────────────────┘
                               │ (Aprovado pelo Usuário)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ Estágio 4: Masterização de Áudio, SFX e Render Mestre      │
│ 60FPS/30FPS                                                 │
│ Saída: output/final_reel.mp4 + visual_qc_contact_sheet.jpg │
│ Gate: Verifique o relatório de QC e inspecione o reel final │
└─────────────────────────────────────────────────────────────┘

---

Estágio 1: Corte de Silêncio Baseado em Fala e Ritmo

1. Analisar Áudio e Cortar Silêncio:

   python scripts/cut_silence.py --input "<raw_video.mp4>" --output ".temp/trimmed.mp4" --silence-thresh -30
   

2. Apresentar Preview Visual e Crítica do Diretor:
   • Inspecione .temp/trimmed.mp4 duração e cortes.
   • Reporte duração do corte, duração restante e qualidade de ritmo ao usuário.
3. Critério de Conclusão: O usuário revisa e aprova .temp/trimmed.mp4 antes de qualquer trabalho de transcrição ou gráficos começar.

---

Estágio 2: Legendas Cinéticas Bilíngues e Auditoria Semântica de Dialeto

1. Transcrever a Fala:

   python scripts/transcribe.py --audio ".temp/trimmed.mp4" --output ".temp/captions.json" --model "turbo" --language "ar" --fps 30
   

2. Auditar Árabe e Gerar Tradução de Legenda em Inglês:
   • Corrija nuances fonéticas, dialetos regionais (iraquiano, levantino, egípcio, do Golfo) e termos técnicos.
   • Traduza cada bloco de frase em árabe para uma linha secundária limpa e moderna em inglês.
   • Garanta zero emojis em todos os blocos.
   • Salve o payload bilíngue verificado em .temp/captions_reviewed.json.
3. Apresentar Revisão de Legenda:
   • Exiba cada frase com seu texto primário em árabe, tradução em inglês e tempo de início/término.
4. Critério de Conclusão: O usuário aprova a precisão do texto, tradução e limites de frase.

---

Estágio 3: Gráficos 3D, Coreografia de Câmera e Preview no Studio

1. Sintetizar Plano de Edição Personalizado:

   python scripts/director.py --transcript ".temp/captions_reviewed.json" --output ".temp/edit_plan.json" --theme "box_glass" --fps 30
   

2. Adições Diretoriais:
   • Gestos e Espaço Negativo: Posicione cartões 3D e crachás opostos à direção do olhar do palestrante.
   • Métricas Faladas: Insira cenas AnimatedCounter ou cartões PIP para números falados.
   • Ênfase com Zoom: Adicione eventos de zoom punch_in (escala 1.15x) ancorados em [0.50, 0.38].
   • Transições: Aplique zoom_cut limpo ou micro-flashes cromáticos sutis (evite barras de glitch neon pesadas).
3. Iniciar e Dirigir Preview no Studio:
   • Copie assets para public/ e instrua o usuário a percorrer a timeline no npm start (http://localhost:3000).
   • Descreva escolhas diretorais (ângulos de câmera, temporização de cartões, gradação de cor).
4. Critério de Conclusão: O usuário verifica composição, posicionamento de gráficos e movimento de câmera no Remotion Studio.

---

Estágio 4: Masterização de Áudio, SFX e Render de Qualidade Mestre

1. Masterizar Loudness e Mixar SFX:
   • Nivele diálogo para -16 LUFS.
   • Associe SFX (whoosh.mp3, pop.mp3, impact.mp3) às transições e quadros de entrada de cartões.
2. Executar Render Multicamadas Mestre:

   node scripts/render_reel.js --plan .temp/edit_plan.json --output output/final_reel.mp4
   

3. QC Técnico e Visual Automatizado:

   python scripts/qc.py --video "output/final_reel.mp4" --plan ".temp/edit_plan.json"
   

4. Critério de Conclusão: output/final_reel.mp4 passa no QC (1080x1920, duração exata, stream de áudio válido) e .temp/visual_qc_contact_sheet.jpg é apresentado ao usuário.

---

Matriz de Posicionamento e Estilo Diretorial

Elemento	Especificação	Regra Diretorial
Cabeçalho Hook Superior	top: 130px, cápsula escura de vidro	Ativo nos primeiros 1.5–2.5s; fonte Cairo 800; sem emojis.
Texto Primário em Árabe	Fonte: Cairo / Readex Pro, Tamanho: 54px	Branco de alto contraste, salto pulsante dourado/ciano na palavra ativa.
Texto Secundário em Inglês	Fonte: Inter / Geist, Tamanho: 32px, Cor: #94A3B8	Posicionado diretamente abaixo da linha em árabe.
Posição Vertical da Legenda	bottom: 220px–240px	Livre de sobreposições de UI da plataforma inferior e livre do peito do palestrante.
Zoom (Punch-in)	Escala: 1.14x–1.18x, Origem: [50%, 38%]	Curvas suaves de 30–60 quadros em frases de fala de alta energia.
Cartões Flutuantes 3D	Espaço negativo superior esquerdo / superior direito	Inclinação com perspectiva 3D (rotateY: -8deg), entrada suave com spring.
Gradação de Cor	Contraste: 1.05, Saturação: 1.08, Vinheta: 0.35	Visual limpo e natural de criador, sem escuridão lamacenta.
Ducking de Áudio	BGM: 0.14 $\to$ 0.035 durante fala	Atenuação suave de volume ao longo de 8 quadros.