エージェントによる動画編集

Primitive-First ワークフロー

ScreenKite のエージェント編集はシンプルです。アプリは決定的な編集プリミティブを提供し、計画、文字起こしの解釈、編集方針はエージェント側が担います。

推奨ループ

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 で確認します。

プリミティブの使い分け

• editTimeline: カット、トリム、単語境界に沿った整理
• setSceneLayout: 時間範囲つきの構図変更や advanced layout DSL
• manageEffects: キャプション、ズーム、その他の効果パス
• vfxExportVideoSegment と vfxOverlayProcessedClip: 外部レンダーの往復
• exportArtifact: 納品ファイル、snapshot、SRT、range export

ガードレール

• 単語の途中で切らないでください。発話タイミングが重要な場合は文字起こしの単語境界を使います。
• timeout 後に mutating call を再試行する前に、必ず project state を再読込してください。
• overlay render をタイムラインに戻す前に、対象の幅、高さ、fps、フレーム長に合わせてください。
• 自己評価ループは増やしすぎないでください。数回確認しても崩れる場合は、layout か source media を直接見直します。