liuhaodong/ai-video-editor

Habilidade Modular Multiagente de Edição de Vídeo e Foto

Use esta habilidade sempre que o usuário quiser analisar uma pasta de vídeos e fotos, entrevistar/esclarecer preferências de história, executar o pipeline de edição multiagente para vlogs e viagens em família, adicionar um papel de subagente de edição personalizado (como Efeitos Visuais ou Cor), ou renderizar um vídeo 4K 10-bit HLG HDR.

1. Arquivos de Referência de Papéis dos Subagentes (Divulgação Progressiva)

Cada papel de agente tem sua própria especificação de referência em references/ (usada tanto pelas ferramentas define_subagent / invoke_subagent da Antigravity quanto pelas classes Python BaseEditingAgent):

• Estágio 0 — Atendimento ao Cliente e Produtor de Briefing (client_intake): references/00_client_intake_agent.md → gera creative_brief.json
• Estágio 10 — Organizador e Cortador (culler): references/01_culler_agent.md → gera media_index.json
• Estágio 10 — Designer de Som e Ambiente (audio_vibe): references/04_audio_vibe_agent.md → gera beat_grid.json
• Estágio 20 — Produtor de História (story_producer): references/02_story_producer_agent.md → gera paper_edit.json
• Estágio 30 — Editores de Imagem Duplos (dialogue_editor + montage_editor): references/03_picture_editors.md → gera rascunho da linha do tempo multi-track timeline.yaml
• Estágio 40 — Slot Plugável de Pós-produção / VFX / Cor (vfx_designer): references/06_vfx_agent.md → enriquece timeline.yaml (effects_track) e gera vfx_manifest.json
• Estágio 50 — Showrunner e Crítico de Ritmo (showrunner): references/05_showrunner_agent.md → audita contra creative_brief.json, coordena revisões e gera pacing_audit.json + rascunho timeline.yaml + storyboard.md
• Estágio 60 e Supervisor Transversal — Diretor de Produção Executivo (production_director): references/07_production_director_agent.md → supervisiona todos os subagentes em cada etapa, direciona subagentes para corrigir/melhorar cobertura, variedade de movimento e continuidade de áudio/título, e gera director_review.json + timeline.yaml final aprovado e storyboard.md

---

2. Executando o Pipeline Multiagente

Opção A: Subagentes Antigravity Nativos + Orquestrador CLI

1. Entreviste o Cliente (Estágio 0): Use ask_question (guiado por references/00_client_intake_agent.md) para esclarecer estilo narrativo, momentos obrigatórios, duração alvo e enquadramento de fotos, ou execute:

   python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<user_story_idea>" --bgm "<optional_bgm.mp3>"
   

2. Crie Subagentes Especializados (define_subagent / invoke_subagent): Você pode criar qualquer um dos papéis em janelas de contexto isoladas usando define_subagent com o prompt de sistema do seu arquivo references/*.md correspondente, para que cada papel inspecione e enriqueça seu contrato JSON no disco (creative_brief.json → media_index.json & beat_grid.json → paper_edit.json → timeline.yaml → pacing_audit.json).
3. Renderize Vídeo 4K 10-bit HLG HDR e Exportações NLE:

   python -m video_editing_ai.cli render "<project_dir>/timeline.yaml" -o "<project_dir>/final_story.mp4"
   

Opção B: Liste ou Ative Subagentes Plugáveis

# Lista todos os agentes principais e plugins opcionais registrados
python -m video_editing_ai.cli agents-list

# Executa o pipeline com o plugin opcional do Designer VFX (Estágio 40) ativado
python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<idea>" --enable-agent vfx_designer

Opção C: Estúdio Web Local

python -m video_editing_ai.cli serve --port 8000