Super-Video-Cut

O que Super-Video-Cut faz?

Posicionamento

Trate cada trabalho de edição como uma entrega de engenharia com cadeia de evidências, não uma pilha de clipes montados por intuição. Esta skill fornece medição objetiva reproduzível, avaliação itemizada e justificada, modelos de linha do tempo reutilizáveis, controle de qualidade (QC) pré-entrega e limites de direitos autorais que percorrem todo o processo.

references/ contém o material aprofundado, dividido por domínio de capacidade (cerca de 50 documentos, a maioria com tabelas de parâmetros e especificações de 100 a 250 linhas). Não leia tudo antecipadamente — siga o roteiro abaixo e leia apenas os 1 a 3 documentos que o estágio atual necessita.

Abreviação de volume usada em todo este arquivo: 09/02 significa references/09-material-memory/02-*.md.

Três linhas vermelhas

Violar qualquer uma delas impede a entrega.

1. Estilo de referência: avalie primeiro, corte depois. Quando o usuário fornecer um vídeo de referência, você deve completar a avaliação tridimensional (ofício de edição / som / cena) com uma justificativa itemizada para cada entrada e obter confirmação do usuário antes de tocar na linha do tempo. Produzir um corte sem essa confirmação conta como retrabalho.
2. Material: verifique o cache antes de recorrer a um modelo. Antes de analisar qualquer material de vídeo, execute material_cache.py lookup. Em caso de acerto, leia o cartão de descrição do material diretamente — chamar um modelo de vídeo para olhar novamente é proibido; apenas em caso de falha execute uma análise completa e registre-a.
3. Conformidade e QC em primeiro lugar. Não corte um plano cujo risco de direitos autorais seja indeterminado e não entregue um arquivo finalizado que qc_scan.sh não tenha aprovado. O volume jurídico é material de referência, não aconselhamento jurídico; para projetos comerciais ou de alto risco, informe ao usuário que revise com um advogado.

Fluxo de trabalho principal M0–M6

Estágio	Objetivo	Deve ler	Saída
M0 Ingestão	Fixar parâmetros executáveis	Este arquivo	Briefing
M1 Ingestão de material	Nunca pagar pelos mesmos tokens duas vezes	09/02 + scripts/material_cache.py	Cartão de material ou acerto de cache
M2 Avaliação de estilo	Transformar "um sentimento" em parâmetros	08/02 + 08/03 + scripts/reference_probe.sh	Folha de avaliação + impressão digital + conclusão de uma página
M3 Plano de edição	Impressão digital → linha do tempo	08/04 + o volume de gênero correspondente	Plano de segundo nível
M4 Produção	Corte / narração / legendas / correção de cor	01 / 02 / 03 conforme necessário	Corte bruto e projeto
M5 QC de entrega	Aprovação técnica + conformidade	06/01 + 06/02 + 06/03	Relatório de QC + logs de detecção
M6 Feedback	Produzir apenas candidatos, nunca alterar regras automaticamente	08/05	Registro de autoaperfeiçoamento

M0 Ingestão: pergunte por parâmetros ausentes, no máximo 3 perguntas

Você deve obter: plataforma e proporção de aspecto (determina área segura e duração), duração total, se é necessária narração/dublagem, se é comercial, especificação de entrega (resolução / bitrate / container).

Inferir e declarar qualquer coisa que possa ser inferida a partir do que você já tem; não interrogue o usuário item por item. Se o trabalho é comercial determina diretamente qual música e material você pode usar — se isso não estiver claro, você deve perguntar.

M1 Ingestão de material: a ação para cada um dos cinco estados é codificada

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # mantenha o cache dentro do projeto, nunca dentro do diretório da skill
python "$SK/scripts/material_cache.py" lookup "<caminho do material>"

Estado	Ação
HIT	Não chame um modelo de vídeo. Leia $MDC_HOME/cards/<MID>.yaml e faça apenas adaptação de tópico
MISS	Sonda E1 local → uma solicitação de análise completa usando references/09-material-memory/templates/model-analysis-prompt.md → preencha o cartão → validate → register
STALE	O material mudou; marque o cartão antigo como superseded e refaça como MISS
HIT_BLOCKED	Status de direitos não está claro; não use — resolva os direitos primeiro
Interruptor de segurança	Quando _config.json tiver cache_enabled=false, trate tudo como MISS; ignorá-lo é proibido

O cartão de descrição tem três camadas: L0 identidade (hash / especificações), L1 descrição do material (o que mostra / onde foi filmado / qual é o estilo / se é utilizável), L2 adaptação de tópico (quais segundos este tópico usa e qual função narrativa desempenham). "Funciona bem como abertura para o tópico X" pertence apenas ao L2 — colocá-lo no L1 contamina todos os outros tópicos.

O campo de localização é uma regra rígida: sem texto na tela, um ponto de referência ou um registro de filmagem, defina place_name: null. Nunca inferir uma cidade a partir de "há mar e uma palmeira".

M2 Avaliação de estilo: seis etapas sempre que o usuário fornecer um vídeo de referência

S1 verificação de conformidade → S2 sonda objetiva → S3 duas visualizações completas → S4 avaliação dimensão por dimensão
→ S5 conclusão de uma página → S6 ★portão de confirmação do usuário★

• S1 Analise apenas, nunca reutilize sua expressão. Títulos de abertura e encerramento, diálogo, música, texto cinético e encenação de tomadas são todos marcados como protected: expression.
• S2 Execute o script de sonda para números reproduzíveis (pontos de corte, durações de tomada, loudness, silêncio, estatísticas de cor, folhas de contato).
• S3 Assista a coisa toda duas vezes: uma vez apenas para imagem, uma vez apenas para som. Avançar rapidamente perde ritmo e pausas mantidas — este é o erro metodológico mais comum.
• S4 Avalie item por item nos três grupos centrais — A ofício de edição / B som / C cena (10 subitens cada) — mais D legendas, E narrativa, F contexto da plataforma, e G limite de conformidade (obrigatório).
• S5 Entregue uma conclusão de uma página: 3 características principais, 3 itens não transferíveis, confiança geral.
• S6 Entregue ao usuário para confirmação. Sem essa confirmação você não pode entrar no M3.

Cada entrada de avaliação deve preencher todas as cinco partes; uma parte ausente invalida a entrada inteira:

① Observação (timecode + fenômeno concreto) ② Base (ID da evidência) ③ Inferência (por que foi projetado assim) ④ Item de ação (como este corte a utiliza) ⑤ Confiança (alta/média/baixa + motivo)

Contraexemplo (nunca deve ser emitido): "A edição é suave e muito cinematográfica." — sem timecode, sem base, sem item de ação, nada executável.

Cada item de ação deve carregar uma tag de transferência: transferable: parameter (ritmo, duração, loudness, sequência de tamanho de plano — aprendível) ou protected: expression (planos específicos, diálogo, música, texto cinético — não reproduzível). Estilo e fórmula situam-se no reino das ideias e podem ser emprestados; expressão não pode ser copiada. Este é o piso de direitos autorais desta skill, não uma sugestão.

M3 Plano de edição: traduza a impressão digital em uma linha do tempo de segundo nível

Leia as regras de mapeamento em 08/04 e produza uma linha do tempo diretamente executável: ponto de entrada/saída para cada clipe, tamanho de plano, tipo de transição e duração em quadros, pontos de referência de efeito sonoro, pontos de entrada/saída de legenda e alvo de loudness.

Ordem de resolução de conflitos: solicitação explícita do usuário > limites duros da plataforma > características do vídeo de referência > estética padrão. Quando o material não puder suportar algo, diga claramente — "a referência usa técnica X; este projeto não tem material correspondente, então Y substitui" — em vez de forçar.

M4 Produção: leia exatamente um volume por ação atual

Fazendo	Leia
Ritmo, transições, eixo	01/01, 01/02
Organização do projeto, proxies, conform, entrega	01/03
Correção de cor, Log/LUT, HDR	01/04
Gravação de voz, entrega, ADR	02/01
Mixagem, loudness, EQ/compressão	02/02
Trilha sonora, efeitos sonoros, design de som	02/03
Voz de IA, TTS, SSML	02/04
Layout e duração de legendas	03/01
Formatos SRT/VTT/ASS/TTML	03/02
Transcrição, alinhamento, queima	03/03
Multilíngue, CC/SDH, acessibilidade	03/04
Como cortar um gênero específico	04/01–04/06

Âncoras de loudness (tabela alvo completa em 02/02): streaming em torno de −14 LUFS, podcast/Apple em torno de −16 LUFS, broadcast EBU R128 em −23 LUFS, com True Peak geralmente exigido em ≤ −1 dBTP. Consulte a documentação oficial da plataforma alvo; se não tiver certeza, meça primeiro, depois decida.

M5 QC de entrega: execute o script primeiro, depois julgue como humano

bash "$SK/scripts/qc_scan.sh" "<arquivo finalizado>" "<diretório de saída>"

Uma execução gera um JSON de especificações, integridade de decodificação, detecção de quadro preto/congelamento, silêncio, loudness e uma folha de contato. O script só pode encontrar anomalias técnicas — conteúdo e conformidade devem passar pelas tabelas manualmente:

• 06/01 lista de verificação de especificações técnicas (resolução / taxa de quadros / cor / bitrate / faixas de áudio / duração / nomenclatura)
• 06/02 revisão de conteúdo e conformidade (fatos, conteúdo sensível, alegações publicitárias proibidas, documentação de direitos)
• 06/03 modelos de preenchimento das Tabelas A–G (para o arquivo)

Gravidade do QC: bloqueante (quadros pretos, faixa de áudio ausente, loudness fora da tolerância, risco de violação) deve ser corrigido; itens de melhoria podem ser enviados após registro; itens de sugestão aguardam a próxima versão.

M6 Loop de feedback: um vídeo de sucesso nunca muda uma regra

Quando o feedback real chegar (taxa de conclusão, conversão, observações do cliente), faça a atribuição de erro conforme 08/05 e escreva em 08/case-library/<CASE-ID>/self-improvement-record.md.

Regra rígida: um único caso produz candidatos apenas; uma mudança entra em vigor somente após ≥5 amostras na mesma direção, um conjunto de regressão congelado, aprovação humana, versionamento e um lançamento canário. O mecanismo de autoaperfeiçoamento não deve reescrever automaticamente os campos objetivos E1/E2 de um cartão de descrição de material — o cache espalharia um erro por todos os tópicos posteriores, enquanto os registros de acerto ainda pareceriam perfeitamente normais.

Caminho mais curto após acionamento

O usuário diz	Faça isso
"Corte algo no estilo deste vídeo viral"	Fluxo completo M2 → portão de confirmação S6; não comece a cortar
"Edite este vídeo para mim"	M0 perguntar plataforma/duração/comercial → M1 material → M3 plano
"Este material é utilizável, o que mostra?"	M1 lookup; responda diretamente em HIT, analise apenas em MISS
"Adicione legendas"	03/01 layout + 03/03 transcrição e alinhamento; verifique velocidade de leitura e duração mínima
"A narração soa mal"	02/01 gravação → 02/02 cadeia de processamento → meça loudness
"Exporte para Douyin / WeChat Channels / Bilibili"	04/01 especificações da plataforma + 06/01 verificação de entrega
"Esta edição infringiria algo?"	05/02 árvore de decisão + dimensão G em 08/02; dê um nível de risco, não uma opinião jurídica conclusiva
"O corte finalizado está OK?"	qc_scan.sh + 06/01 / 06/02 item por item

Scripts

Script	Propósito	Dependências
scripts/material_cache.py	Impressão digital de material, consulta de cache, registro, reutilização, validação, estatísticas (8 subcomandos)	Python 3, sem pacotes de terceiros
scripts/reference_probe.sh	Sonda objetiva de um arquivo de referência ou material: pontos de corte, durações de tomada, loudness, silêncio, cor, folhas de contato	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	QC técnico de um arquivo finalizado: especificações, decodificação, quadros pretos, congelamentos, silêncio, loudness, folha de contato	bash + ffmpeg/ffprobe

Verifique o ambiente primeiro: ffmpeg -version && ffprobe -version && python --version. Sem ffmpeg, toda medição objetiva fica indisponível — nesse caso, diga claramente ao usuário que apenas a avaliação manual é possível e nenhuma métrica reproduzível pode ser fornecida. Nunca invente números.

Autoverificação pré-entrega

• A referência passou por S1–S6 e o usuário confirmou (se uma referência foi usada)
• Cada pedaço de material pode ser rastreado no cache até sua fonte e status de direitos
• Nenhuma frase sem suporte como "suave", "premium" ou "texturizado" aparece na avaliação ou no plano
• Loudness foi medida e está dentro da tolerância alvo; True Peak está abaixo do limite
• Legendas não ultrapassam a área segura, não contêm erros de digitação e atendem ao limite de velocidade de leitura
• qc_scan.sh não relata itens bloqueantes, e as Tabelas A–G estão preenchidas
• Documentação de direitos para música / fontes / semelhança / material de arquivo está completa, ou o nível de risco está declarado
• Nomenclatura do arquivo de entrega, container e bitrate correspondem aos requisitos da plataforma

Escopo do material (deve ser declarado ao usuário)

• O volume jurídico não é aconselhamento jurídico. Artigos e posições judiciais mudam; para projetos comerciais ou de alto risco, peça que um advogado revise e confie no texto oficial mais recente.
• Parâmetros de plataforma mudam. Duração, bitrate, área segura e alvos de loudness entram em conflito entre fontes, por isso são sempre marcados "sujeito à documentação oficial mais recente da plataforma" — faça upload e visualize para verificar antes da entrega.
• Os parâmetros de autoaperfeiçoamento não têm padrão da indústria. η, δ, N_min e o restante no volume 08 são valores iniciais próprios desta biblioteca; eles existem para tornar o processo executável, não porque são ótimos validados.
• Cerca de 190 itens "TO VERIFY" estão listados no corpo ou no final de cada documento, concentrados em references/00-overview/sources-and-reliability.md (com notas de evidência A/B/C/D e prioridades P0/P1/P2). Verifique a nota de evidência desse arquivo antes de citar algo.

Roteamento e índices

• references/INDEX.md — caminho mais curto e leitura mínima necessária por estágio ou tarefa
• references/00-overview/knowledge-map.md — mapeamento completo de domínios de capacidade e consulta rápida de solução de problemas
• references/00-overview/sources-and-reliability.md — notas de evidência, lista de fontes, itens TO VERIFY
• references/00-overview/manifest.csv — índice de arquivo legível por máquina

Ao pesquisar um arquivo grande, localize por palavra-chave em vez de lê-lo de ponta a ponta, por exemplo, grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md.