Communitygithub.com

Revisão e Entrega

O ciclo que transforma um filme pronto em um filme entregue. Analise quadros, meça o som, execute verificações, mostre rascunhos e amostras para a pessoa, aja com base no feedback, renderize o mestre, verifique o arquivo final, escreva o registro do projeto e reporte. Use após qualquer construção ou alteração, antes de cada renderização e sempre que chegar feedback.

O que é Revisão e Entrega?

Esta skill define o processo completo de revisão e entrega de filmes, desde a verificação de quadros individuais até a entrega final do arquivo. Ela é útil para desenvolvedores e editores que precisam garantir a qualidade e consistência de filmes gerados ou editados, minimizando retrabalho. A skill suporta o uso de ferramentas como `hyperframes`, `ffmpeg` e scripts auxiliares, e pode ser aplicada em projetos onde o filme é construído a partir de código ou ativos gerenciados. O fluxo de trabalho é iterativo: após cada alteração, são tirados snapshots para inspeção visual, seguidos de renderizações de rascunho de baixa qualidade para verificação de áudio e vídeo. O feedback do cliente é tratado de forma prática, transformando opiniões em ações concretas. Por fim, um mestre é renderizado em alta qualidade, verificado com ferramentas como `ffprobe` e scripts de análise, e o projeto é documentado em arquivos como `SCRIPT.md`, `SPEC.md`, `CREDITS.md` e `REVIEW.md`. A skill enfatiza a comunicação clara e a organização, evitando trabalho desnecessário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Revisão e Entrega faz?

1. O ciclo após cada alteração

  1. npx hyperframes lint. Zero erros.
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... nos momentos que você alterou, mais um antes e um depois. Abra a folha de contato e realmente a leia: cada cartão está completo, algum rosto está coberto, algum texto sai da sua caixa, algo está meio desenhado que deveria estar completo?
  3. Corrija e repita até que os quadros estejam corretos.
  4. npx hyperframes check --json (ou scripts/check.sh com filmagem 4K). Corrija os erros. Leia os avisos uma vez e decida: corrija, ou mantenha e explique o porquê em REVIEW.md. Avisos que valem a pena agir: nada mudando por mais de três segundos, um primeiro quadro vazio, texto saindo de um contêiner.

Snapshots são baratos; renderizações não são. Faça toda a verificação que puder antes de renderizar.

2. Rascunhos

Um rascunho é o filme inteiro em baixa qualidade: npx hyperframes render --quality draft -o renders/draft-01.mp4, um a três minutos para um filme de 100 segundos em 1080p. Então:

  • Faça uma folha do arquivo renderizado (scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5) e leia-a. Ela mostra o filme como codificado, incluindo filmagens, o que os snapshots podem errar.
  • Meça o volume: ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -.
  • Meça o nível a cada dois segundos (scripts/levels.py draft.mp4 2) e compare com o plano: a parte silenciosa está silenciosa, a elevação chega onde o produto aparece?

Dê à pessoa o rascunho com uma breve nota sobre o que há nele e no que você quer que ela preste atenção visual e auditiva. O primeiro rascunho existe para ser corrigido; entregue-o cedo em vez de polido.

3. Mostrando opções

Quando a questão é uma aparência (um estilo de destaque, uma fonte, um layout, uma cor), mostre imagens estáticas, não renderizações.

  • Construa cada opção, tire snapshot dos mesmos três ou quatro momentos e salve as folhas de contato lado a lado com nomes simples (A-underline.jpg, B-band.jpg).
  • Diga em uma linha cada o que A e B são, e qual você escolheria e por quê.
  • Aguarde a resposta apenas sobre este ponto; continue trabalhando em tudo que não depende dele.

Quando as palavras deles podem significar duas coisas, é assim que você descobre. Isso custa um minuto. Uma renderização completa errada custa dez e a paciência deles.

4. Agindo sobre o feedback

O feedback chega curto, informal e às vezes irritado. Lide com ele assim:

  • Reformule como uma ação antes de agir, em uma linha: "Foto de Singapura: mesma letra pequena que as outras, no problema e no final."
  • Aplique onde quer que se aplique. Se um elemento estava errado, seus equivalentes em outras partes do filme estão errados da mesma forma.
  • Aceite o gosto como dado. "Lento", "chato", "parece barato", "muito grosso": mude; não o defenda. Se você discordar em um ponto factual (isso esconderia um rosto, uma afirmação seria falsa), diga uma vez, com o motivo.
  • Notas comuns e o que significam:
Eles dizemFaça
lento, sonolento, chatocortes mais curtos, voz mais rápida, corte linhas, música mais enérgica; não mais efeitos
não parece real, parece IAfilmagens reais de pessoas reais; menos gráficos inventados
parece clipes de banco de imagens coladosuma única gradação em tudo; pessoas recorrentes; cartões consistentes
não consigo me conectar com issonomes, cargos, desejos específicos; o problema nas palavras deles
o som é plano, monótonopontue por humor; silêncio antes da elevação
torne isso cativantereescreva o gancho e a linha de resumo; adicione um retorno
este é diferente dos outrosfaça-o corresponder exatamente aos seus irmãos
mais atenção a estas palavrasuma marca de ênfase por linha, mostrada primeiro como imagens estáticas
  • Várias mensagens de uma vez: lide com cada uma; diga em uma linha como. Uma mensagem posterior substitui uma anterior.
  • Registre as decisões em REVIEW.md e na memória: o que eles escolheram, o que rejeitaram, nas palavras deles.

5. A renderização mestre

Quando o rascunho for aprovado ou as alterações restantes forem pequenas:

  1. Verifique o espaço livre em disco. Uma renderização 4K precisa de cerca de 11 GB de espaço temporário por 100 segundos.
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<name>-4k.mp4, em segundo plano. Adicione --gpu se eles quiserem velocidade ou pediram; diga o que custa (cerca de metade da taxa de bits).
  3. Se perguntarem quanto tempo falta, leia o progresso da renderização e responda com um número.

Nomeie versões de forma simples (-v2, -v3). Quando uma versão for rejeitada, delete-a para que ninguém a abra por engano.

6. Verifique o arquivo final

Faça isso no arquivo que você está prestes a entregar, não no projeto.

  • ffprobe: resolução, taxa de quadros, duração, tamanho.
  • Uma folha de todo o arquivo: cada seção presente, nenhum trecho em branco ou congelado, o último quadro correto.
  • Um recorte em tamanho real de texto e de um rosto: tipo nítido, filmagem sem blocos.
  • Volume: cerca de -16 LUFS integrado, pico verdadeiro em ou abaixo de -1 dBFS.
  • O código QR decodificado de um quadro tardio (scripts/scan.py): o link exato, em tamanho real e metade.
  • O endereço no cartão final responde quando solicitado.

7. O registro do projeto

Atualize os quatro arquivos antes de reportar. templates/ tem cada um como um esqueleto.

  • SCRIPT.md: a tabela do roteiro (tempo, imagem, voz), as pessoas, de onde vem cada linha, os números.
  • SPEC.md: objetivo, saída, plano de tempo e som, aparência, tipo, movimento, a lista de tomadas com quadros, uma lista de QA.
  • CREDITS.md: cada fonte e sua licença.
  • REVIEW.md: decisões tomadas; medido, olhado, não verificado; decisões em aberto; tomadas mais fracas; avisos mantidos de propósito; como alterar o filme (qual arquivo, qual comando).

8. A mensagem de entrega

Curta, nesta ordem:

  1. O arquivo: caminho, resolução, duração, tamanho.
  2. O que mudou desde a última versão, como uma lista curta.
  3. O que você verificou e como; o que você não verificou (você nunca ouviu isso).
  4. O que precisa da decisão deles, mais importante primeiro: coisas que não estão ao vivo no produto, qualquer coisa na tela que a empresa possa não querer mostrada, licenças para confirmar, pronúncias para ouvir.

Sem adjetivos sobre seu próprio trabalho. Se algo falhou ou está faltando, essa é a primeira linha.

9. Limpeza

  • Mantenha os downloads de origem e manifestos dos quais o filme é cortado; exclua candidatos que você não usou, rascunhos antigos e caches quando o espaço estiver curto ou quando solicitado. Olhe para o que você está prestes a excluir; exclua apenas o que você fez.
  • Nunca faça commit ou push no repositório deles a menos que solicitado.
  • Mantenha scripts geradores e scripts auxiliares no projeto, não em uma pasta temporária que uma reinicialização limpa.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas