Communitygithub.com

Akira Video

Gerencia projetos de produção de vídeo AI; lê ou estabelece o VIDEO.md, roteiriza, roteia para skills especializadas e mantém a continuidade do projeto.

O que é Akira Video?

O Akira Video (akira-video) atua como roteador primário para habilidades de produção de vídeo orientadas por IA. Ele gerencia a entrada do projeto, a manutenção do arquivo `VIDEO.md` (que serve como resumo do estado atual do projeto), a triagem das tarefas de produção e o roteamento para habilidades especializadas (como roteiro, design, áudio, filmagem, geração, revisão e edição). O objetivo é evitar a sobrecarga de uma única instrução gigante, delegando cada etapa (roteiro, design de personagens/cenas, materiais reutilizáveis, tomadas individuais, pacotes de geração, pós-produção) à skill canônica mais adequada. O sistema prioriza a proteção de fatos e intenções (narrativa, identidade de personagens, continuidade) sobre estética e efeitos especiais, conforme uma hierarquia de autoridade definida. Ele é projetado para fluxos de trabalho não lineares: um projeto existente pode pular para qualquer etapa (ex.: ir direto para a edição se o roteiro e as tomadas já estão prontos). Também gerencia a fronteira humano-máquina para geração externa (imagem/vídeo), organizando pacotes de geração temporários e arquivando resultados no diretório apropriado do projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/akira-video

Perguntar na sua IA favorita

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

Documentação

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 por video-script, o som por video-audio, e legendas/gráficos/exportação final por video-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-advertising conforme necessário; quando o Target atual não estiver instalado, use a coordenada explícita akira-tl/akira-video-skills/video-advertising, entregue ao akira Router / 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:

  1. Arquive os materiais formais retornados, resultados de geração, decisões de tomada ou engenharia do vídeo completo no diretório correspondente;
  2. Atualize o VIDEO.md com o que ainda afeta a produção;
  3. 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.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Habilidades Relacionadas