Vídeo explicativo curto (9:16, ~60-90 s, voz em tailandês, qualquer tópico)
Runbook para um vídeo explicativo vertical: notícias, análise de ferramentas ou repositórios, conceitos, tutoriais ou demonstrações de algo que o proprietário construiu. A mecânica de construção e estilo estão na skill create-video; carregue-a antes do passo 4. Mecanismos de voz e suas peculiaridades: references/voice-options.md.
Requer: bun, ffmpeg/ffprobe, python3 e para measure_ink.py Pillow + numpy (uv run --with pillow --with numpy ...). O polimento da prosa em tailandês usa as skills kien-thai e kode-thai (npx skills add chakrit/kien-thai).
Padrões (não precisa perguntar novamente)
- 9:16, 1080x1920, 8-10 beats, cerca de 60 s (Shorts permitem até 3 min; um roteiro lido pelo proprietário geralmente fica em 80-90 s)
- Estilo: o último estilo Atlas que o proprietário aprovou. Kits no template: Ballpoint (
src/style/ballpoint.js, window.BP) e Whiteboard (src/style/whiteboard.js, window.WB). Um novo estilo precisa do prompt Futurepedia AI Style Atlas colado. - Visuais desenhados em código. Apenas logos reais para o assunto e como créditos de fonte. Nenhuma foto de notícia. Exceção: quando o assunto é uma demonstração web ao vivo, misture capturas de tela reais do navegador (que você mesmo captura) para os beats "veja funcionando" com beats desenhados para o mecanismo.
- Voz: o proprietário grava ele mesmo. Entregue
read-script.md, ele envia uma gravação,scripts/split_recording.pyouscripts/assemble_takes.pycorta em beats. Vozes sintéticas apenas se ele pedir (references/voice-options.md). - Sem emoji, sem chaves de API, cite fontes.
Escolha primeiro a estrutura da história
Estruturas e modelos de beats: templates/story-shapes.md.
| Estrutura | Uso | Verificação ao vivo |
|---|---|---|
| Notícia | Algo aconteceu, pode ainda estar acontecendo | Sim, antes da renderização |
| Análise / demonstração de ferramenta | Um repositório, app ou produto: o que faz e o problema | Execute você mesmo |
| Conceito | Como algo funciona | Não |
| Tutorial | Passos para fazer algo | Não, mas teste os passos |
Passos e gates de aprovação
- Escolha do tópico. Prefira histórias com um mecanismo para desenhar em vez de notícias de "quem fez o quê"; pule escândalo/fofoca e processos recentes sem nada a explicar ainda. Apresente 3-4 opções classificadas com justificativa, e diga que vêm de manchetes ainda não verificadas. Verifique
dateprimeiro.- Atualidade: um clipe de notícia que não possa ser publicado em ~1-2 dias do evento está obsoleto; avise antes de investir tempo. Ofereça alternativas: esperar pelo desdobramento principal (ex.: relatório pós-incidente) ou reformular como um clipe de Conceito atemporal usando o incidente como exemplo.
- Pesquisa. Leia a fonte primária (repositório, documentação, página de status, post oficial) mais outros veículos. Mantenha três rótulos separados: verificado por mim / reivindicado pela fonte / minha interpretação.
- Problemas/resumos de transferência: verifique cada afirmação de "estado atual" contra o estado real (o PR foi mesclado? a URL está no ar? o arquivo está onde diz?). Leia arquivos do GitHub (
gh api repos/O/R/contents/PATH -H 'Accept: application/vnd.github.raw') em vez de clonar ou fazer checkout do repositório local do proprietário. - Demonstrações: execute a coisa real em um navegador, reproduza quaisquer números informados e meça tamanhos de assets (
curl -sIL ... content-length) em vez de confiar em estimativas fixas no código-fonte. Relate discrepâncias em uma tabela afirmação/real. - Alegações de "sem servidor" / privacidade: liste as requisições de rede da página (
performance.getEntriesByType('resource')). Beacons de análise de hospedagem (ex.: Cloudflare/cdn-cgi/rum) aparecem em uma captura do DevTools; filtre para fetch ou explique-os na tela.
- Problemas/resumos de transferência: verifique cada afirmação de "estado atual" contra o estado real (o PR foi mesclado? a URL está no ar? o arquivo está onde diz?). Leia arquivos do GitHub (
- Roteiro a partir do modelo da estrutura, números por extenso, duração atingida cortando palavras, nunca acelerando. Escreva
read-script.md(beats numerados, um fôlego cada).- Notícia = pirâmide invertida: o beat 1 é uma abertura completa (quem, fez o quê, quando) que se sustenta sozinha; depois do mais para o menos importante; atribua cada afirmação ("X ระบุว่า", "ด้าน ... เชื่อว่า"); sem opinião ou moral na voz, conclusões vão na legenda.
- Créditos e URLs exigidos pelo resumo vão no último beat e na tela.
- Polimento com
kien-thaivia loopkode-thai: audite, cite slugs de regras, corrija, releia, repita até que uma passagem não encontre nada. Explicadores falados pelo proprietário = registro de blog pessoal, masculino: ผม, ครับ apenas na despedida, คุณ para o espectador, เรา para a equipe. Correções recorrentes em rascunhos de modelo: เรา oscilando entre criador e espectador (deixis-continuity), ทิ้ง para "drop" (verb-calque), "não é X é Y" sem ต่างหาก (f4/targhak-closure), เมกะ/เมกะไบต์ misturados (uma forma por termo), ก็เลย/พอ repetidos entre beats adjacentes.
- Voz -> GATE 1 (proprietário ouve). Instruções de gravação (QuickTime > Arquivo > Nova Gravação de Áudio, Qualidade Máxima, não AirPods; ou Memos de Voz do iPhone + AirDrop): pausa ~2 s entre beats, claramente maior que uma respiração (lacunas auto-gravadas saíram 0.6-0.9 s, iguais a respirações no meio da frase, então nenhum limiar as dividiu em exatamente N); releia um beat errado imediatamente; leia nomes em inglês naturalmente. Ofereça-se para verificar um teste de 10 s do beat 1 primeiro.
- Encontre a gravação: ele pode colocar vários arquivos (takes) em uma subpasta e dizer apenas "pronto". Pesquise recursivamente a pasta do projeto mais
find ~ -mmin -30 -iname '*.m4a', depois por arquivo reporte duração, média/máxvolumedetecte mapa de silêncio antes de cortar. Coloque caminhos entre aspas em loops (nomes de Memos de Voz contêm espaços). - Um arquivo:
python3 split_recording.py <arquivo>; ele para a menos que encontre exatamente N beats. Se nenhum limiar der a contagem certa, não force um corte: peça tempos aproximados de início de beat e ajuste cada corte ao silêncio mais próximo. - Vários arquivos / retakes: pergunte qual arquivo é qual beat, depois
assemble_takes.pycom umtakes.jsonde {arquivo, início, fim} por beat. Divida um arquivo com vários beats nos silêncios mais longos e verifique cada corte contra a taxa de fala dos arquivos de um beat (~11 caracteres tailandeses/s); sinalize beats cujo tempo falado é >20% menor (possíveis palavras puladas). Ele nivela o volume de cada beat (beat_lufs), encurta pausas no meio da frase paramax_pausecortando o meio de cada pausa (ffmpegsilenceremovemal faz isso), depois comprime antes de loudnorm (pico de fala ~22 dB; termina perto de -18 LUFS em TP -1.5).
- Encontre a gravação: ele pode colocar vários arquivos (takes) em uma subpasta e dizer apenas "pronto". Pesquise recursivamente a pasta do projeto mais
- Storyboard -> GATE 2 (proprietário aprova). Still de cada beat no tempo de término como uma folha de contato mais PNGs em resolução total. Liste qualquer coisa assumida ou ilustrativa.
- Meça o enquadramento por pixels, nunca a olho (uma vez, estimativa visual errou um deslocamento uniforme para a direita).
scripts/measure_ink.py --z .. --camx .. --camdy .. stills...encaixa a tinta de cada beat dentro da caixa segura TikTok/Reels x 140-940, y 230-1500 (caso contrário, o conteúdo vaza sob a UI do app) e imprime CAMXS/CAMDY/ZS corrigidos; uma passada de remedição deixa margem >= 8 px. Envie umstoryboard-sheet-safezone.pngcom as faixas inseguras tingidas (ffmpegdrawbox). - Capture cada still logo após a ÚLTIMA marca daquele beat (seu fim de IO), não no início do próximo beat menos uma constante: um beat que termina cedo já está rolando para longe e mede de forma muito incorreta.
- Mostrando erros de OCR / reconhecimento de texto: faces tailandesas sem laço (Sriracha, Mali, a maioria das fontes de UI) desenham น como u latino e บ/ป como U, então uma leitura errada como
QนotationPARECE correta na tela e para verificações visuais. Verifique strings via texto JS, não capturas de tela; desenhe leituras erradas em Itim (com laço, OFL, incluída no template) e circule o glifo invertido usando measureText.WB.mTextrecebe uma cor hex: passeB.hexOf(RED), não o array RGB.
- Meça o enquadramento por pixels, nunca a olho (uma vez, estimativa visual errou um deslocamento uniforme para a direita).
- Renderize e verifique.
bun run render <slug>. Quadros == duração x 30; LUFS da voz no mp4 == arquivo de voz (narração multiplexada); trilha sonora ~20+ dB abaixo da voz; stills de meio de desenho (não fins de beat) para verificar que a caneta está sobre a tinta e nada sai da caixa segura. Para Notícias, releia a fonte primária primeiro e atualize o carimbo de data/hora na tela. - Entregue em
~/Downloads/<slug>-video/: mp4 completo,-small.mp4(CRF 24), wav da trilha, legendas detemplates/captions.md. Forneça caminhos absolutos. - Publicação. Nunca publique publicamente pelo proprietário. Se fizer upload para ele, defina como Privado e marque "Conteúdo alterado ou sintético" do YouTube apenas quando a voz for sintética; ele aperta Publicar. Caso contrário, forneça um kit copiável: caminho do arquivo, título, descrição, configurações a marcar.
Scaffold
scripts/new_short.sh <slug> [--out dir] [--from template] [--kits dir] [--no-install] copia o template/ incluído (Itim + fontes tailandesas, câmera de caixa segura, scripts de renderização/stills, vídeos de referência) para ~/Videos/shorts/<slug>/ (ou $SHORT_VIDEOS_DIR), mantém vídeos anteriores como _reference_* para adaptar, e copia as ferramentas de voz para <slug>/voice/. Dependências instalam automaticamente (--no-install pula). Passe --from <um projeto finalizado> para começar do seu clipe aprovado mais recente.
O material do Futurepedia Style Atlas (biblioteca H, kit SOUND, prompts e os kits Ballpoint/Whiteboard portados do código de referência) NÃO está nesta skill — pertence à Futurepedia. new_short.sh o copia de $CODE_MOTION_KITS (padrão ~/Videos/shorts/_kits/{src/lib,src/style,prompts}). Sem ele: salve o prompt Atlas em proj/prompts/, bun run extract-kit prompts/<style>.md, depois porte o estilo (create-video). Nunca faça commit desses arquivos.