Flujo Primitive-First
ScreenKite mantiene la edicion agentica simple: la app expone primitivas deterministas de edicion y tu agente se encarga de la planificacion, el razonamiento sobre la transcripcion y la politica editorial.
Bucle recomendado
- Lee
getProjectState(scope: "summary"),getProjectState(scope: "layout")ygetProjectResources(). - Exporta una transcripcion cuando el timing importe y planifica los beats antes de cambiar la timeline.
- Ejecuta
setCanvas(..., dryRun: true)antes de cambiar la relacion de aspecto ysetSceneLayout(..., dryRun: true)antes de trabajos de composicion no triviales. - Aplica cambios de timeline con
editTimeline, cambios de composicion consetSceneLayouty pasadas de efectos conmanageEffects. - Exporta shorts o formatos alternativos con
exportArtifact(type: "range", settings.canvasOverride)en lugar de mutar el proyecto largo. - Verifica con
getProjectState(scope: "visual")o con snapshots despues de cada lote de cambios.
Cuando usar cada primitiva
editTimelinepara cortes, recortes y limpieza en limites de palabrassetSceneLayoutpara cambios de composicion acotados en el tiempo, incluido el DSL de layout avanzadomanageEffectspara subtitulos, zoom y otras pasadas de efectosvfxExportVideoSegmentjunto convfxOverlayProcessedClippara round-trips de render externosexportArtifactpara archivos finales, snapshots, SRT y exportaciones por rango
Reglas de seguridad
- Nunca cortes a mitad de una palabra. Usa los limites de palabras de la transcripcion cuando importe el ritmo del habla.
- Vuelve a leer el estado del proyecto antes de reintentar una llamada mutadora despues de un timeout.
- Haz coincidir los renders de overlays con el ancho, alto, fps y duracion en fotogramas del destino antes de reinsertarlos en la timeline.
- Limita los bucles de autoevaluacion. Si las comprobaciones visuales siguen fallando despues de varias pasadas, inspecciona directamente el layout o el media original.