100x-video-reverse

100X Video Reverse v2.3

Converte vídeos de referência em um pacote reverso padrão que pode ser diretamente revisado pelo usuário e consumido por Skills de geração downstream. Por padrão, apenas analisa e valida, não chama geração paga, não faz upload do vídeo original nem publica materiais.

Antes de começar

1. Confirme a legibilidade dos vídeos fornecidos pelo usuário e os limites de autorização. Quando o usuário não especificar um diretório de saída, use diretamente outputs/100x-video-reverse/<video-stem>-<timestamp>/ no workspace atual; não faça perguntas adicionais sobre o diretório. Sempre leia apenas os arquivos de origem e produza saída em um novo diretório independente.
2. Sempre leia workflow.md, output-contract.md e native-output.md. Leia analysis-prompt.md apenas ao realizar análise de modelos. Leia failure-gates.md ao lidar com cópias comerciais, edição densa, upload externo ou preparação para a fase de geração. Leia golden-baseline.md apenas ao avaliar, substituir ou atualizar esta Skill. A entrega padrão é gerada deterministicamente pelo scripts/digest.py a partir do pacote de máquina; o agente não reorganiza segmentos manualmente.
3. Verifique ffmpeg, ffprobe, Python jsonschema e permissões de leitura/escrita local. O validador deve parar completamente se jsonschema estiver faltando; instale dependências apenas em ambiente isolado, não globalmente. Antes de chamar qualquer modelo externo, verifique em tempo real a lista oficial de modelos e suas limitações de entrada; priorize o modelo especificado pelo usuário. Se a verificação não for possível, pare as chamadas externas, mas continue a construir o pacote de evidências local.

Fluxo de execução

1. Use scripts/prepare_evidence.py para estabelecer impressão digital do arquivo de origem, especificações, proposta de pontos de corte com duplo limite, quadros densos e trilha de áudio independente. Os pontos de corte automáticos são apenas sinais de diagnóstico, não limites reais de cena.
2. Visualize simultaneamente o vídeo completo e o pacote de evidências. Priorize a capacidade de compreensão de mídia local já disponível no agente atual, não exija que o usuário configure APIs adicionais. Apenas quando a tarefa atual tiver autorização explícita para análise semântica externa, pode-se usar o Google gemini-3.7-flash conforme o golden sample. Antes de chamar, verifique a ID real e a capacidade de entrada de vídeo a partir da lista oficial de modelos. Se não estiver disponível, mantenha o erro original e pare a fase externa, não troque silenciosamente por um modelo antigo. Corrija a linha do tempo das cenas conforme references/analysis-prompt.md, distinguindo fatos observáveis, inferências e desconhecidos; não use intervalos fixos para substituir cortes semânticos.
3. Estabeleça IDs de ativos estáveis e pontos de ancoragem de consistência entre cenas, cobrindo pessoas, produtos, cenários, adereços, vestuário, áudio e texto. Marcas, preços, alegações de eficácia, falas e texto na tela que não estejam claramente visíveis ou audíveis não devem ser preenchidos.
4. Gere o reverse.json completo: cenas, quatro tipos de quadros-chave, referências de ativos, áudio/legendas, prompts genéricos, prompts adaptados a modelos, esquema de segmentação, instruções de composição e must_not_change. Cada segmento também deve conter um execution_plan: duração alvo, status de geração, modelo selecionado, método de geração e materiais de entrada. Se a capacidade do modelo não tiver sido verificada em tempo real, escreva explicitamente needs_model_selection, não finja que é executável.
5. Use scripts/materialize_reverse_media.py para materializar quadros de cena e capturas de ativos em caminhos relativos dentro do pacote, e gere materialization_manifest.json. Mídia existente só pode ser reutilizada se o SHA-256 da origem, o timestamp da solicitação e o SHA-256 do arquivo corresponderem completamente ao provenance; caso contrário, pare e não sobrescreva.
6. Use scripts/validate_reverse_package.py para pré-verificação de mídia e contrato. Erros graves devem ser corrigidos antes de prosseguir; avisos devem ser mantidos e explicados, não transformados em aprovação.
7. Após validação rigorosa aprovada, execute scripts/digest.py e entregue conforme native-output.md exatamente como está. Codex use --format fragment --fragment-dir <thread-visualization-dir>: a primeira aba é um player estreito 9:16 à esquerda + painel de materiais de segmento à direita, cada segmento exibe fixamente o primeiro quadro / quadro de destaque / último quadro no mesmo grupo; imagens podem ser arrastadas para visualização JPEG; para a imagem original, copie o caminho do quadro original no pacote. "Localização de cena" mantém a vinculação cena por cena; clicar em qualquer trio de quadros ou cena pausa e localiza o vídeo, primeiro exibe instruções de operação em chinês, depois o prompt de geração em inglês do segmento correspondente. Tela estreita muda para layout superior-inferior, mas os três quadros ainda estão no mesmo grupo. Outros clientes usam --format md por padrão; se não for possível determinar a capacidade do cliente, não arrisque protocolo inline.

Quando o usuário fornecer feedback de visualização, mapeie cada feedback para cenas, ativos ou campos de prompt específicos, e marque explicitamente como "Preferência/Correção do usuário", não reescreva como fato observado do vídeo de origem. Crie um novo pacote de revisão, modificando apenas os campos e mídia afetados, depois valide completamente; não sobrescreva a versão anterior.

Comandos

python <skill-root>\scripts\prepare_evidence.py --video <source.mp4> --out <new-package-dir>
python <skill-root>\scripts\materialize_reverse_media.py --video <source.mp4> --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json
python <skill-root>\scripts\validate_reverse_package.py --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json --require-media --report <new-package-dir>\validation.json
python <skill-root>\scripts\digest.py --package <new-package-dir> --format md
# Para Codex inline; para múltiplos pacotes, use --out-root, que gera automaticamente 1 visão geral do lote + N detalhes independentes
python <skill-root>\scripts\digest.py --out-root <batch-root> --format fragment --fragment-dir <thread-visualization-dir>

<new-package-dir> deve não existir ou estar vazio. Não use --out para apontar para o diretório do vídeo de origem.

Limites intransponíveis

• A aprovação do pacote reverso na validação apenas indica que a estrutura, evidências e referências são executáveis; não significa que a similaridade visual do vídeo final é satisfatória.
• Não gere, retente geração, faça pós-produção ou pontuação dentro desta Skill. Elas devem ser consumidas por Skills independentes que seguem este contrato de saída.
• A resposta nativa do agente é apenas uma camada de apresentação do reverse.json e da mídia no pacote; não é uma segunda fonte de verdade de negócio. Qualquer revisão deve primeiro modificar o pacote de máquina, depois atualizar a resposta atual.
• Clicar em uma cena exibe o prompt do segmento de geração ao qual essa cena pertence; a unidade de geração no contrato de máquina é o segmento, não é permitido fingir que existem prompts independentes por cena.
• Use chinês para tags operacionais, status, categorias de ativos e métodos de geração visíveis por padrão; mantenha os valores originais para IDs de modelo, IDs de material, evidências textuais e prompts de geração em inglês. Se campos legíveis por humanos em pacotes históricos estiverem em inglês, apenas avise e mantenha o texto original, não permita que o digest falsifique traduções.
• Não escreva "fatias fixas de 10 segundos" como verdade de cena devido a limitações atuais do fornecedor. Priorize a segmentação com base em cenas reais e limites narrativos; os 10 segundos do validador são apenas um aviso de compatibilidade configurável downstream.
• Não faça upload de vídeos locais para URLs públicas, armazenamento de objetos ou serviços de terceiros sem autorização explícita.
• Não copie código candidato com licença desconhecida ou propósito contrário; absorva apenas métodos e experiências de falha verificados pelo mesmo golden sample.

Critérios de conclusão

Ao concluir, devem existir: source_manifest.json, evidence/evidence_manifest.json, mídia de evidência, reverse.json, materialization_manifest.json e validation.json; a validação rigorosa de mídia deve ter zero erros graves. A primeira aba do fragmento do Codex deve exibir uma prévia de duração completa; na área de trabalho, use o layout de coluna estreita do player + painel largo de materiais de segmento, cada segmento fixamente com três slots (primeiro/destaque/último) mantidos no mesmo grupo; slots de material ausente mostram erro. Arrastar os três quadros deve produzir pelo menos um arquivo JPEG utilizável; a imagem original é obtida copiando o caminho do quadro no pacote. Clicar nos três quadros ou na cena deve localizar e exibir o prompt do segmento correspondente. A camada operacional padrão usa chinês; prompts em inglês são expandidos conforme necessário; os cinco blocos restantes são expandidos posteriormente. Para múltiplos pacotes, primeiro forneça uma visão geral leve do lote, depois detalhes independentes numerados; itens com falha não podem desaparecer. O caminho do pacote de máquina ainda deve ser fornecido no corpo do texto. --legacy-unverified-media só é permitido para auditoria de pacotes históricos, proibido para novas transferências.

Limitações conhecidas

• O "vídeo original" dentro do fragmento é uma cópia de exibição H.264/AAC de baixa taxa de bits com duração completa dentro do orçamento, não uma segunda fonte de arquivo; o caminho original e SHA-256 ainda são garantidos pelo source_manifest.json. Fragmentos únicos estão sujeitos ao limite de 1 MB; se não couber, degrade explicitamente para quadros de quadro, não trunque o vídeo.
• Arrastar diretamente de um fragmento produz uma imagem de visualização JPEG derivada dentro do orçamento, não o quadro original do pacote; o arrasto fornece simultaneamente File do navegador, DownloadURL do Chromium, data URI e o caminho do quadro original. Se o aplicativo de destino aceita o formato de arrasto correspondente é de sua própria responsabilidade; para obter a imagem original sem perdas, use "copiar caminho do quadro original".
• O caminho do Artefato do Claude Code ainda não foi verificado em host real; se a renderização não puder ser confirmada, recorra a --format md.