Punto de Entrada Cortar como Código
Utiliza este como el punto de entrada obligatorio para el trabajo con video en cut-as-code. El enrutamiento y la recuperación del estado del proyecto son su única responsabilidad. El skill hoja seleccionado posee las decisiones editoriales, los puntos de revisión, los scripts, los detalles de renderizado y las auto-verificaciones.
1. Iniciar desde el Estado del Proyecto
Aplica la primera fila que coincida. No evalúes filas inferiores.
| Estado | Acción |
|---|---|
| El usuario nombra una operación específica en un proyecto existente | Inspecciona solo el estado necesario para esa operación, luego carga el skill propietario. Omite la ingesta general. |
Una raíz de proyecto explícita contiene work/project.json | Lee work/project.json, work/timeline.json, y solo el plan/evidencia de la operación seleccionada. Reanuda desde el estado registrado. Si el propietario no es único, haz una pregunta solo de enrutamiento. |
| El usuario proporciona un archivo fuente o URL, sin proyecto, y un entregable claro | Carga /video-understand para inicializar el proyecto y la evidencia compartida, luego continúa con la operación solicitada. |
| No se identifica proyecto/fuente ni entregable previsto | Haz una pregunta concisa solicitando el proyecto/fuente faltante y el resultado deseado. No inicies un skill aún. |
La raíz del proyecto debe ser explícita; nunca trates la raíz del repositorio como un proyecto de video. Trata work/project.json como el único manifiesto compartido. Determina el progreso a partir del status, revision, based_on, check de la operación y el estado de renderizado, no por la presencia de directorios. No repitas trabajo verificado. Si falta una dependencia o está desactualizada, completa esa dependencia primero y luego reanuda la operación solicitada.
El enrutamiento es de solo lectura. Nunca repares, reinicies, apruebes, elimines o actives una operación mientras decides a dónde enviar la tarea.
2. Enrutar por Entregable
Haz coincidir la salida solicitada, no una palabra clave mencionada de pasada.
| Resultado solicitado | Skill propietario o flujo de trabajo |
|---|---|
| Sonda, transcripción, análisis objetivo, comprensión semántica o inicialización de nuevo proyecto | /video-understand |
| Ajustar, acortar, eliminar secciones débiles o crear un primer corte/borrador | /video-cut después de /video-understand |
| Corregir color, crear/seleccionar un look o entregar/aplicar un LUT | /video-color-grade; usa su ruta independiente solo cuando el usuario solicite explícitamente sin entrega del Protocolo del Proyecto |
| Añadir cortes visuales con tiempo de transcripción | /video-add-b-roll después de /video-understand |
| Añadir gráficos en movimiento o superposiciones semánticas animadas | /video-add-graphic-motion después de /video-understand |
| Añadir títulos, tercios inferiores, estadísticas, citas, capítulos o llamadas a la acción | /video-add-content-cards después de /video-understand |
| Añadir subtítulos, leyendas o letras de karaoke | /video-add-captions después de /video-understand |
| Comparar el original con los píxeles finales reales en el tiempo de la fuente | /video-edit-compare después de que exista la entrega principal verificada |
| Seleccionar, revisar y planificar rangos de formato corto | /video-to-shorts después de /video-understand; haz esto antes de las tarjetas de contenido y subtítulos solicitados |
| Finalizar y extraer derivados de formato corto horizontales o verticales aprobados | Reanuda /video-to-shorts después de que exista la entrega principal verificada |
| Compilar o renderizar una entrega existente del Protocolo del Proyecto | Usa build_render_plan.py y render_project.py de /video-understand después de que cada operación activa seleccionada pase su propia puerta |
Una solicitud genérica como "editar este video" no selecciona únicamente /video-cut. Haz una pregunta de enrutamiento a menos que la salida deseada esté clara a partir del estado del proyecto existente o de la solicitud circundante.
3. Orquestar Solicitudes Multi-Operación
Congela solo las operaciones que el usuario solicitó; nunca conviertas la tabla de rutas en un paquete predeterminado. Ejecuta el prerrequisito de comprensión compartida una vez. Ejecuta las operaciones de secuencia principal seleccionadas en orden canónico:
corte -> gradación de color -> b-roll -> subtítulos -> tarjetas de contenido -> gráficos en movimiento
Para una solicitud que incluya Cortos, tarjetas de contenido o subtítulos, utiliza este flujo por etapas:
/video-understand
-> /video-to-shorts solo planificación y revisión de candidatos
-> /video-add-captions
-> /video-add-content-cards
-> /video-add-graphic-motion
-> compilar y renderizar la entrega principal compartida una vez
-> /video-to-shorts finalizar y extraer derivados aprobados
Completa cualquier operación de cambio de línea de tiempo solicitada, como /video-cut, antes de la planificación de Cortos; un work/timeline.json modificado invalida la aprobación de candidatos. La planificación de Cortos escribe el estado compartido de plan/revisión y no debe crear final.mp4 ni nada bajo final/shorts/. Los subtítulos, las tarjetas de contenido y los gráficos en movimiento añaden sus propios planes compartidos y contribuciones de superposición en ese orden relativo. El mismo orden se aplica cuando solo se selecciona cualquier par: subtítulos primero, tarjetas de contenido segundo, gráficos en movimiento último. Vuelve a leer work/project.json antes de cada traspaso. No ejecutes skills hoja de forma concurrente cuando puedan escribir work/project.json, work/timeline.json, un plan de operación o artefactos de renderizado compartidos. Construye y renderiza la entrega principal una vez, después de que todas las operaciones activas seleccionadas se validen. Ejecuta /video-edit-compare y solo la fase de finalización/extracción de /video-to-shorts contra esa entrega verificada; los cortos permanecen fuera de sequences.main.operations.
Para /video-add-content-cards y /video-add-graphic-motion, reserva la cara visible y la silueta de la cabeza de cada persona primaria o en primer plano, orador, presentador, entrevistado o persona semánticamente importante para la señal completa. Las personas incidentales solo de fondo que no sean un enfoque narrativo o visual están exentas; protege los casos inciertos. Si una superposición toca una cara o cabeza protegida, reposiciónala primero, luego escálala o rediseñala; omite la señal cuando no exista una colocación compatible.
Un resultado de todas omitidas o cero señales es válido cuando el skill propietario lo permite. No inventes trabajo de relleno para mantener una operación activa.
4. Entregar y Salir
Lee el SKILL.md completo del skill seleccionado y cada sub-skill requerido antes de actuar. Para una operación, entrega una vez y abandona este punto de entrada. Para una ejecución multi-operación solicitada, ingresa un propietario a la vez; después de su auto-verificación, recupera el estado del proyecto y continúa con la siguiente operación congelada sin reabrir la ingesta.
No pidas al usuario que apruebe una ruta que ya es inequívoca. La interacción del usuario pertenece solo a entradas faltantes, ambigüedad genuina de ruta, credenciales o las decisiones editoriales/de revisión requeridas por el skill propietario. Nunca sustituyas una decisión de Agente por una decisión humana requerida a menos que el usuario la delegue explícitamente.
Ejemplo
Para "continuar este proyecto comprendido y cortado añadiendo subtítulos", lee las revisiones actuales del proyecto y la línea de tiempo, luego ingresa a /video-add-captions. No vuelvas a transcribir, volver a cortar o preguntar si los subtítulos son la ruta prevista. Una operación pendiente no relacionada no cambia la ruta, aunque una operación activa no verificada puede bloquear el renderizado final compartido y debe ser informada por el compilador.
Reglas de Fracaso
- Estado de proyecto inválido: informa el problema de validación exacto; nunca reinicialices sobre él.
- Skill hoja o prerrequisito faltante: detente y nómbralo; no lo reconstruyas de memoria.
- Ruta de proyecto/fuente faltante: pregúntalo en la única pregunta de enrutamiento.
- Salidas solicitadas conflictivas: pregunta qué entregable posee la ejecución actual.
- Cambios o artefactos existentes del usuario: consérvalos y trabaja con el estado registrado.