liuhaodong/ai-video-editor

Habilidad de Editor de Video y Foto Multiagente Modular

Usa esta habilidad siempre que el usuario quiera analizar una carpeta de videos y fotos, entrevistar/aclarar preferencias de historia, ejecutar el pipeline de edición multiagente para vlogs y viajes familiares, agregar un rol de subagente de edición personalizado (como VFX o Color) o renderizar un video 4K 10-bit HLG HDR.

1. Archivos de Referencia de Roles de Subagentes (Divulgación Progresiva)

Cada rol de agente tiene su propia especificación de referencia en references/ (utilizada tanto por las herramientas define_subagent / invoke_subagent de Antigravity como por las clases BaseEditingAgent de Python):

• Etapa 0 — Recepción del Cliente y Productor de Brief (client_intake): references/00_client_intake_agent.md → genera creative_brief.json
• Etapa 10 — Wrangler y Culler (culler): references/01_culler_agent.md → genera media_index.json
• Etapa 10 — Diseñador de Sonido y Ambiente (audio_vibe): references/04_audio_vibe_agent.md → genera beat_grid.json
• Etapa 20 — Productor de Historia (story_producer): references/02_story_producer_agent.md → genera paper_edit.json
• Etapa 30 — Editores de Imagen Duales (dialogue_editor + montage_editor): references/03_picture_editors.md → genera un borrador de timeline.yaml multipista
• Etapa 40 — Espacio Enchufable de Post / VFX / Color (vfx_designer): references/06_vfx_agent.md → enriquece timeline.yaml (effects_track) y genera vfx_manifest.json
• Etapa 50 — Showrunner y Crítico de Ritmo (showrunner): references/05_showrunner_agent.md → audita contra creative_brief.json, coordina revisiones y genera pacing_audit.json + borrador de timeline.yaml + storyboard.md
• Etapa 60 y Supervisor Transversal — Director de Producción Ejecutiva (production_director): references/07_production_director_agent.md → supervisa a todos los subagentes en cada etapa, dirige a los subagentes para corregir/mejorar la cobertura, la variedad de movimiento y la continuidad de audio/títulos, y genera director_review.json + timeline.yaml final aprobado y storyboard.md

---

2. Ejecutar el Pipeline Multiagente

Opción A: Subagentes Nativos de Antigravity + Orquestador CLI

1. Entrevistar al Cliente (Etapa 0): Usa ask_question (guiado por references/00_client_intake_agent.md) para aclarar el estilo narrativo, los momentos imprescindibles, la duración objetivo y el encuadre de las fotos, o ejecuta:

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

2. Crear Subagentes Especializados (define_subagent / invoke_subagent): Puedes crear cualquiera de los roles en ventanas de contexto aisladas usando define_subagent con el prompt del sistema de su archivo references/*.md correspondiente, para que cada rol inspeccione y enriquezca su contrato JSON en disco (creative_brief.json → media_index.json & beat_grid.json → paper_edit.json → timeline.yaml → pacing_audit.json).
3. Renderizar Video 4K 10-bit HLG HDR y Exportaciones NLE:

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

Opción B: Listar o Activar Subagentes Enchufables

# Lista todos los agentes básicos y complementos opcionales registrados
python -m video_editing_ai.cli agents-list

# Ejecuta el pipeline con el complemento opcional del Diseñador VFX de la Etapa 40 habilitado
python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<idea>" --enable-agent vfx_designer

Opción C: Estudio Web Local

python -m video_editing_ai.cli serve --port 8000