liuhaodong/ai-video-editor

모듈식 멀티 에이전트 비디오 및 포토 에디터 스킬

사용자가 동영상 및 사진 폴더를 분석하고, 스토리 선호도를 인터뷰/명확히 하거나, 멀티 에이전트 브이로그 및 가족 여행 편집 파이프라인을 실행하거나, 맞춤형 편집 하위 에이전트 역할(VFX 또는 색상 등)을 추가하거나, 4K 10비트 HLG HDR 비디오를 렌더링해야 할 때 이 스킬을 사용하세요.

1. 하위 에이전트 역할 참조 파일 (점진적 공개)

각 에이전트 역할은 references/ 디렉토리에 자체 참조 사양을 가지고 있습니다(Antigravity의 define_subagent / invoke_subagent 도구와 Python BaseEditingAgent 클래스 모두에서 사용됨):

• 스테이지 0 — 클라이언트 인테이크 및 브리프 프로듀서 (client_intake): references/00_client_intake_agent.md → 출력 creative_brief.json
• 스테이지 10 — 랭글러 및 컬러 (culler): references/01_culler_agent.md → 출력 media_index.json
• 스테이지 10 — 사운드 및 바이브 디자이너 (audio_vibe): references/04_audio_vibe_agent.md → 출력 beat_grid.json
• 스테이지 20 — 스토리 프로듀서 (story_producer): references/02_story_producer_agent.md → 출력 paper_edit.json
• 스테이지 30 — 듀얼 픽처 에디터 (dialogue_editor + montage_editor): references/03_picture_editors.md → 출력 초안 멀티트랙 timeline.yaml
• 스테이지 40 — 플러그형 후반 / VFX / 색상 슬롯 (vfx_designer): references/06_vfx_agent.md → timeline.yaml (effects_track) 강화 및 vfx_manifest.json 출력
• 스테이지 50 — 쇼러너 및 페이싱 크리틱 (showrunner): references/05_showrunner_agent.md → creative_brief.json에 대해 감사, 수정 조정, pacing_audit.json + 초안 timeline.yaml + storyboard.md 출력
• 스테이지 60 및 교차 스테이지 감독자 — 총괄 무비 프로덕션 디렉터 (production_director): references/07_production_director_agent.md → 모든 스테이지 게이트에서 모든 하위 에이전트 감독, 커버리지, 모션 다양성, 오디오/타이틀 연속성 수정/개선 지시, director_review.json + 최종 승인된 timeline.yaml 및 storyboard.md 출력

---

2. 멀티 에이전트 파이프라인 실행

옵션 A: 네이티브 Antigravity 서브 에이전트 + CLI 오케스트레이터

1. 클라이언트 인터뷰 (스테이지 0): ask_question을 사용하여(references/00_client_intake_agent.md의 지침에 따라) 내러티브 스타일, 필수 순간, 대상 길이 및 사진 프레이밍을 명확히 하거나 다음을 실행합니다:

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

2. 전문화된 서브 에이전트 생성 (define_subagent / invoke_subagent) : 해당 references/*.md 파일의 시스템 프롬프트와 함께 define_subagent를 사용하여 각 역할을 격리된 컨텍스트 창에서 생성할 수 있습니다. 각 역할은 디스크에서 해당 JSON 계약(creative_brief.json → media_index.json & beat_grid.json → paper_edit.json → timeline.yaml → pacing_audit.json)을 검사하고 강화합니다.
3. 4K 10비트 HLG HDR 비디오 및 NLE 내보내기 렌더링:

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

옵션 B: 플러그형 서브 에이전트 목록 보기 또는 전환

# 등록된 모든 핵심 및 선택적 플러그인 에이전트 목록 보기
python -m video_editing_ai.cli agents-list

# 선택적 스테이지 40 VFX 디자이너 플러그인을 활성화하여 파이프라인 실행
python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<idea>" --enable-agent vfx_designer

옵션 C: 로컬 웹 스튜디오

python -m video_editing_ai.cli serve --port 8000