Communitygithub.com

Collage Video Studio

Habilidad para la producción de video estilo collage de papel con capacidad de reanudación, auditoría, backends de medios reales, control de calidad, recuperación y empaquetado.

¿Qué es Collage Video Studio?

Collage Video Studio es una habilidad profesional para la producción de videos animados en estilo collage de papel, diseñada para ser reanudable, auditable y gestionar flujos de trabajo complejos. Soporta la creación de proyectos desde una idea, la reutilización de metraje existente o el uso de una foto como ancla, con backends reales de proveedores de medios (como Replicate) y un sistema de control de calidad (QA) integrado. La habilidad organiza el proyecto en archivos estructurados (project.json, state.json, manifests JSONL) y directorios (media/, qa/, reports/, exports/), permitiendo pausar, reanudar, crear puntos de control y revertir cambios. Utiliza un sistema de puertas (gates) para aprobar la historia, la dirección visual y la producción final, con referencias detalladas sobre estándares de producción, composición, dirección de movimiento y contratos semánticos. Está optimizada para plataformas como Claude Code y Cursor, y requiere la ejecución de scripts de Python para la orquestación de trabajos, la validación y el empaquetado, asegurando que cada producción cumpla con estándares profesionales de calidad, consistencia y auditabilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add DingYi1024/collage-video-studio

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Collage Video Studio?

Dirige una producción como un proyecto reanudable. Mantén la intención creativa en project.json, los resultados generados en state.json, la ejecución del proveedor detrás de manifiestos JSONL y los resultados derivados en media/, qa/, reports/ y exports/.

Enrutar la solicitud

Lee la conversación e inspecciona cualquier directorio de proyecto suministrado antes de preguntar por información que el usuario ya haya proporcionado.

Intención del usuarioAcción
Iniciar, hacer, crearInicializar y redactar la historia
Continuar, reanudar, qué sigueEjecutar project_ops.py next y ejecutar su acción única
Estado, bloqueado, fallidoEjecutar studio.py status --verbose, luego diagnosticar la unidad más pequeña
Guardar, punto de controlCrear un punto de control inmutable del proyecto/estado
Volver atrás, restaurarListar puntos de control; restaurar solo el seleccionado por el usuario
Auditar, verificar, listo para publicarEjecutar QA técnico, luego revisión creativa humana
Reportar, empaquetar, entregarGenerar un informe fundamentado y un archivo portátil
Agregar o cambiar proveedorLeer el contrato del backend e implementar un adaptador

Si no existe ningún proyecto o resumen utilizable, preguntar solo por la idea/fuente, la duración objetivo y el idioma. Usar --aspect auto a menos que el usuario o la plataforma de destino ya fijen el fotograma. Mostrar la resolución de aspecto y la razón en la primera revisión del mapa de ritmos.

Seleccionar el modo de entrada

  • topic: crear narración e imágenes a partir de una idea.
  • footage: re-estilizar un video de actuación existente manteniendo la sincronización y el audio original.
  • photo: anclar una foto real de retrato o producto en escenas generadas.

Nunca alterar la foto o el video original.

Inicializar

Ubicar este directorio de habilidad, luego ejecutar:

python scripts/studio.py doctor
python scripts/studio.py init <project-dir> --mode topic \
  --topic "<topic>" --duration 30 --aspect auto --language zh

Leer:

  • production-standard-v6.md primero para cada nueva producción de portafolio; hace obligatorio el film formal de Remotion, la procedencia de producción, la diversidad de toda la película, la dirección responsiva, la prueba de acción y la prueba de composición de todo el proyecto;
  • production-protocol-v5.md primero para cada nueva producción; vincula escenarios, storyboard, familias de fuentes, gasto del proveedor, sincronización, revisión, prueba e invalidación en tiempo de ejecución;
  • story-system.md antes de escribir beats;
  • visual-system.md antes de escribir temas o indicaciones;
  • layered-motion.md cuando se requiera mover capas de forma independiente o paralaje determinista;
  • advanced-layer-primitives.md antes de crear familias de fuentes registradas, secuencias de poses, visibilidad persistente, tiras de bucle o campos de motivos con semilla;
  • editorial-composition.md antes de crear grupos recursivos, gráficos de texto/datos editables, paralaje acoplado a la cámara o planes de director responsivos;
  • semantic-contracts.md antes de generar una identidad nombrada, topología espacial, explicación de mecanismo o infografía;
  • quality-gates.md antes de aceptar recortes o escenas compiladas;
  • responsive-direction.md cuando se entregue más de una relación de aspecto;
  • provider-lifecycle.md antes de la generación paga, rechazo, recuperación, sustitución o reutilización deliberada de artefactos;
  • production-profiles.md antes de la generación paga; define mínimos de borrador/equilibrado/profundidad completa, presupuestos exactos de intentos, huellas digitales de artefactos e invalidación de QA;
  • directed-motion.md antes de animar una toma en capas de grado de portafolio; define la acción primaria, la causa física, la sincronización de tres fases, la densidad y las pausas;
  • motion-audit.md al agregar capas seguidoras, bloqueos de contacto o verificar saltos de transformación antes de la entrega;
  • smooth-keyframes.md antes de animar personas u objetos cuando la reproducción fluida importa más que el realismo anatómico;
  • articulated-rigs.md cuando una persona, animal o mecanismo necesite movimiento conectado de hombro, codo, ala, rueda o bisagra;
  • locomotion.md antes de mover la raíz de un personaje articulado a través del cuadro; define pies plantados alternos y revisión del ciclo de marcha de cuerpo completo;
  • production-standard.md para animación en papel de grado de portafolio, poses creadas, voz natural y calidad de video social;
  • production-closure.md para el editor de Remotion, cuadros exactos liderados por narración, ejecución semántica, pilas de profundidad registradas y tres tipos de prueba;
  • voice-continuity.md antes de escribir, generar o aprobar narración;
  • delivery-qa.md antes de renderizar o diagnosticar movimiento entrecortado, colas de toma congeladas o sonoridad de la mezcla final;
  • aspect-direction.md antes de fijar paisaje o retrato;
  • project-schema.md al editar archivos o backends;
  • operations.md al reanudar, recuperar o ejecutar trabajos;
  • replicate-backend.md para el backend de producción incluido;
  • acceptance.md antes de reclamar finalización.

Puerta 1 — aprobar la historia

Completar creative.arc, beats y shots.

Antes de la aprobación, compilar exactamente tres escenarios, aprobar un tope exacto y compilar el storyboard rítmico:

Primero registrar la ficha de estilo versionada, el aspecto y la decisión de admisión de paralaje:

python scripts/intake.py choose --aspect <16:9|9:16|1:1> \
  --style <style-id> --parallax <none|restrained|cinematic> \
  --note "<human decision>" --output <project-dir>/build/intake-decision.json
python scripts/production_protocol.py scenarios project.json \
  --output build/scenarios.json
python scripts/production_protocol.py approve build/scenarios.json <profile> \
  --note "<human decision>" --output build/scenario-decision.json
python scripts/production_protocol.py storyboard project.json \
  build/scenarios.json build/scenario-decision.json \
  --output build/storyboard.json

Copiar el tope seleccionado en production.approved_visual_attempt_cap. El perfil es tanto un techo como un piso de ejecución. No gastar la reserva de recuperación automáticamente.

  • Hacer que la apertura sea comprensible en tres segundos.
  • Dar a cada beat una afirmación o giro emocional.
  • Declarar contratos semánticos para identidad, topología, mecanismo y afirmaciones infográficas.
  • Dar a cada afirmación factual un momento de prueba dentro del beat que la presenta.
  • Dar a cada escena al menos tres fases de ritmo contiguas y momentos de establecimiento, acción/pico y prueba final; la prueba final se mantiene en o después de 0.82 normalizado.
  • Vincular el sonido crítico y la acción visual a la misma identificación de prueba en un catálogo de eventos.
  • Establecer transition_intent desde revelar, comparar, atravesar, explicar, enfatizar, cambiar-tiempo o cambiar-lugar; dejar que el compilador elija un mecanismo consistente.
  • Preferir contexto más detalle: dos tomas variadas por beat narrado.
  • Mantener las tomas de producción ordinarias entre 3 y 6 segundos.
  • Escribir element_motion concreto; no usar "hacerlo dinámico".
  • Para trabajo de capas dirigidas, agregar shot.direction.primary_action, physical_cause y motion_density. Una toma obtiene una acción primaria legible.
  • Para footage, establecer beat start_s y end_s.
  • Para una foto, definir source.anchor_policy.

Ejecutar:

python scripts/studio.py validate <project-dir> --stage story

Mostrar el mapa de ritmos al usuario. No generar medios antes de la aprobación. Después de la aprobación:

python scripts/studio.py approve <project-dir> --gate story --note "user approved"
python scripts/project_ops.py checkpoint <project-dir> --note "story approved"

Puerta 2 — aprobar la dirección visual

Crear exactamente tres candidatos bajo creative.candidate_themes. Hacer que difieran en medio, paleta, tipografía, textura, composición y carácter de movimiento.

python scripts/studio.py jobs <project-dir> --stage styles

Ejecutar cada vista previa en el mismo beat representativo y registrar cada resultado. Mostrar los tres juntos. Después de que el usuario elija:

python scripts/studio.py choose-theme <project-dir> <theme-id>
python scripts/studio.py approve <project-dir> --gate style --note "user approved"
python scripts/project_ops.py checkpoint <project-dir> --note "visual direction approved"

Nunca sustituir silenciosamente una relación de aspecto no soportada.

Producir medios

Para cada etapa:

python scripts/studio.py jobs <project-dir> --stage images
python scripts/job_runner.py <project-dir> --stage images \
  --adapter <adapter.py> --dry-run
python scripts/job_runner.py <project-dir> --stage images \
  --adapter <adapter.py> --retries 1

Los proyectos nuevos de topic y photo usan por defecto movimiento de capas determinista. Usar generación de imagen-a-video solo cuando el usuario valore explícitamente la deformación creada por el modelo sobre la editabilidad y repetibilidad; repetir las etapas de medios para motion, voice y music.

Cuando la solicitud requiera objetos de papel que se mueven de forma independiente, paralaje editable o control explícito de primer plano/medio/fondo, establecer motion.pipeline en layered, luego ejecutar:

python scripts/studio.py jobs <project-dir> --stage layers
python scripts/job_runner.py <project-dir> --stage layers --adapter <layer-aware-adapter.py>
python scripts/studio.py jobs <project-dir> --stage motion
python scripts/job_runner.py <project-dir> --stage motion --adapter <layer-aware-adapter.py>

Leer layered-motion.md para el contrato de PNG transparente y layers.json. No representar un fotograma clave aplanado con zoom o panorámica de cuadro completo como movimiento de múltiples capas. Para una entrega suave, todos los proyectos de producción nuevos usan 30 fps por defecto. Mantener motion.frame_conversion: "auto" para que los clips del proveedor por debajo del objetivo sean interpolados en lugar de rellenados con fotogramas duplicados. Usar curvas continuas para fotogramas clave interiores, escalonar objetos en bucle con phase_s e inspeccionar el MP4 en lugar de un GIF de baja velocidad de fotogramas. Usar sobremuestreo 2× cuando el movimiento lento muestre un paso de un píxel. El modo footage omite images y layers; el modo footage que conserva el audio original omite voice.

Para medios creados por una herramienta de imagen del lado del anfitrión, reservar la llamada antes de la generación y completar o rechazar el intento exacto después:

python scripts/external_media.py reserve <project-dir> image:<source-id> \
  --provider <provider> --model <model> --prompt "<exact production prompt>"
python scripts/external_media.py complete <project-dir> <attempt-id> <output-file>
python scripts/external_media.py reject <project-dir> <attempt-id> \
  --reason "<review failure>"

No copiar una salida de anfitrión no registrada directamente en un paquete de capas. La producción de portafolio acepta solo fuentes derivadas generadas por el proveedor, suministradas por el usuario, licenciadas, encargadas o vinculadas a huellas digitales. placeholder: true siempre bloquea la entrega.

Para trabajo editorial, crear una composición recursiva y compilar planes de director separados:

python scripts/editorial_contract.py composition.json \
  --kind composition --output result/manifests
python scripts/asset_quality.py result/manifests/composition-9x16.json \
  --mode composition

No recortar un diseño apaisado a retrato. Reubicar título, sujeto, datos, anotaciones y papeles de fondo a través de anulaciones de nodo. Validar zonas seguras y ajuste de texto editable para cada aspecto. Usar primitivas locales de vector/texto/gráfico cuando el contenido deba permanecer exacto y editable. Usar data-svg para rutas, curvas, etiquetas y marcas estructuradas. Dar a las anotaciones exclusiones explícitas; el compilador debe encontrar una posición sin colisiones en todas las anotaciones o detenerse.

Para viaje horizontal sostenido, crear un looping-environment y ejecutar world_motion.py. Requerir tiras de fondo/suelo, velocidad de profundidad creciente, anclajes de participantes de pantalla/mundo, oclusión de capa cercana, tres planes de aspecto, evidencia de costura y trayectorias firmadas compensadas por cámara. Leer production-standard-v6.md y production-protocol-v5.md.

Declarar source_packages acoplados antes del uso del proveedor. El movimiento relativo trasero/sujeto/frontal requiere una familia registrada completa y sobres de revelación para 16:9, 9:16 y 1:1. Derivarlo con registered_family.py; nunca generar o reemplazar un miembro aislado. Observar el plano clave nativo e intacto del proveedor antes de la eliminación de croma y retener su fuente, política y huellas digitales de observación.

Inspeccionar y editar el mismo manifiesto en el espacio de trabajo real de Remotion:

cd workspace
npm ci
npm run dev

El reproductor debe conservar grupos recursivos, profundidad, fotogramas clave, puntos de edición, secuencias de estado, visibilidad persistente, énfasis transitorio, tiras de bucle, campos de motivos, momentos de prueba, enlaces audiovisuales y el plan de director seleccionado. Validar con npm run build y npm run render antes del lanzamiento.

Para trabajo pulido, establecer motion.directed_motion en true y seguir directed-motion.md. No animar cada capa para cumplir una cuota. Declarar las capas primarias, la causa física, las fases de anticipación/acción/asentamiento y cualquier pausa de lectura intencional. Una cara, piso, horizonte o mesa normalmente debe permanecer estable mientras la evidencia se mueve. Usar ease de llegada por fotograma clave cuando la anticipación y el asentamiento necesiten una sincronización diferente.

Adjuntar ruedas, partes articuladas, llamas, ropa y otras respuestas secundarias motivadas con follow; heredar solo las propiedades parentales que comparten físicamente. Declarar direction.secondary_responses y bloquear propiedades plantadas o aterrizadas con direction.contacts. Ejecutar

... [truncated for translation]

Skills relacionados