drama-forge

/drama-forge — Pipeline automatizada de vídeos cortos en serie

Eres el operador de una línea de producción de vídeos cortos en serie. El usuario proporciona el nombre de la serie y tú ejecutas el orquestador, automatizando todo el proceso de "guion → vídeo → locución → síntesis → puerta de calidad → actualización de estado", produciendo vídeos cortos verticales listos para publicar, y continuando automáticamente con el siguiente episodio (la consistencia de personajes + continuidad narrativa está garantizada por el archivo de estado).

Activación

El usuario invoca /drama-forge o lo menciona en lenguaje natural:

/drama-forge genera el siguiente episodio de "La resurrección de Su Wan"
/drama-forge repite los episodios 1-2 (el vídeo anterior tenía problemas de repetición)
/drama-forge genera 3 episodios en lote, drama romántico de resurrección en la antigüedad
/drama-forge ejecuta primero la autocomprobación

Comando único (intenta siempre esto primero)

cd <directorio de la skill>
python -X utf8 scripts/run_pipeline.py --series "Nombre de la serie" [parámetros]

Todos los pasos del flujo están ordenados en el código del orquestador, no ejecutes los scripts paso a paso manualmente.

Parámetro	Uso
--series NOMBRE	Nombre de la serie (obligatorio)
--to-episode N	Genera en lote hasta el episodio N
--force-episode N	Fuerza la regeneración del episodio N (rollback atómico del estado + limpieza de artefactos)
--with-bgm	Genera música de fondo AI automáticamente (music-2.6)
--genre / --directive	Género / Instrucciones adicionales para la trama
--dry-run	Autocomprobación sin coste, no llama a APIs de pago
--workdir RUTA	Directorio de trabajo (donde se encuentra series/)
--model ID	Sobrescribe el modelo LLM (por defecto abab6.5s-chat)

En Windows, python debe incluir -X utf8 (la consola GBK se rompe al imprimir caracteres chinos).

Flujo de trabajo estándar

1. Autocomprobación (obligatoria tras modificar código, sin coste): python -X utf8 scripts/run_pipeline.py --dry-run
2. Verificación de saldo: --dry-run no comprueba el saldo. Antes de generar, realiza una llamada de chat mínima para confirmar (si salta InsufficientBalanceError, se para y pide al usuario que recargue; ten en cuenta que MiniMax Video solo reconoce "saldo de la plataforma abierta", el dinero del plan de tokens no puede usarse para vídeo)
3. Generación: python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm]
4. Verificación: Tras pasar la puerta de calidad (integrada), comprueba el vídeo final en series/<nombre_serie>/episodes/epXXX.mp4 y el detalle de costes en series/<nombre_serie>/.usage.json

Puerta de calidad (integrada, se detiene automáticamente si no se supera)

Tras cada episodio se ejecuta automáticamente la verificación:

• Todos los fragmentos MD5 son diferentes entre sí (defensa directa contra accidentes de repetición de fragmentos)
• El producto final tiene flujo de vídeo + flujo de audio, duración ≥10s
• El guion contiene hook_line (gancho con texto superpuesto en el primer fotograma) + duración de escenas no uniforme (sin metrónomo)

Si la puerta de calidad falla = no se actualiza el estado, no se ejecuta el siguiente episodio, no se gasta dinero en el siguiente. Tras la corrección, se ejecuta de nuevo con --force-episode N.

Mecanismo de continuación en serie (no modifiques manualmente el archivo de estado)

• Personajes/mundo/tramas/resumen se almacenan en series/<nombre_serie>/state.json
• Cada episodio: el LLM lee el estado → genera un guion → al finalizar, se escribe de vuelta el estado (resumen/altas y bajas de tramas/estado de personajes)
• Para regenerar un episodio, usa siempre --force-episode N (rollback automático del estado + limpieza), está prohibido borrar archivos manualmente
• Nuevos personajes: coloca la imagen de caracterización (frontal/media figura/fondo de color sólido) en assets/characters/ y regístrala en state.json

Detalles completos

• references/api-reference.md — Parámetros de API probados empíricamente (no "optimices")
• references/pitfall-log.md — Incidente → causa raíz → defensa (consulta esto primero cada vez que te encuentres con un problema)
• references/quality-gates.md — Explicación de los elementos de verificación de la puerta de calidad y autocomprobación
• references/content-quality.md — Estructura dramática en cinco actos/sintaxis de gancho/principios de retención
• assets/state.schema.json — JSON Schema de state.json
• assets/series-template.json — Plantilla de inicialización para nuevas series