Workflow Primitive-First
ScreenKite garde le montage agentique simple : l'application expose des primitives d'edition deterministes, et votre agent prend en charge la planification, le raisonnement sur la transcription et la politique editoriale.
Boucle recommandee
- Lisez
getProjectState(scope: "summary"),getProjectState(scope: "layout")etgetProjectResources(). - Exportez une transcription lorsque le timing compte, puis planifiez les beats avant de modifier la timeline.
- Executez
setCanvas(..., dryRun: true)avant un changement de ratio etsetSceneLayout(..., dryRun: true)avant un travail de composition non trivial. - Appliquez les modifications de timeline avec
editTimeline, les changements de composition avecsetSceneLayoutet les passes d'effets avecmanageEffects. - Exportez des shorts ou d'autres ratios avec
exportArtifact(type: "range", settings.canvasOverride)au lieu de modifier le projet long. - Verifiez avec
getProjectState(scope: "visual")ou des snapshots apres chaque lot de modifications.
Quand utiliser chaque primitive
editTimelinepour les coupes, les trims et le nettoyage sur les limites de motssetSceneLayoutpour les changements de composition limites dans le temps, y compris le DSL de layout avancemanageEffectspour les sous-titres, le zoom et les autres passes d'effetsvfxExportVideoSegmentavecvfxOverlayProcessedClippour les allers-retours de rendu externesexportArtifactpour les fichiers de livraison, les snapshots, les SRT et les exports par plage
Garde-fous
- Ne coupez jamais au milieu d'un mot. Utilisez les limites de mots de la transcription lorsque le timing de la parole compte.
- Relisez l'etat du projet avant de relancer un appel mutateur apres un timeout.
- Faites correspondre les rendus d'overlay a la largeur, la hauteur, les fps et la duree en images cibles avant de les reposer dans la timeline.
- Limitez les boucles d'auto-evaluation. Si les verifications visuelles echouent toujours apres quelques passes, inspectez directement le layout ou les medias source.