yunjundai/video-editing-skills

Edição de Vídeo Sem GPU Dedicada

Ao usar, instalar ou empacotar este skill por outro agente de IA, leia primeiro agent-compatibility.md e processe o diretório do skill e as configurações locais de acordo com a plataforma de destino.

Use Remotion local para animações e montagem, FFmpeg para processamento de áudio/vídeo, e Shotcut para ajustes finos; legendas usam faster-whisper CPU/int8 e OpenCC. Por padrão, não depende de GPU dedicada, CUDA, NVENC, DaVinci Resolve, renderização em nuvem ou efeitos pagos. Mantém o estilo e formato de entrega especificados pelo usuário.

Ambiente e Recursos

Antes do primeiro uso, copie local-environment.example.json para references/local-environment.json e preencha os caminhos reais das ferramentas; os caminhos de exemplo não indicam que as ferramentas estão instaladas.

• Leia primeiro references/local-environment.json e use os caminhos absolutos das ferramentas lá definidos. Execute scripts/project.py doctor; legendas usam o Python do venv dedicado. O doctor não requer CUDA ou Resolve, apenas verifica a existência do programa Shotcut, não representando validação da GUI.
• Este skill contém scripts, modelos Remotion e arquivos de bloqueio de dependências, podendo ser usado independentemente de outros skills de edição; a localização das ferramentas e modelos locais é especificada pelo arquivo de configuração. Ao mover para outro computador, leia environment-notes.md, reinstale as dependências ausentes, modifique os caminhos e teste. Não presuma que as ferramentas estão instaladas em outra máquina.
• Padrão: 16:9, 1920×1080, 30fps; faça primeiro uma prévia em meia resolução. Remotion usa por padrão um único job, backend gráfico de software SwiftShader e codificação de software H.264; não alterna automaticamente para CUDA. Com memória suficiente, use --concurrency 2; mantenha 1 em memória baixa.
• Os jobs são executados sequencialmente, sem renderização completa, reconhecimento de fala e conversão de proxy simultaneamente. Se a memória for insuficiente, reduza primeiro o tamanho da prévia, use proxies ou divida em segmentos; segmentos devem manter as mesmas especificações de áudio/vídeo e tempos de legenda corretos, verificando as junções.
• Recomenda-se 16 GB de RAM como mínimo, 32 GB para maior folga, usando SSD. Esta é uma recomendação de trabalho, não uma garantia de que todos os computadores funcionarão sem problemas; não calcule a velocidade de saída não medida com base no número de núcleos ou duração do vídeo.

Material e Edição

1. Quando os requisitos estiverem incompletos, primeiro estime a duração, proporção e narrativa com base no material existente, perguntando apenas se a informação faltante afetar o produto final. Se o local do material for desconhecido, primeiro faça um inventário do diretório de trabalho. Mantenha os arquivos originais; coloque os arquivos derivados em uma nova pasta de trabalho.
2. Leia media-commands.md e use scripts/media.py inventory para criar uma lista de durações, proporções, áudio e miniaturas. Visualize as cenas representativas, ouça as vozes e leia a transcrição antes de selecionar trechos; não trate cortes candidatos ou suposições como fatos confirmados.
3. Com 4K, alta taxa de bits ou prévia lenta, use media.py proxy --width 960 para gerar arquivos de prévia H.264/AAC. Registre a correspondência entre originais e proxies; a prévia pode usar proxies; antes da renderização final, restaure os originais e verifique novamente os cortes e a sincronização. Não entregue proxies como qualidade original.
4. Leia project-commands.md e use scripts/project.py init para criar um novo projeto Remotion. Copie o material selecionado para public/media/ e edite public/project.json; especificações dos dados em motion-template.md. O modelo suporta introdução, capítulos, aproximação de fotos, vídeos, citações, créditos, legendas e barras de nome.
5. Verifique o ponto de entrada e duração do vídeo com ffprobe. Priorize fade in/fade out, transições simples, aproximação suave de fotos e animações curtas de texto; evite muitos efeitos de desfoque, partículas, 3D ou camadas de alta resolução por padrão. Se a qualidade for insuficiente, ajuste o design em vez de forçar texto muito pequeno.
6. Primeiro faça uma prévia curta e quadros estáticos para confirmar o estilo e legibilidade antes de produzir o vídeo completo. Use project.py render --scale 0.5 para prévia; use tamanho completo para entrega final. Comandos específicos baseiam-se nas referências do skill e na saída --help dos scripts, usando caminhos absolutos e arrays de parâmetros para lidar com caminhos em chinês e com espaços.

Legendas em Chinês Tradicional e Áudio

• scripts/transcribe.py passe explicitamente --device cpu --compute-type int8 --model caminho_do_modelo_local --local-files-only, usando o modelo small já baixado. Se o reconhecimento falhar, primeiro verifique o venv, o modelo e pacotes compatíveis; não solicite instalação de CUDA por lentidão.
• Execute o reconhecimento na trilha de diálogo após a edição, ou converta cada segmento de legenda para a linha do tempo final com base nos cortes e transições; não aplique diretamente os tempos do material original. Evite gerar legendas a partir de música de fundo pura.
• OpenCC apenas ajuda na conversão de caracteres tradicionais; é necessário verificar nomes de escolas, pessoas, cargos, datas, homófonos e taiwanês. Se o reconhecimento não estiver claro, mantenha marcações de pendência, não invente.
• O campo captions em captions.json pode ser inserido no project.json. Para destaque palavra por palavra, primeiro verifique os tempos das palavras e a consistência do texto da frase/palavra; se houver apenas tempo de frase, exiba a frase inteira.
• Legendas e barras de nome mantenham margens de segurança e não se sobreponham; reduza a música de fundo até que a voz fique clara e verifique se dois trechos de diálogo não se sobrepõem durante transições. Mantenha o SRT e a fonte de diálogo sem mixagem de música para facilitar correções.

Refino e Entrega com Shotcut

• Use project.py shotcut video_final.mp4 --output nova_versao.mlt para criar um ponto de partida no Shotcut, contendo os segmentos de vídeo renderizados, que podem ser ajustados em corte, música e volume. O Shotcut usa efeitos gerais de CPU e saída de software; se necessário, reduza o Preview Scaling e ative proxies. Não solicite que o usuário ative codificação por hardware.
• O texto, legendas e transições do Remotion estão incorporados nesses segmentos, não são camadas de texto nativas do Shotcut. Para alterar texto ou animações, retorne ao projeto Remotion e renderize novamente; não afirme que o MLT pode modificar esses efeitos palavra por palavra. Se houver solicitação de camadas separadas ou texto nativo, crie e verifique separadamente.
• Use media.py check para decodificação completa, verificando quadros pretos, silêncio e erros; depois, verifique manualmente a introdução, pontos médios de transições, legendas mais longas, barras de nome e créditos, ouvindo diálogos/música e sincronia. Quadros pretos e silêncio podem ser intencionais, exigindo interpretação.
• Entregue MP4, miniatura, projeto e material Remotion, project.json, SRT e o MLT do Shotcut criado com as modificações. Gere uma nova versão, não sobrescreva silenciosamente produtos existentes; não modifique o material original nem compartilhe node_modules.
• Antes de entregar o MLT, carregue-o no Shotcut ou use suas ferramentas MLT; se apenas o formato XML for aprovado, indique claramente que a carga no editor ainda não foi verificada. Não declare funcionalidades não testadas como bem-sucedidas.
• MP4 H.264 geralmente não preserva transparência. Se for solicitada animação com transparência, crie uma Composition transparente separada e teste a sequência PNG RGBA ou codificação alpha compatível.

Ao finalizar, informe a localização dos arquivos, as configurações de saída testadas, o escopo de modificações, legendas pendentes de revisão e itens não verificados. As licenças das ferramentas seguem os termos de cada software; os créditos da conta do agente de IA são cobrados separadamente.