Treinamento em Vídeo: storyboard primeiro, depois o aplicativo real na tela
Um vídeo de treinamento aqui é um conjunto de cartões no formato de telefone. Cada cartão tem um título, uma linha de ajuda, um quadro-chave do aplicativo real com anotações e uma linha de narração. Alguns cartões reproduzem um pequeno clipe do aplicativo em vez de uma imagem estática. Os mesmos cartões são entregues como slides e um PDF.
Um arquivo controla tudo: storyboard.json. Dave o edita através de um canvas de design; todos os scripts de construção o leem.
Quando usar
Use para:
- Um vídeo de treinamento, início rápido, guia rápido ou tutorial que mostra o aplicativo
- Capturas de tela anotadas ou um guia de slides para técnicos, consultores ou pessoal de peças
- Uma revisão de um vídeo feito com esta skill (novo texto, novo cartão, novo clipe)
Não use para:
- Vídeo de marketing ou promocional (tom diferente, regras diferentes; pergunte ao Dave)
- Vídeos de inspeção de cliente gravados dentro do produto
- Uma maquete de uma tela que ainda não existe (use
/visual)
Princípios
- Storyboard antes da produção. Nada é narrado ou montado até que Dave tenha editado o canvas do storyboard e dito que está pronto.
- Mostre o aplicativo real, fazendo a coisa real. Escaneamento real, ditado real, história gerada real. Nunca uma tela simulada, nunca resultados digitados.
- Dave decide no canvas, não no chat. Leia o canvas de volta e faça um diff. Não reconstrua sua direção a partir da conversa.
- Uma tomada aprovada é mantida. A narração é regerada apenas para linhas cujas palavras mudaram. Nunca sobrescreva uma versão que Dave revisou; envie
-v2,-v3. - Claude não pode ouvir nem assistir. Diga isso em cada devolução. Prove as palavras pela transcrição e as imagens por quadros de amostra, e nomeie o que não foi verificado.
- Deixe a loja como foi encontrada. Modo restaurado e confirmado, ordens de reparo de retomada fechadas.
Leia primeiro
/Users/davidsonders/ro-bot/shared/product-facts.mdeshared/brand.md: nomes, contagens, palavras proibidas. Sem travessões, sem emojis, "TenthGear" como uma palavra. Nunca diga "single player" ou "multi-player" em nada que um espectador veja ou ouça.reference.mdnesta pasta: as armadilhas técnicas, cada uma já paga uma vez.- Notas de memória no canvas de design:
reference_design_canvas_mechanics,reference_design_canvas_roundtrip,reference_design_canvas_entity_crash.
Onde as coisas ficam
| O que | Onde |
|---|---|
| Pasta do projeto de um vídeo | /Users/davidsonders/ro-bot/training-videos/<slug>/ (nunca a área de rascunho da sessão, que morre com a sessão) |
| A única fonte da verdade | <project>/storyboard.json |
| Quadros-chave, clipes, narração | <project>/frames/, footage/, narration/ |
| Compilações | <project>/out/ |
| O que Dave recebe | ~/Desktop/<Title>/ |
| Exemplo prático | training-videos/story-writer-getting-started/ e examples/story-writer/ aqui |
Scripts estão em scripts/ aqui. Eles recebem a pasta do projeto como primeiro argumento.
Fluxo de trabalho
Faça uma lista de tarefas para estas etapas e trabalhe nelas em ordem.
Etapa 0: Definir o briefing
Encontre estes itens na solicitação. Pergunte apenas o que está faltando, uma pergunta, recomendação primeiro.
| Decidir | Padrão |
|---|---|
| Quem assiste, e em qual função | Técnico |
| Telefone ou desktop | Telefone, 390 x 844 |
| Qual fluxo, do início ao fim | Esboço do Dave |
| Loja e modo de fluxo de trabalho | Pergunte ao Dave. Veja Etapa 2. |
| Apenas imagens estáticas, ou estáticas mais clipes | Clipes onde a tela se move: gravação, carregamento, abrir e fechar |
| Duração | Abaixo de 2:30 |
Etapa 1: Storyboard em um canvas de design
Esta é a primeira coisa que Dave vê e o lugar onde ele edita o roteiro e as anotações.
-
Crie a pasta do projeto e renderize quaisquer adereços (
props/render-paper.mjsfaz a ordem de reparo de papel de amostra). -
Explore o fluxo em busca de quadros-chave. Quadros-chave vêm do aplicativo real, então esta etapa precisa de uma execução de captura (Etapa 2 e Etapa 3, apenas estáticas). Copie
examples/story-writer/capture-stills.mjspara o projeto e reescreva o fluxo. Olhe para cada quadro antes de continuar. -
Rascunhe
storyboard.json. Um cartão por coisa que o espectador faz. Forma:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "Toque em [[Write Story]]", "body": "O escritor de IA revisará suas anotações e escreverá 3Cs para você.", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "O que o clipe mostra" }, "narration": "Quando estiver pronto, toque em Write Story." }boxesearrowestão em pixels do telefone; a captura escreve a caixa de cada controle ao lado de seu quadro.[[Label]]desenha um chip de botão. Siga as regras de estilo abaixo desde o primeiro rascunho. -
Crie o canvas. Ferramenta de artefato:
quickstartcom intençãodesign, depois publique com atype_urlque ele retorna e um título. Salve a url em<project>/storyboard/artifact.json. -
Carregue os quadros-chave para o canvas como ativos (JPEG, 1688 px de altura, preparados na área de rascunho para que vão em uma chamada). Registre cada url
/_blob/...retornada sobassetsemartifact.json, indexada pelo nome do quadro. -
Gere e publique.
node scripts/storyboard-canvas.mjs <project>escrevestoryboard/project/. Copie essa pasta para a área de rascunho e publique-a:canvas.jsoncomofile_path, cada.dc.htmlemfiles. -
Entregue o link para Dave e pare. Diga a ele: redigite quaisquer palavras em um cartão, a nota azul abaixo de cada cartão é a faixa de voz, arraste as anotações amarelas, escreva qualquer outra coisa em uma nota. Não comece a produção.
-
Colha as edições dele. Artifact
readcompaths(o índice e cada prancheta) e umout_dir, depoisnode scripts/storyboard-harvest.mjs <project> <out_dir>. Leia o relatório para ele em palavras simples, aja sobre quaisquer notas que ele adicionou, depois execute novamente com--write. -
Mais uma rodada? Leia
project/canvas.jsonde volta, regenere com--live <esse arquivo>, republique. Uma publicação que não começa do índice ao vivo é recusada.
Etapa 2: Pegue uma loja emprestada
O aplicativo deve estar no modo que o vídeo mostra. Apenas lojas de teste podem ser usadas.
| Loja | Id | Modo normal | Notas |
|---|---|---|---|
| Summit Auto Group (demo) | demo-dealership | fluxo de trabalho em equipe | Demonstração de prospecção do Dave. Logins [email protected] (técnico), marcus@ (consultor), priya@ (peças). Usado para o primeiro vídeo. |
| Test Dealership 1 | mlTaPo12wbpUtJB9GXJM | fluxo de trabalho em equipe | Compartilhado com sessões de construção. Frequentemente ocupado. |
ListAgents, depoisSendMessagepara cada par: está usando a loja e precisa do modo? Aguarde a resposta. Se um par precisar, use a outra loja ou pergunte ao Dave.- Leia o modo primeiro:
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>da pasta do aplicativo. - Altere-o apenas pelos minutos que uma captura leva, na mesma cadeia de comandos da captura e da restauração. Depois leia novamente e confirme.
- Nunca toque em uma loja de cliente. Nunca altere as preferências de uma conta de teste.
Etapa 3: Captura
- Imagens estáticas:
dpr: 3. Um quadro por cartão, tirado após a tela ter estabilizado. - Clipes:
dpr: 2comvt.recorder. Abra cada clipe com uma batida de quietude, mostre o marcador de dedo, depois aja. Leiamarks.jsonpara escolherfootage.runs. - Ditado é real.
vt.dictationreproduz um clipe de fala em um microfone falso; o aplicativo grava e transcreve. Imprima cada transcrição e leia-a: o transcritor reescreve números e nomes de marca. - Uma retomada precisa de uma ordem de reparo nova. Numere-as para cima e liste cada id em
created-ros.txt.
Etapa 4: Slides
node scripts/build-slides.mjs <project> escreve out/slides/*.png, o PDF e as camadas que o vídeo precisa. Olhe para uma folha de contato de cada cartão. Verifique se nenhuma anotação cobre a coisa que ela aponta.
Etapa 5: Narração
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
Voz ash, modelo gpt-audio-1.5 (movido de gpt-4o-mini-tts, que a OpenAI desliga em 2027-01-06). Uma tomada cuja transcrição não corresponde às palavras do cartão é repetida, depois recusada. Dave aprovou esta voz e rejeitou as vozes integradas do Mac como robóticas. Usa a chave OpenAI do aplicativo e custa alguns centavos por compilação: diga isso no briefing de cada novo vídeo, para que o gasto nunca seja uma surpresa. DRY=1 lista o que seria regerado.
Escreva a narração para o ouvido: "R O", "três Cs", "tenthgear ponto A I". Anuncie cada parte em seu primeiro cartão.
Etapa 6: Vídeo
node scripts/build-video.mjs <project>. A velocidade é 1.25 ("Rápido" do QuickTime), o ritmo que Dave aprovou. Um cartão com um clipe dura o máximo entre sua narração e seu clipe.
Etapa 7: Verificar e dizer o que não foi verificado
check-audio.mjstranscreve o vídeo e pontua cada cartão. Leia cada linhaLOOK.- Puxe um quadro de cada cartão que tenha um clipe ou uma seta e olhe para ele.
- Na devolução, declare claramente: não ouvido, não assistido do início ao fim.
Etapa 8: Entregar
Copie o vídeo, o PDF e out/slides/ para ~/Desktop/<Title>/. Mantenha versões anteriores. Dê a duração, o que mudou e qualquer coisa que Dave possa notar (um número de ordem de reparo diferente em um clipe, uma anotação sobreposta à filmagem).
Etapa 9: Limpeza
- Modo da loja restaurado, depois lido de volta e confirmado.
node scripts/close-ros.mjs <project> <email> <org-id>fecha as retomadas. Excluir ordens de reparo é decisão do Dave.- Informe a qualquer par que você tenha mensagem que a loja está livre.
Regras de estilo (Dave, 2026-09-29)
| Regra | Exemplo |
|---|---|
| Um botão que o espectador toca é desenhado como um botão | Toque em [[New RO]] |
| Cabeçalhos de parte são curtos, sem "de 3" | PARTE 2: HISTÓRIA DE GARANTIA |
| A capa não tem contagem de etapas | |
| Um cartão por etapa. Mescle cartões que mostram uma decisão. | Revisar e salvar são um cartão |
| Descarte um cartão cujo ponto é autoevidente | Lendo Causa e Correção |
| Diga quem age e com o quê | "Adicione uma nota de voz", não "Adicione uma nota" |
| Quando duas coisas na tela podem ser significadas, aponte para a que importa | Seta no botão verde |
| Qualquer coisa que se mova no aplicativo deve se mover no vídeo | Forma de onda, spinner, cartão abrindo |
| Palavras de chão de fábrica | RO, linha, história, 3Cs, CP |
Dave dá edições de slide pelo número da página do PDF. Página 1 é a capa, então "pg 7" é etapa 6. Reafirme cada edição pelo nome da etapa antes de aplicá-la.
Critérios de sucesso
- Dave editou o canvas do storyboard e suas edições foram colhidas, não adivinhadas
- Cada quadro e clipe é o aplicativo real, no modo sobre o qual o vídeo trata
- Slides, PDF e vídeo vêm todos do mesmo
storyboard.json - Narração verificada por transcrição; linhas pouco claras nomeadas
- A devolução diz o que não foi ouvido ou assistido
- Modo da loja restaurado e confirmado; ordens de reparo de retomada fechadas
- Pasta do projeto mantida fora da área de rascunho
Skills relacionadas
/visualpara maquetes de telas que ainda não existem/app-testingpara as contas de teste e a estrutura de teste ao vivo que esta skill empresta/compounddepois, se uma captura expôs um bug do produto ou uma nova armadilha