Visão Geral
Esta skill transforma um changelog de release em uma composição de vídeo polida usando a renderização baseada em HTML do HyperFrames. Use-a quando uma atualização de produto merece um anúncio visual — quadros heróis, chamadas principais de marcadores e um padrão de fundo. Ela produz um MP4 renderizado a partir das entradas do changelog que você fornecer.
HyperFrames — Vídeo de Changelog
Entrada: um changelog .md (temas + itens). Saída: um projeto HyperFrames limpo, com verificação de costura (seam-gate) aprovada. Renderize apenas quando solicitado.
Quando Usar
- O usuário fornece um changelog/resumo markdown e deseja o vídeo semanal
- O usuário diz "vídeo de changelog" ou "vídeo do resumo semanal"
- O usuário deseja um vídeo com marca com UIs mock animadas e narração
Quando NÃO Usar
- O usuário deseja um lançamento de produto (use
hyperframes-product-launch-video) - O usuário deseja um gráfico em movimento (use
hyperframes-motion-graphics) - O usuário deseja um vídeo com apresentador (use
hyperframes-embedded-captions)
A Diretriz Principal: Visualize, Não Liste
Cada tema é ilustrado por um mock animado da UI real ou de um análogo fiel representando a mudança na experiência — nunca marcadores de texto. Roteie cada tema/item pelo registro de visualização ANTES de escrever o script.
Fluxo de Trabalho
0 · Inicialização a partir dos assets da skill (innegociável)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
Em seguida, leia references/build-spec.md de ponta a ponta — ele define os tokens da marca.
1 · Análise e corte editorial
- Extrair: intervalo de semanas, estatísticas principais, temas, itens
- Orçamento: 45-60s no total. Título ≤2s, encerramento ≤3.5s, 4 temas ≈ 9-12s cada
- Por tema, mantenha UMA visualização principal + no máximo 3 itens falados
- Ordene os temas por história: funcionalidade principal → superfície do produto → desempenho → confiabilidade
2 · Roteamento de visualização
Para cada tema, escolha a superfície do registro de visualização e escreva uma linha: tema → superfície → as 2-4 ações sequenciais que o mock executa, cada uma ligada a uma frase do script.
3 · Script de duas camadas (falado vs. exibido)
Escreva o script como linhas de tokens: registro conversacional, cada termo técnico carregando uma forma spoken fonética enquanto display mantém a ortografia padrão. As legendas mostram display; a narração lê spoken.
4 · Narração + timestamps de palavras
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
Timestamps de palavras são uma verificação obrigatória. Antes de prosseguir, verifique se vo-words.json não está vazio e contém um array words: [...] com start/end por palavra.
5 · Construção
Siga references/build-spec.md exatamente: tokens da marca + fontes + a codificação do fundo animado + o esquema da cena + o chrome + a barra de legendas. Em seguida, a ordem da doutrina: ledger de vetores → carimbo de costura → batidas internas nas palavras da narração → verificação de costura.
Legendas são obrigatórias. Popule o array LINES a partir de captions.json antes de prosseguir.
6 · Verificações (todas verdes antes de apresentar)
hyperframes check— 0 errosseam-gate.mjs verify— 0 falhas- Reinicie o servidor de pré-visualização, verifique 3-4 batidas
- NÃO renderize a menos que o usuário solicite
- Verificação de presença de legendas — amostre 3-4 quadros, confirme que a barra de legendas está visível
Tabela Anti-Racionalização
| Racionalização | Realidade |
|---|---|
| "Slides com marcadores para mudanças de UI" | Crie um mock da superfície representando a mudança |
| "UI falsa para itens não representáveis" | Cena de checklist honesta |
| "'JSON' simples no texto TTS" | Formas faladas no léxico; exibição permanece padrão |
| "Adivinhando pronúncia" | Pergunte, então expanda o léxico |
| "Falando cada item do changelog" | ≤3 por tema; o link do resumo carrega o resto |
| "Acentos verdes em todo lugar" | Um momento verde por cena |
| "Começando a partir do index.html de um vídeo anterior" | Copie master-skeleton.html, sempre |
| "Array LINES vazio está tudo bem" | LINES vazio = envio sem legendas = refazer a execução |
Verificação
-
hyperframes checkpassa com 0 erros -
seam-gate.mjs verifypassa com 0 falhas - Barra de legendas visível em 3+ quadros amostrados
- Timestamps de palavras alinhados com o áudio
- Tokens da marca correspondem ao build-spec.md
- Renderizado apenas quando o usuário explicitamente solicitar