에이전트 기반 비디오 편집

Primitive-First 워크플로우

ScreenKite의 에이전트 편집은 단순합니다. 앱은 결정적인 편집 primitive를 제공하고, 계획 수립, 전사 해석, 편집 정책은 에이전트가 맡습니다.

권장 루프

1. getProjectState(scope: "summary"), getProjectState(scope: "layout"), getProjectResources()를 읽습니다.
2. 타이밍이 중요하면 전사를 내보내고, 타임라인을 바꾸기 전에 beat plan을 세웁니다.
3. 화면 비율을 바꾸기 전에 setCanvas(..., dryRun: true), 복잡한 레이아웃 작업 전에 setSceneLayout(..., dryRun: true)를 실행합니다.
4. 타임라인 편집은 editTimeline, 장면 구성 변경은 setSceneLayout, 효과 처리는 manageEffects로 적용합니다.
5. long-form 프로젝트를 바꾸지 말고 exportArtifact(type: "range", settings.canvasOverride)로 shorts나 다른 비율의 결과물을 내보냅니다.
6. 변경 배치마다 getProjectState(scope: "visual") 또는 snapshot export로 검증합니다.

각 primitive를 쓰는 시점

• editTimeline: 컷, 트림, 단어 경계 기준 정리
• setSceneLayout: 시간 범위가 있는 구성 변경과 advanced layout DSL
• manageEffects: 캡션, 줌, 기타 효과 패스
• vfxExportVideoSegment와 vfxOverlayProcessedClip: 외부 렌더 왕복
• exportArtifact: 최종 파일, snapshot, SRT, range export

가드레일

• 단어 중간을 자르지 마세요. 말의 타이밍이 중요할 때는 전사의 단어 경계를 사용하세요.
• timeout 이후 mutating call을 다시 시도하기 전에 project state를 다시 읽으세요.
• overlay render를 타임라인에 다시 넣기 전에 대상 너비, 높이, fps, 프레임 길이에 정확히 맞추세요.
• 자기 검증 루프를 무한히 돌리지 마세요. 몇 번 확인해도 시각 검증이 계속 실패하면 layout이나 source media를 직접 점검하세요.