Communitygithub.com

Comparación de Edición de Video

Úsalo cuando una entrega final de corte-como-código necesite una revisión estricta lado a lado contra su fuente original, incluyendo cortes, velocidad variable, corrección de color y gráficos.

¿Qué es Comparación de Edición de Video?

Esta habilidad genera un video de comparación en modo V1: original contra final basado en el tiempo de la fuente. El panel izquierdo reproduce el original continuamente, mientras que el panel derecho proyecta los píxeles finales reales sobre el reloj de la fuente original. Los rangos eliminados aparecen en negro, los rangos conservados se estiran a su duración original y el audio se copia del original sin modificar su velocidad. Es útil para revisar estrictamente que una entrega final (con cortes, velocidad variable, corrección de color y gráficos) coincida con el material original, asegurando que no haya desviaciones. Soporta plataformas como Claude Code y otras herramientas de línea de comandos que usen Python y ffmpeg/ffprobe. El script genera un plan de comparación, imágenes etiquetadas, el filtro gráfico, y verifica automáticamente la salida (duración, tamaño, muestras negras, coincidencia de fotogramas y continuidad del audio) antes de escribir un resumen de verificación aprobatorio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WhiteTowerAI/cut-as-code/tree/main/skills/video-edit-compare

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Comparación de Edición de Video?

Renderiza el modo de comparación V1 única: original-vs-final-source-time.

El panel izquierdo reproduce el original continuamente. El panel derecho proyecta los píxeles reales de la entrega final sobre el reloj de la fuente original. Los rangos eliminados aparecen en negro, los rangos conservados finales se estiran a su duración original y el audio se copia del original.

Dependencias

Requiere ffmpeg/ffprobe en el PATH y Python con Pillow. Verifícalos antes de procesar el medio.

Entradas

  • work/timeline.json: mapeo canónico cronológico de fuente a programa
  • input/original-video.mp4: fuente original
  • final/final-video.mp4: entrega real después de todas las ediciones seleccionadas

No compares contra un plan de corte o un render intermedio. Se requieren los píxeles finales para que la revisión incluya corrección de color y tarjetas.

Renderizado

python scripts/make_compare.py TIMELINE.json SOURCE.mp4 FINAL.mp4 OUT.mp4 [--filter-only]

Ejemplo de proyecto:

python skills/video-edit-compare/scripts/make_compare.py `
  work/timeline.json `
  input/original-video.mp4 `
  final/final-video.mp4 `
  review/04-edit-compare/original-vs-final-source-time.mp4

El script siempre escribe el duradero work/edit-compare/compare-plan.json. Escribe imágenes etiquetadas PIL y el filtro gráfico generado bajo el directorio desechable work/cache/. --filter-only crea el plan y los archivos de caché inspeccionables sin renderizar el video.

Reglas de Mapeo

  • Mantén los clips fuente cronológicos, no superpuestos y de una sola fuente.
  • Recorta el program_range de cada clip del video final.
  • Estíralo por la velocidad del clip para recuperar su duración source_range.
  • Inserta negro para cada espacio en el tiempo de la fuente.
  • Mapea el audio original sin reajustar su velocidad.
  • Deriva el fotograma de inicio y fin de cada parte a partir de sus límites absolutos de tiempo de fuente, luego recorta a ese recuento de fotogramas y reconstruye PTS a la velocidad de fotogramas racional de la línea de tiempo. Nunca redondees la duración de cada parte de forma independiente; el redondeo acumulativo de concatenación causa desviación en el tiempo de la fuente.

Las líneas de tiempo reordenadas, duplicadas, superpuestas, de velocidad no lineal o de múltiples fuentes no son compatibles en V1 y deben fallar en la validación.

Verificación

Después de renderizar, el script verifica automáticamente la salida completa:

  • la duración es igual a source_duration_s dentro de un fotograma;
  • el ancho de salida es el doble del ancho de la fuente;
  • cada muestra de rango eliminado es negra en el lado derecho;
  • las muestras de rango conservado coinciden con los fotogramas del programa final correspondientes;
  • el audio original permanece continuo y en el reloj de la fuente.

Al éxito, escribe review/04-edit-compare/comparison-summary.md con un resultado de verificación aprobatorio. Cuando existe work/project.json, también añade o actualiza el nodo de revisión original-vs-final-source-time, registra las revisiones exactas de la operación activa en based_on, y actualiza START-HERE.md. No crees un manifiesto de verificaciones separado.

Esta comparación es un entregable de revisión, no una vista previa predeterminada. Genérala después de que exista el render final.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

Skills relacionados