Communitygithub.com

adu-motion-video

Utilize pacotes completos de animação para criar vídeos editáveis com efeitos animados e MP4 60fps a partir de nova narração, roteiro e materiais próprios; também suporta TPL leves, animação à mão, legendas e reedição de vídeos antigos. Requer um Agente com acesso a leitura/escrita de arquivos locais e execução de comandos.

O que é adu-motion-video?

A habilidade `adu-motion-video` permite que um agente de IA transforme uma narração editada, roteiro e materiais próprios em vídeos animados completos e editáveis, exportando-os como MP4 de 60fps. Ela é ideal para criadores de conteúdo que desejam automatizar a produção de vídeos com animações profissionais, mantendo a capacidade de personalização. A habilidade suporta múltiplos fluxos de trabalho: desde o uso de pacotes de animação completos (como `paper-ball-performance` e `doubao-console-performance`), passando por templates leves (`TPL`) para vídeos curtos, até técnicas de animação à mão para continuidade de cenas. Ela gerencia todo o ciclo de vida do projeto, começando pela seleção de templates com base no estilo desejado, passando pelo planejamento e roteirização das animações, construção do projeto, e finalmente a renderização e verificação de qualidade. O agente utiliza scripts em shell (`scripts/pipeline.sh`) para orquestrar as tarefas, verificando dependências, planejando cenas, construindo o projeto e exportando o vídeo final. A habilidade inclui verificações rigorosas de qualidade, como a validação de sincronismo labial, substituição de placeholders de materiais e confirmação de que as animações se encaixam corretamente na nova narração. Ela é compatível com plataformas como Claude Code, Cursor e Codex, desde que o agente tenha permissões para executar comandos e acessar o sistema de arquivos local.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add adunext/adu-motion-video

Perguntar na sua IA favorita

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

Documentação

O que adu-motion-video faz?

O usuário fornece um vídeo de narração editado, o roteiro e, de preferência, legendas com timecodes da nova narração. Ao usar cenas que contenham capturas de tela, mural de trabalhos, avatar, logotipo ou trilha sonora, também é necessário fornecer os materiais que você tem o direito de usar neste episódio. Você é responsável por adaptar a coreografia da cena completa ao novo roteiro e duração, gerar um projeto editável, verificar e exportar um novo MP4. Primeiro, leia as Convenções de Produção. SKILL_DIR é o diretório deste arquivo, PL="$SKILL_DIR/scripts/pipeline.sh". O registro de produção salva o caminho real da Skill, versão e ponto de entrada usado; instalações antigas com o mesmo nome, versões do repositório e código de execução congelado de projetos gerados podem ser diferentes. Não use a documentação da versão mais recente para validar projetos antigos.

Selecionar Ponto de Entrada

Quando o usuário especificar um número de template (por exemplo, 01-B) ou solicitar a escolha de um estilo, primeiro leia o Catálogo de Templates e Estilos e mapeie de "Template de Nível 1 → Estilo de Nível 2" para uma versão explícita do pacote. Estilos não publicados não podem ser prometidos como pacotes publicados. Quando precisar de materiais de animação auxiliares, consulte a API de Ativos de Animação Pública, baixe-os para o projeto atual e verifique os requisitos de mídia e renderização do pacote selecionado.

Quando o usuário adicionar um projeto concluído, destilar novos grupos de cenas ou atualizar a biblioteca de templates, leia Integração Contínua de Templates. Primeiro, registre a fonte e o status real, depois destile com base no valor. Receber um projeto não significa que ele já é um template publicável. bash "$PL" packs lista apenas os metadados semânticos e de versão dos pacotes; carregue o manifesto relevante para a tarefa. Quando houver várias versões do mesmo ID, selecione explicitamente id@version.

Quando o usuário especificar 03 · 3D Escuro / 03-A · Exposição Multi-tela, leia o Template 3D Escuro e selecione [email protected]. Ele mantém a coreografia de mural de trabalhos com nove cenas, comparação multi-tela, zoom em destaque e janelas de software, adicionando layout nativo retrato 1080×1920. A versão 1.1.1 complementa a verificação de cor para extração de quadros HDR e exportação SDR; registros de instalação anteriores pertencem ao 1.1.0, que ainda aguarda confirmação audiovisual contínua do autor; selecione as cenas completas com base nos materiais deste episódio, não contando nos dezessete grupos estáveis. O antigo 1.0.0 mantém seus bytes originais.

  1. Execute bash "$PL" packs por padrão, selecione a versão explícita com base no propósito declarado, leia o README.md e manifest.json do pacote relevante e consulte Instruções de Reutilização de Projetos Completos. [email protected] mantém picos, respostas a pessoas e estabilização, com três grupos validados; [email protected] mantém transformação de objetos, desmontagem e fechamento, com dois grupos validados. [email protected] é um grupo de continuidade de perspectiva em papel. O escopo estável é limitado ao macOS 1080p60 já aprovado, não significa que a fonte inteira ou qualquer roteiro seja um template; limites por grupo são detalhados na Matriz de Capacidades. Versões candidatas antigas são mantidas, e os grupos de interferência planejados de B ainda são candidatos. Os antigos anim3/anim4 têm 12/9 cenas completas, respectivamente, ainda experimentais. O ID do pacote não está relacionado ao título ou marca do vídeo original. Os pacotes C/D/E [email protected], [email protected] e [email protected] têm três grupos estáveis cada, mantendo respectivamente camadas frontal/traseira e movimentação de pessoas, colunas e transições, e respostas a palavras e entidades. Cada rota é produzida por um executor que não participou da destilação, criando um novo vídeo de 99,5 segundos a partir do pacote congelado público e da entrada deste episódio; o autor confirma a validade. Os bytes originais de candidatos antigos são mantidos; a ponte deste episódio não conta como grupo estável público.
  2. Para vídeos curtos leves ou exploração de layout, use os 9 TPL básicos; eles são quick-start e não contêm todas as ações dos pacotes completos.
  3. Para personagens desenhados à mão ou continuidade de cena com o mesmo plano, leia Métodos de Animação à Mão. Atualmente, não há pacote completo correspondente; não trate a documentação do método como automaticamente transformada em template.

3.3.0 adiciona 02-B · Agregação em Papel [email protected]: seis tipos de materiais agregados em uma rede, além de dois grupos estáveis: calendário de sete passos, seis capacidades, três unboxings e empilhamento de cartões de entrega. A comparação fonte/replay e uma amostra de 18,2667 segundos com conteúdo diferente foram aprovadas audiovisualmente pelo autor. Requer narração/roteiro real deste episódio e uma fonte de título com SHA fixo fornecida explicitamente; veja descrição do pacote. Este é um incremento em nível de grupo, não uma nova rota de vídeo completo; problemas de grade estritos são mantidos em review.json. Os quinze grupos estáveis de 3.2.0 e candidatos antigos mantêm seus bytes originais; atualmente, há dezessete grupos estáveis em sete estilos.

Fluxo de Pacotes de Projeto Completo

3.6.0 adiciona reatribuição parcial de storyboard atual e verificação de versão de materiais, além de integrar processamento de cores compartilhado para extração de quadros de vídeo geral. 04-A · Demonstração de Console candidato atual [email protected] adiciona layout de texto com bordas; a repetição técnica do mesmo conteúdo dos três grupos originais 0.1.1 ainda é mantida; a verificação de novo roteiro silencioso não substitui a aprovação audiovisual completa de nova narração ou reutilização independente; veja descrição do template. A nova prévia usa o comando preview unificado com evidência de exportação e verificação de versão.

Para novos roteiros, primeiro gere brief.json usando o Mecanismo de Composição Adaptativa, execute bash "$PL" macro-plan pacoteID@versão brief.json novo_diretório_de_planejamento. Este ponto de entrada filtra por estágio semântico, quantidade, janelas de movimento em velocidade original e dependências de cena anterior/posterior, e dentro de combinações válidas reduz a repetição de efeitos. Os 26 grupos completos de 8 pacotes de estilo já possuem perfis de adaptação verificados por código; a capacidade ainda é adaptation-experimental. Saída spec.json/report.json/report.md/profile.json; código de saída 0 indica verificação de vínculo aprovada, 2 indica rascunho salvo pendente ou bloqueado, 1 indica entrada inválida. Quando faltam timecodes de mídia ou palavras-chave reais, modifique o brief e replaneje; não preencha timecodes de demonstração de fonte. macro-spec é mantido como ponto de entrada para receitas históricas/manuais; ele não fornece este nível de diagnóstico semântico e de adjacência; novas produções devem priorizar planos com adaptation; a construção revalidará.

Ao adicionar materiais a um plano existente, execute macro-rematch conforme Reatribuição Parcial de Storyboard, verifique as sugestões e salve em um novo diretório via macro-apply-rematch. Fixe a semântica, o tempo e outros storyboards do segmento original; revalide a mídia e as emendas bilaterais. Recuse a aplicação se a linha de base ou os materiais mudaram. Se não houver novo grupo compatível, mantenha o grupo original; não troque efeitos aleatoriamente nem adivinhe mapeamentos de roteiro de outros templates. Esta interface é para ferramentas de produção; ainda não equivale à interface de arrastar e soltar do ADuDir.

  1. bash "$PL" doctor verifica Node, Python, FFmpeg e Chrome; se faltarem dependências e a instalação for permitida, execute bash "$PL" setup. Mantenha o projeto fonte e o vídeo final original como somente leitura; produza em um novo caminho que não exista.
  2. Primeiro, fixe a fonte do template especificada pelo usuário. Outros anim no diretório de materiais, novos projetos ou vídeos antigos não se tornam automaticamente rascunhos de animação; não insira apenas alguns fragmentos de template e chame o vídeo inteiro de template especificado. Registre o pacote fonte e o ID da cena para cada cena; para mistura de pacotes completos, veja Organização de Múltiplos Pacotes e Fontes. Alinhe a nova narração e o roteiro; obtenha o tempo preciso das falas-chave. Quando o SRT tiver apenas o tempo da frase inteira, não adivinhe o tempo de uma palavra dentro da frase; use dados de alinhamento palavra por palavra ou anotação manual. Leia role, cues, motionWindows, slots do pacote; selecione, reordene ou repita cenas completas com base no significado. Primeiro, liste o storyboard e os materiais faltantes.
  3. Escreva o brief com base na nova narração, execute bash "$PL" macro-plan pacoteID@versão /caminho/brief_atual.json /diretório_pai_existente/novo_diretório_de_planejamento; veja o relatório; se faltar algo, complete o brief e replaneje; use o spec.json gerado para construir. Antes da renderização, verifique o estágio e o roteiro real, os pontos de impacto de eventos-chave, a identidade dos materiais e a repetição em todo o vídeo, conforme Verificação de Conteúdo Reutilizado. O planejador verifica a estrutura declarada, não julga se o estágio preenchido é fiel ao roteiro. Use macro-spec apenas para receitas mantidas manualmente; seus cues são deixados em branco, e o texto de exemplo e a duração do vídeo original servem apenas para conhecer a interface; você deve preencher o conteúdo e os timecodes reais deste episódio; não adicione mecanicamente o mesmo deslocamento a cada grupo repetido. brand preenche a conta deste episódio. A música deste episódio pode ser especificada com music:{mode:"track",path,offset}; se não for especificada, a estrutura da composição original será remixada. A janela de pessoa usa o Vision no macOS para rastrear o rosto da nova narração por padrão; se o rastreamento automático não for possível, configure explicitamente faceTracking:{mode:"fixed",cx,cy,h} revisado. Quaisquer dados de demonstração de fonte ou texto de exemplo devem ser substituídos ou marcados explicitamente como "ilustrativo". Caminhos vazios para materiais representam itens faltantes; as limitações de mídia e capacidade são detalhadas no README.md do diretório do pacote.
  4. bash "$PL" macro-build pacoteID@versão /caminho/novo_planejamento/spec.json /caminho/narração_editada.mp4 /caminho/novo_projeto [--subs-js /caminho/legendas.js]. A duração da nova narração deve corresponder ao número total de quadros planejado. O adaptador trava as janelas de movimento-chave na velocidade original; parágrafos mais longos estendem apenas as áreas de pausa permitidas; se o tempo for insuficiente, ele reporta um erro, e você altera o storyboard ou a duração do segmento, sem depender de alongamento linear de todo o vídeo. A falta de texto, números, mídia ou cues-chave também gera erro.
  5. bash "$PL" stills /caminho/novo_projeto 0,4,12,... verifica o primeiro quadro, antes/depois/durante cada cue, o texto mais longo, as emendas de cena e o final; para janelas pequenas, os olhos, boca e queixo devem ser visíveis; os parâmetros fixed devem ser determinados a partir dos materiais deste episódio e verificar poses extremas como cabeça baixa/erguida; então reproduza todos os intervalos de movimento complexo, comparando com o projeto original. Verifique fontes, proporção/corte de mídia, sincronismo labial real, legendas, SFX e música. Revise a configuração ou projeto e revalide.
  6. bash "$PL" audio /caminho/novo_projeto → bash "$PL" mix /caminho/novo_projeto → bash "$PL" render /caminho/novo_projeto /caminho/novo_video_v1.mp4 → bash "$PL" check /caminho/novo_video_v1.mp4. Assista e ouça o arquivo codificado final por completo; a contagem de quadros, decodificação e loudness do check não substituem a aprovação visual e de conteúdo. A nova prévia é publicada através de bash "$PL" preview /caminho/novo_projeto /caminho/novo_video_v1.mp4 /diretório_pai_existente/novo_diretório_de_prévia, vinculando o SHA real do vídeo final, exibindo a versão de reprodução e sugerindo atualização de guias antigas. Riscos de HDR/DV, profundidade de bits de origem e metadados devem ser documentados com evidências reais de comparação, conforme Cor e Prévia de Materiais, não apenas verificando tags.

Para experimentar rapidamente os templates básicos, use bash "$PL" demo /novo_diretório_que_não_existe. Ao combinar TPL do zero para narração real, siga o Diretório de Templates e o Esquema de Legendas; ainda é necessária uma verificação completa.

Verificações Obrigatórias

  • A extração de quadros da narração deve usar o relógio de saída alvo como referência; a animação da cena fonte executa no relógio de coreografia original mapeado. O relógio da cena original não pode controlar o sincronismo labial real, e quadros de pessoas reais congelados não podem ser usados para preencher duração faltante.
  • Se o primeiro quadro for a abertura da narração, a pessoa real e o tema devem estar visíveis; verifique a cor da borda, tamanho da fonte e área segura das legendas; não deixe marca, data, valores ou texto placeholder do vídeo fonte do template no novo vídeo.
  • Verifique segmentos contínuos de cada janela de proteção de movimento, não apenas uma imagem; verifique capturas de tela, grade de nove, mural de trabalhos com os materiais reais deste episódio. Música e efeitos sonoros são recombinados com a nova linha do tempo; não apenas mude a velocidade da trilha de áudio do vídeo final antigo.
  • Novos roteiros não garantem adaptação automática sem perdas. Se um segmento curto não comportar o movimento, recuse, divida ou troque de cena; segmentos longos só podem ser estendidos em posições de pausa permitidas. Novas cenas ainda devem ser projetadas para o conteúdo deste episódio; não aplique cenas macro mecanicamente com base em frases.
  • Produza um novo projeto e uma nova versão do vídeo final; não sobrescreva o projeto original do usuário; relate o escopo real da verificação. anim3 e anim4 permanecem experimentais até que a verificação quadro a quadro do novo roteiro completo e a aprovação audiovisual do vídeo final sejam concluídas; não declare como totalmente validado.

Mais detalhes: Reutilização de Projetos Completos · Convenções de Produção · Legendas · Trilha Sonora · Animação à Mão · Solução de Problemas.

Habilidades Relacionadas