alexey1312/Vibe-Editing-Agent-Skill

Vibe editing: o corte

Transforme takes brutos em um corte que mantenha o significado, depois entregue ao motor para os gráficos. O agente propõe e escreve; o renderizador calcula os quadros; o autor decide e aceita. Aprove a história antes do design: toda mudança de significado depois dos gráficos força uma reconstrução.

• Rotas e ferramentas por material: references/routes.md
• A EDL e os dois relógios: references/edl-format.md
• Transcrições e reconhecedores: references/transcripts.md
• Cortando fala: references/cutting.md
• Legendas: references/captions.md
• Som: references/audio.md
• Inserções, layouts, 9:16, outros idiomas: references/inserts-and-layouts.md
• Gravações de tela: references/screen-recordings.md
• Pasta, brief e project.md: references/project-memory.md
• Notas que o autor fornece: references/edit-requests.md
• Dados, licenças e dinheiro: references/data-and-licences.md
• Formato do plano: references/plan-format.md
• O que este repositório mediu: references/measured-behavior.md
• Versões e datas: references/versions.md
• Citações: references/sources.md

Contrato

• A Fase 1 é somente leitura. O relatório do toolchain, o inventário de mídia, a leitura de transcrições existentes, e a escrita do plano não alteram nada e não enviam nada para lugar nenhum.
• Nenhum corte, render, upload, instalação ou chamada paga sem aprovação dos IDs dos itens (references/plan-format.md). "Deixe mais curto" antes de existir um plano é um pedido pelo plano.
• Os originais nunca são alterados. Cópias de trabalho vão para work/, renders para renders/, entregas para exports/. edl.py render se recusa a sobrescrever uma fonte ou um arquivo existente sem --force.
• Dois relógios. Tempo de origem para takes, tempo de saída para tudo que o espectador vê; converta com edl.py map e edl.py retime, nunca manualmente.
• Cite ou rotule. Uma afirmação sobre uma ferramenta cita references/sources.md ou uma seção Measured; versões e preços vêm de references/versions.md com sua data; um julgamento de gosto ou significado é rotulado como tal.
• Relate a verificação honestamente. Uma verificação de quadro perde o ritmo; um script perde o significado. Diga o que foi assistido, ouvido, escaneado — e o que não foi.

1. Pré-voo

python3 scripts/toolchain_report.py --format markdown
python3 scripts/media_probe.py originals/ --format markdown

• O relatório do toolchain diz o que esta máquina pode fazer: renders precisos por quadro, queima de legendas (muitas builds do FFmpeg não conseguem, Measured M7), medição de loudness, reconhecimento de fala local, HyperFrames, Remotion; e quais nomes de chaves de API estão definidos (nunca seus valores).
• O inventário sinaliza o que muda o corte: framerate variável (MED001), rotação (MED002), HDR (MED010), framerates ou formatos de áudio mistos (MED004, MED005); regras em CHECKS.md neste repositório da skill.
• Leia as instruções próprias do projeto e project.md se existirem.
• Escreva o brief, ou pergunte o que lhe falta: espectador e mensagem, entrega, obrigatório, proibido, nuvem (references/project-memory.md).

2. Rota

Escolha a rota a partir do material e da entrega (references/routes.md). Esta skill é dona do corte: takes, junções, a EDL, o render, legendas e som na nova linha do tempo. Os gráficos pertencem às skills do motor: HyperFrames (hyperframes, general-video, hyperframes-core) ou Remotion (remotion-best-practices). Legendas ou sobreposições em filmagens que não devem mudar pertencem a embedded-captions ou talking-head-recut.

3. Transcrições

• Timestamps de palavras por fonte, feitos uma vez, mantidos em transcripts/ (references/transcripts.md).
• O reconhecimento na nuvem envia áudio para fora e custa dinheiro; o reconhecimento local precisa de instalação. Ambos aguardam aprovação, com o provedor, o custo e os dados nomeados no plano.
• Corrija nomes e números contra um glossário antes de planejar qualquer corte.

4. Planeje a história

1. Tabela do material: fonte, in–out, frase literal, som, o que é visível, possível função.
2. Três aberturas, cada uma com o que o espectador entende nos primeiros segundos.
3. Candidatos: python3 scripts/edl.py candidates --words transcripts/<take>.json — pausas, repetições e vícios de linguagem a considerar, nunca cortar automaticamente (references/cutting.md).
4. A história em batidas, depois edit/edl.json: cada clipe com um motivo (references/edl-format.md).
5. python3 scripts/edl.py check edit/edl.json --probe, table e cuts --probe: os clipes com ambos os relógios, e cada intervalo removido para o autor ler.
6. Cortes duvidosos vão para edit/edl_b.json, não para a versão A.

5. Renderize o rascunho

python3 scripts/edl.py render edit/edl.json -o renders/draft_v1.mp4 --size 640x360 --preset veryfast

• Cada clipe é re-encodado nos limites do quadro, com fades de áudio de 10 ms, redimensionado para um tamanho (Measured M1, M3, M4). Um corte stream-copy nunca é exato por quadro (Measured M2).
• O primeiro rascunho não tem música, legendas ou efeitos: apenas fala e imagem.
• Ouça cada junção com fones de ouvido; olhe os quadros de cada lado. Corrija com notas estreitas (references/edit-requests.md) e uma nova versão da EDL.

6. Legendas, som, inserções

• Legendas: edl.py retime move os tempos das palavras para a linha do tempo de saída; captions.py build os agrupa; captions.py check aplica os limites (references/captions.md).
• Som: fala primeiro, depois música com ducking, depois efeitos; meça a loudness contra o alvo do brief e defina os alvos loudnorm explicitamente (references/audio.md).
• Inserções: marque-as na linha do tempo de saída (edl.py map), aprove um quadro estático, depois construa-as no motor; edl.py hyperframes e edl.py remotion entregam o corte (references/inserts-and-layouts.md).
• Outros formatos: uma versão 9:16 é um novo layout, não um corte central.

7. Entrega

• Execute a revisão antes de considerar o vídeo finalizado: a skill vibe-editing-review, ou pelo menos python3 scripts/qa_scan.py com o brief, a EDL e as legendas.
• Atualize project.md: versão da EDL aprovada, último render bom, comandos, ativos e licenças, defeitos em aberto.

Fluxo de trabalho

Fase 1 — Recomendar

1. Pré-voo: relatório do toolchain, inventário, brief, instruções do projeto.
2. Plano com references/plan-format.md: fontes e conversões; a história e EDL v1; intervalos removidos; cortes duvidosos; legendas, som e inserções; dados, dinheiro e licenças; o que não pode ser verificado aqui.
3. Pergunte quais IDs de itens aplicar.

Fase 2 — Aplicar e verificar

1. Aplique apenas os itens aprovados, um nível de cada vez: história, ritmo, texto, imagem, som.
2. Após cada mudança, renderize ou pré-visualize o mesmo intervalo com um segundo de contexto, e ouça.
3. Re-execute edl.py check e captions.py check; execute qa_scan.py em cada rascunho que vá para o autor.
4. Atualize os status dos itens e project.md; relate o que não foi verificado.

Barreiras de proteção

• Não corte, renderize, faça upload, transcreva na nuvem ou instale nada na Fase 1.
• Não altere ou re-encode arquivos em originals/.
• Não faça stream-copy de um corte que deve ser exato por quadro.
• Não posicione legendas ou inserções pelo tempo de origem.
• Não remova todas as pausas com um único limiar, nem sintetize uma palavra ausente sem a decisão do autor.
• Não imprima uma chave ou um token no chat, em um log ou em um arquivo.
• Não adicione música, fontes ou filmagens sem uma fonte e licença registradas.
• Não tome o lugar do motor: o código de composição pertence às skills HyperFrames ou Remotion.