Remotion Explicador de Engenharia de Software (remotion-software-explainer)
Visão Geral
Transforma qualquer design de sistema, arquitetura distribuída, padrão de projeto, funcionamento interno de banco de dados ou fluxo de DevOps em um vídeo explicativo Remotion MP4 1920×1080 30fps imersivo e sincronizado com quadros, no Formato Log2Base2 Studio de Painel Único.
Nunca divida a tela em painéis lado a lado concorrentes ou paredes de cartões de texto empilhadas. Cada vídeo usa um palco visual unificado (<SinglePaneStage>):
- Barra Superior Mínima (
44px, integrada aoSinglePaneStage) :- Título do tópico + pílula de seção ativa à esquerda; contador de etapas sutil + barra de progresso fina à direita.
- UM Palco Log2Base2 Unificado (
SinglePaneStage— 100% de largura) :- Cabeçalho de Destaque de Linha Única Focado: Destaca o elemento falado ativo (
replicas: 3,ConsistentHash,WAL,CircuitBreaker) na linha de contrato/especificação ativa comborderBottom: "2px solid #FACC15"(nunca adicione preenchimento horizontal) mais uma pílula de chamada ativa compacta (termo→função arquitetural) emtriggerFrame. - Canvas SVG Imersivo de Largura Total (
viewBox="0 0 1600 680"): Nós de serviço vetoriais progressivos (Cliente, API Gateway, Balanceador de Carga, Microsserviços, Fila de Mensagens, Cache, Shards de BD, Pods K8s) aparecendo conforme são falados, conectados por pipelines animados tracejados com pacotes de requisição viajantes, medidores de acerto de cache/throughput ao vivo e spans de rastreamento de requisição fluindo diretamente no mesmo canvas aberto.
- Cabeçalho de Destaque de Linha Única Focado: Destaca o elemento falado ativo (
- Barra de Legendas Inferior Mínima (
VoiceoverCaptionBar—68px) :- Legendas limpas e centralizadas com destaque palavra por palavra no estilo karaokê, geradas por timestamps exatos de
WordBoundarydo TTS.
- Legendas limpas e centralizadas com destaque palavra por palavra no estilo karaokê, geradas por timestamps exatos de
Dependências
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
Início Rápido
# 1. Scaffold
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/caminho/para/projeto" \
--output "/caminho/para/projeto/scaffold-status.json"
# 2. Sintetizar Narração
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/caminho/para/projeto" \
--beats-json "/caminho/para/projeto/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/caminho/para/projeto/public/voiceover/manifest.json"
# 3. Renderizar MP4 1080p
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/caminho/para/projeto" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/caminho/para/projeto/render-report.json"
Narrativa Imersiva e Fluxo de Trabalho
- Mantenha o
snippetfocado (2–4linhas) para que<SinglePaneStage>destaque uma linha de contrato ativa e revele os nós da arquitetura progressivamente — nunca despeje 15 caixas no quadro 0. - Defina
"motionStepFrames": 2nos beats com pacotes de requisição viajantes, cascatas de failover ou animações de escalonamento automático. - Mostre, não conte: Anime pacotes de requisição se movendo entre nós junto com barras de latência/fila/rastreamento ao vivo diretamente dentro do mesmo canvas SVG de largura total
1600×680(usando<clipPath>quando necessário), nunca em caixas separadas em tela dividida. - Sempre execute
npm run lint, inspecione quadros representativos estáticos (npx remotion still) comread_filee salve o.mp4final emout/, na raiz do projeto e na raiz do workspace.