Workflow Primitive-First
ScreenKite mantiene l'editing agentico semplice: l'app espone primitive di editing deterministiche e il tuo agente gestisce pianificazione, ragionamento sulla trascrizione e politica editoriale.
Ciclo consigliato
- Leggi
getProjectState(scope: "summary"),getProjectState(scope: "layout")egetProjectResources(). - Esporta una trascrizione quando il timing conta, poi pianifica i beat prima di modificare la timeline.
- Esegui
setCanvas(..., dryRun: true)prima dei cambi di aspect ratio esetSceneLayout(..., dryRun: true)prima di lavori di layout non banali. - Applica modifiche alla timeline con
editTimeline, modifiche di composizione consetSceneLayoute passaggi di effetti conmanageEffects. - Esporta shorts o formati alternativi con
exportArtifact(type: "range", settings.canvasOverride)invece di mutare il progetto long-form. - Verifica con
getProjectState(scope: "visual")o con esportazioni snapshot dopo ogni batch di modifiche.
Quando usare ogni primitiva
editTimelineper tagli, trim e pulizia ai confini delle parolesetSceneLayoutper cambi di composizione limitati nel tempo, incluso il DSL di layout avanzatomanageEffectsper sottotitoli, zoom e altri passaggi di effettivfxExportVideoSegmentinsieme avfxOverlayProcessedClipper round-trip di render esterniexportArtifactper file finali, snapshot, SRT ed export per intervallo
Guardrail
- Non tagliare mai a meta di una parola. Usa i confini delle parole nella trascrizione quando il timing del parlato conta.
- Rileggi lo stato del progetto prima di ritentare una chiamata mutante dopo un timeout.
- Fai combaciare i render degli overlay con larghezza, altezza, fps e durata in frame target prima di reinserirli nella timeline.
- Limita i cicli di auto-valutazione. Se i controlli visivi continuano a fallire dopo alcune passate, ispeziona direttamente il layout o i media sorgente.