O que Akira Video faz?
akira-video é o Roteador Primário do Akira Video Skills. Ele possui a entrada de produção de vídeo, o VIDEO.md, a avaliação da tarefa atual de produção, o roteamento para Skills especializadas e os limites de parada; os detalhes específicos do roteiro de vídeo, materiais reutilizáveis, tomadas, pacotes de geração, revisão e pós-produção do vídeo completo são de responsabilidade da Skill especializada correspondente. A dependência e a transição humano-máquina do projeto completo seguem o references/workflow/PRODUCTION-FLOW.md; projetos existentes continuam a partir do trabalho real atual, sem reexecutar mecanicamente as etapas anteriores.
Durante toda a produção, a proteção sempre prioriza: Usuário e fatos da fonte → Intenção do enredo/tomada (quando aplicável) → Identidade e estrutura de personagens/objetos → Fatos do produto (em anúncios) → Continuidade espacial e temporal → Estética visual → Efeitos especiais. Os níveis específicos, verificação retroativa de conflitos e exceções de "saída real adotada" seguem o references/workflow/AUTHORITY.md; os objetivos posteriores não podem comprometer as restrições anteriores.
1. Entrar ou Assumir um Projeto
Primeiro, leia o arquivo VIDEO.md no diretório raiz do projeto. Se não existir, crie um projeto de vídeo mínimo de acordo com references/project/PROJECT-LAYOUT.md; a definição do projeto e o estado atual seguem references/project/VIDEO-HOME.md, e a nomenclatura segue references/project/NAMING.md. Crie apenas os diretórios e arquivos realmente necessários no momento, sem pré-gerar categorias vazias; na primeira vez em que um pacote de geração for necessário, garanta que o .gitignore do projeto de destino ignore .tmp/.
Quando o usuário já fornecer imagens, vídeos, áudios, cortes brutos ou peças de referência prontas, primeiro avalie seu uso real no projeto atual de acordo com references/project/IMPORT-MEDIA.md; resultados que podem ser reutilizados diretamente não exigem a repetição forçada do processo de design ou geração.
Em seguida, leia o conteúdo mínimo necessário com base na tarefa atual:
- Visão geral do roteiro e tomadas do vídeo:
video/script/; - Conteúdo reutilizável entre tomadas:
video/materials/; - Tomada atual:
video/shots/<shot-id>/; - Quando a pós-produção do vídeo completo já começou:
video/edit/; - Fontes upstream (romances, capítulos, materiais de marca ou outras): leia ao longo do ponteiro real do projeto atual, sem duplicar a fonte de fato upstream original.
Critério de conclusão: ser capaz de explicar o objetivo atual do vídeo, requisitos de entrega, o conteúdo da produção em andamento, materiais reutilizáveis existentes, o estado atual da tomada/pós-produção e os bloqueios reais.
Antes de entrar em uma próxima produção cara, execute apenas as portarias leves aplicáveis ao projeto atual de acordo com references/workflow/PRODUCTION-GATES.md; as portarias não geram arquivos de estado adicionais do projeto. Quando o projeto atual já estiver grande demais para ser lido confortavelmente, ou quando for realmente necessário comparar versões criativas, leia references/project/SCALING-VERSIONS.md, sem presumir diretórios de longa-metragem. Ao precisar limpar resultados com falha, pacotes descartáveis, cache ou mídia antiga, de acordo com references/project/MEDIA-LIFECYCLE.md, primeiro confirme que o arquivo não é a única entrada, o resultado atualmente adotado ou a única dependência da engenharia de pós-produção.
Sobre como registrar decisões importantes de produção, quando atualizar o VIDEO.md e por que o resultado adotado de uma tomada é escrito apenas em SHOT.md, siga references/project/RECORDING.md; o histórico do chat e os pacotes de geração descartáveis não são registros de projeto de longo prazo.
2. Manter o VIDEO.md
O VIDEO.md é a página inicial de produção de vídeo para leitura direta por humanos e agentes subsequentes, salvando apenas informações ainda úteis. Mantenha o foco em:
- Objetivo do projeto e do vídeo;
- Requisitos de entrega;
- Progresso atual da produção;
- Trabalho atualmente em andamento;
- Bloqueios;
- Decisões-chave que ainda afetam as etapas seguintes;
- Navegação para o roteiro do vídeo, materiais reutilizáveis, tomadas e pós-produção do vídeo completo.
Históricos de comandos comuns, todos os resultados de geração, logs de geração e decisões antigas já substituídas pelo histórico do Git não entram no VIDEO.md.
Detalhes de escrita em references/project/VIDEO-HOME.md.
3. Roteamento do Trabalho Especializado
Selecione o próximo trabalho de produção real com base no objetivo atual do usuário e no conteúdo do projeto existente. O projeto completo não requer a passagem mecânica por todas as habilidades; se o roteiro já existir, pode-se ir diretamente para as tomadas; se as tomadas e os materiais já existirem, pode-se preparar diretamente o pacote de geração; após receber os resultados da geração, vá diretamente para a revisão.
Carregue a Skill canônica com base na tarefa atual:
- Formar/revisar roteiro de vídeo, atuação de personagens, cenas ou visão geral das tomadas a partir de romances, capítulos, briefings ou outros conteúdos upstream →
video-script; - Quando personagens ou cenas têm apenas descrições funcionais, sem um design específico de aparência/roupas/materiais/espaço/iluminação →
video-design; - Quando personagens precisam de timbre de voz consistente entre tomadas, referência de som, ou o projeto precisa planejar diálogos, sons ambientes, efeitos sonoros e os limites sonoros do vídeo completo →
video-audio; - Planejar ou manter prompts e materiais de referência para personagens, cenas, adereços e produtos reutilizáveis entre tomadas →
video-materials; - Expandir a visão geral das tomadas em
SHOT.md, tratando ação, cinematografia, som e continuidade com tomadas adjacentes →video-shot; - Escrever os prompts de geração atuais, selecionar o conjunto mínimo de referências, organizar o pacote de geração descartável e importar os resultados da geração do usuário →
video-generation; - Após o usuário trazer imagens ou resultados de geração, julgar a adoção, ajustar etapas seguintes, corrigir na pós-produção, regenerar ou reescrever →
video-review; - Quando várias tomadas adotadas entram na pós-produção do vídeo completo (Premiere Pro, After Effects, DaVinci Resolve, etc.) →
video-editing; - Quando o mesmo vídeo precisa de legendas, narração, dublagem ou versões finais em vários idiomas → primeiro leia
references/workflow/LOCALIZATION.md; o conteúdo de tradução é tratado porvideo-script, o som porvideo-audio, e legendas/gráficos/exportação final porvideo-editing, sem duplicar todo o conjunto do projeto; - Quando marca, inserção de produto ou anúncio exigirem verificação de funcionalidade do produto, estrutura, materiais oficiais e limites de expressão publicitária → carregue a opcional
video-advertisingconforme necessário; quando o Target atual não estiver instalado, use a coordenada explícitaakira-tl/akira-video-skills/video-advertising, entregue aoakiraRouter / Skiloom para gerar um Plano Candidato e instalar após autorização.
O Roteador apenas mantém o resumo das responsabilidades acima; ao entrar em qualquer ramo, a Skill carregada é a única fonte de autoridade para aquele método especializado.
Se o alvo exigir adaptação específica para modelos de vídeo, primeiro leia references/workflow/MODEL-ADAPTERS.md para selecionar o pacote de adaptação mínimo já existente no repositório; se não estiver instalado, entregue a coordenada explícita ao akira Router / Skiloom para gerar normalmente um Plano Candidato e instalar. Não codifique parâmetros de modelo ou detalhes de fornecedor diretamente no akira-video. A geração de imagens atualmente usa as regras gerais de video-design + video-materials, sem manter adaptadores de modelo de imagem separados.
Quando a geração externa já foi entregue ao usuário e requer espera entre sessões, registre no VIDEO.md apenas o caminho do pacote de geração, o retorno esperado, o próximo passo e os bloqueios reais, conforme references/workflow/WAITING-RESUME.md; na próxima sessão, priorize a retomada do pacote/resultado existente, sem reempacotar devido à troca de sessão.
4. Fronteira Humano-Máquina para Geração Externa
Por padrão, o usuário pode realizar a geração real em modelos externos de imagem/vídeo. Quando a geração externa for necessária, a Skill de geração especializada prepara um pacote de geração descartável a partir do conteúdo formal do projeto:
Conteúdo formal do projeto → Pacote de geração descartável em .tmp/ → Geração externa pelo usuário → Retorno dos resultados → Arquivar no diretório formal → Excluir pacote temporário.
O pacote de geração descartável é um artefato derivado e não se torna uma fonte de fato de longo prazo para o projeto; prompts de longo prazo permanecem no diretório do material ou tomada correspondente, e o pacote temporário copia apenas o conteúdo realmente necessário para a geração atual.
5. Limites de Redirecionamento e Parada
Após cada Skill especializada concluir uma ação com limite bem definido:
- Arquive os materiais formais retornados, resultados de geração, decisões de tomada ou engenharia do vídeo completo no diretório correspondente;
- Atualize o
VIDEO.mdcom o que ainda afeta a produção; - Decida o próximo trabalho de produção com base no objetivo do usuário e no artefato atual.
Pare apenas quando o escopo definido pelo usuário for concluído, o próximo passo depender de geração externa pelo usuário ou fornecimento de materiais, houver bloqueios reais, ou a entrega atual já estiver completa. Ao aguardar geração externa pelo usuário, forneça claramente o pacote de geração descartável e os requisitos de nomenclatura para o retorno, sem fingir que o material já foi gerado.