Super-Video-Cut

¿Qué hace Super-Video-Cut?

Posicionamiento

Trata cada trabajo de edición como una entrega de ingeniería con una cadena de evidencia, no como un montón de clips ensamblados a ojo. Esta habilidad proporciona medición objetiva reproducible, evaluación detallada y justificada, plantillas de línea de tiempo reutilizables, control de calidad previo a la entrega y límites de copyright que recorren todo el proceso.

references/ contiene el material profundo, dividido por dominio de capacidad (alrededor de 50 documentos, la mayoría tablas de parámetros y especificaciones de 100 a 250 líneas). No leas todo de antemano — sigue el enrutamiento a continuación y lee solo los 1 a 3 documentos que la etapa actual necesite.

Abreviatura de volumen utilizada en todo este archivo: 09/02 significa references/09-material-memory/02-*.md.

Tres líneas rojas

Si se viola alguna de ellas, no debes entregar.

1. Estilo de referencia: evalúa primero, edita después. Cuando el usuario proporcione un video de referencia, debes completar la evaluación tridimensional (arte de edición / sonido / escena) con una justificación detallada para cada entrada y obtener la confirmación del usuario antes de tocar la línea de tiempo. Producir una edición sin esa confirmación cuenta como retrabajo.
2. Metraje: verifica la caché antes de recurrir a un modelo. Antes de analizar cualquier material de video, ejecuta material_cache.py lookup. Si hay coincidencia, lee la tarjeta de descripción del material directamente — está prohibido llamar a un modelo de video para volver a mirar; solo si no hay coincidencia realizas un análisis completo y lo registras.
3. El cumplimiento y el control de calidad son lo primero. No edites un plan cuyo riesgo de copyright no esté determinado y no entregues un archivo terminado que qc_scan.sh no haya aprobado. El volumen legal es material de referencia, no asesoramiento legal; para proyectos comerciales o de alto riesgo, dile al usuario que lo revise un abogado.

Flujo de trabajo principal M0–M6

Etapa	Objetivo	Debe leer	Salida
M0 Ingreso	Fijar parámetros ejecutables	Este archivo	Brief
M1 Ingreso de metraje	Nunca pagar los mismos tokens dos veces	09/02 + scripts/material_cache.py	Tarjeta de material o acierto de caché
M2 Evaluación de estilo	Convertir "una sensación" en parámetros	08/02 + 08/03 + scripts/reference_probe.sh	Hoja de evaluación + huella digital + conclusión de una página
M3 Plan de edición	Huella digital → línea de tiempo	08/04 + el volumen de género correspondiente	Plan de segundo nivel
M4 Producción	Editar / voz / subtítulos / etalonaje	01 / 02 / 03 según sea necesario	Corte bruto y proyecto
M5 Control de calidad de entrega	Pase técnico + de cumplimiento	06/01 + 06/02 + 06/03	Informe de QC + registros de detección
M6 Retroalimentación	Producir solo candidatos, nunca cambiar reglas automáticamente	08/05	Registro de auto-mejora

M0 Ingreso: preguntar por parámetros faltantes, como máximo 3 preguntas

Debes obtener: plataforma y relación de aspecto (determina el área segura y la duración), duración total, si se necesita voz en off/doblaje, si es comercial, especificación de entrega (resolución / bitrate / contenedor).

Deduce y declara todo lo que se pueda deducir de lo que ya tienes; no interrogues al usuario elemento por elemento. Si el trabajo es comercial determina directamente qué música y metraje puedes usar — si no está claro, debes preguntar.

M1 Ingreso de metraje: la acción para cada uno de los cinco estados está codificada

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # mantén la caché dentro del proyecto, nunca dentro del directorio de la habilidad
python "$SK/scripts/material_cache.py" lookup "<ruta del metraje>"

Estado	Acción
HIT	No llames a un modelo de video. Lee $MDC_HOME/cards/<MID>.yaml y solo haz adaptación temática
MISS	Sonda E1 local → una solicitud de análisis completo usando references/09-material-memory/templates/model-analysis-prompt.md → llena la tarjeta → validate → register
STALE	El metraje cambió; marca la tarjeta antigua como superseded y repite como MISS
HIT_BLOCKED	El estado de derechos no está claro; no lo uses — resuelve los derechos primero
Interruptor de seguridad	Cuando _config.json tiene cache_enabled=false, trata todo como MISS; está prohibido omitirlo

La tarjeta de descripción tiene tres capas: L0 identidad (hash / especificaciones), L1 descripción del material (qué muestra / dónde se grabó / cuál es el estilo / si es utilizable), L2 adaptación temática (qué segundos toma este tema y qué papel narrativo desempeñan). "Funciona bien como apertura para el tema X" pertenece solo a L2 — ponerlo en L1 contamina todos los demás temas.

El campo de ubicación es una regla estricta: sin texto en pantalla, un punto de referencia o un registro de grabación, establece place_name: null. Nunca infieras una ciudad a partir de "hay mar y una palmera".

M2 Evaluación de estilo: seis pasos siempre que el usuario proporcione un video de referencia

S1 verificación previa de cumplimiento → S2 sonda objetiva → S3 dos visionados completos → S4 evaluación dimensión por dimensión
→ S5 conclusión de una página → S6 ★puerta de confirmación del usuario★

• S1 Analiza solo, nunca reutilices su expresión. Los títulos de apertura y cierre, el diálogo, la música, el texto cinético y la puesta en escena están todos etiquetados como protected: expression.
• S2 Ejecuta el script de sonda para obtener números reproducibles (puntos de corte, duraciones de planos, sonoridad, silencio, estadísticas de color, hojas de contacto).
• S3 Ve el video completo dos veces: una vez solo para la imagen, una vez solo para el sonido. Saltar a velocidad pierde el ritmo y las pausas mantenidas — este es el error metodológico más común.
• S4 Evalúa elemento por elemento en los tres grupos principales — A arte de edición / B sonido / C escena (10 sub-elementos cada uno) — más D subtítulos, E narrativa, F contexto de la plataforma y G límite de cumplimiento (obligatorio).
• S5 Entrega una conclusión de una página: 3 características clave, 3 elementos no transferibles, confianza general.
• S6 Entrégala al usuario para confirmación. Sin esa confirmación no puedes entrar en M3.

Cada entrada de evaluación debe llenar las cinco partes; una parte faltante invalida toda la entrada:

① Observación (código de tiempo + fenómeno concreto) ② Base (ID de evidencia) ③ Inferencia (por qué se diseñó así) ④ Elemento de acción (cómo lo usa esta edición) ⑤ Confianza (alta/media/baja + motivo)

Contraejemplo (nunca debe ser emitido): "La edición es fluida y muy cinematográfica." — sin código de tiempo, sin base, sin elemento de acción, nada ejecutable.

Cada elemento de acción debe llevar una etiqueta de transferencia: transferable: parameter (ritmo, duración, sonoridad, secuencia de tamaño de plano — aprendible) o protected: expression (planos específicos, diálogo, música, texto cinético — no reproducible). El estilo y la fórmula residen en el ámbito de las ideas y pueden tomarse prestados; la expresión no puede copiarse. Ese es el piso de copyright de esta habilidad, no una sugerencia.

M3 Plan de edición: traduce la huella digital a una línea de tiempo de segundo nivel

Lee las reglas de mapeo en 08/04 y produce una línea de tiempo directamente ejecutable: punto de entrada/salida para cada clip, tamaño de plano, tipo de transición y duración en fotogramas, puntos de inserción de efectos de sonido, puntos de entrada/salida de subtítulos y objetivo de sonoridad.

Orden de resolución de conflictos: solicitud explícita del usuario > límites duros de la plataforma > características del video de referencia > estética predeterminada. Cuando el metraje no pueda soportar algo, dilo claramente — "la referencia usa la técnica X; este proyecto no tiene metraje coincidente, por lo que Y la reemplaza" — en lugar de forzarlo.

M4 Producción: lee exactamente un volumen por acción actual

Haciendo	Lee
Ritmo, transiciones, eje	01/01, 01/02
Organización del proyecto, proxies, conform, entrega	01/03
Etalonaje, Log/LUT, HDR	01/04
Grabación de voz, entrega, ADR	02/01
Mezcla, sonoridad, EQ/compresión	02/02
Banda sonora, efectos de sonido, diseño de sonido	02/03
Voz IA, TTS, SSML	02/04
Diseño y duración de subtítulos	03/01
Formatos SRT/VTT/ASS/TTML	03/02
Transcripción, alineación, quemado	03/03
Multilingüe, CC/SDH, accesibilidad	03/04
Cómo editar un género específico	04/01–04/06

Anclajes de sonoridad (tabla completa de objetivos en 02/02): streaming alrededor de −14 LUFS, podcast/Apple alrededor de −16 LUFS, radiodifusión EBU R128 a −23 LUFS, con True Peak generalmente requerido a ≤ −1 dBTP. Remítete a la documentación oficial de la plataforma de destino; si no estás seguro, mide primero, luego decide.

M5 Control de calidad de entrega: ejecuta el script primero, luego juzga como humano

bash "$SK/scripts/qc_scan.sh" "<archivo terminado>" "<directorio de salida>"

Una ejecución produce un JSON de especificaciones, integridad de decodificación, detección de fotogramas negros/congelados, silencio, sonoridad y una hoja de contacto. El script solo puede encontrar anomalías técnicas — el contenido y el cumplimiento deben revisarse manualmente con las tablas:

• 06/01 lista de verificación de especificaciones técnicas (resolución / velocidad de fotogramas / color / bitrate / pistas de audio / duración / nombre)
• 06/02 revisión de contenido y cumplimiento (hechos, contenido sensible, afirmaciones publicitarias prohibidas, documentación de derechos)
• 06/03 plantillas de llenado de Tablas A–G (para el archivo)

Gravedad de QC: los elementos bloqueantes (fotogramas negros, pista de audio faltante, sonoridad fuera de tolerancia, riesgo de infracción) deben corregirse; los elementos de mejora pueden enviarse una vez registrados; los elementos de sugerencia esperan a la siguiente versión.

M6 Bucle de retroalimentación: un video exitoso nunca cambia una regla

Una vez que llega la retroalimentación real (tasa de finalización, conversión, notas del cliente), haz la atribución de errores según 08/05 y escríbela en 08/case-library/<CASE-ID>/self-improvement-record.md.

Regla estricta: un caso único produce candidatos solamente; un cambio entra en vigor solo después de ≥5 muestras en la misma dirección, un conjunto de regresión congelado, aprobación humana, versionado y un lanzamiento canario. El motor de auto-mejora no debe reescribir automáticamente los campos objetivos E1/E2 de una tarjeta de descripción de material — la caché propagaría un error a todos los temas posteriores, mientras que los registros de aciertos aún se verían perfectamente normales.

Ruta más corta una vez activado

El usuario dice	Haz esto
"Edita algo al estilo de este video viral"	Flujo M2 completo → puerta de confirmación S6; no empieces a editar
"Edita este video para mí"	M0 preguntar plataforma/duración/comercial → M1 metraje → M3 plan
"¿Este metraje es utilizable, qué muestra?"	M1 lookup; responde directamente si HIT, analiza solo si MISS
"Añade subtítulos"	03/01 diseño + 03/03 transcripción y alineación; verifica velocidad de lectura y duración mínima
"La voz en off suena mal"	02/01 grabación → 02/02 cadena de procesamiento → mide la sonoridad
"Exporta para Douyin / WeChat Channels / Bilibili"	04/01 especificaciones de plataforma + 06/01 verificación de entrega
"¿Esto infringiría algo?"	05/02 árbol de decisión + dimensión G en 08/02; da un nivel de riesgo, no una opinión legal concluyente
"¿El corte terminado está bien?"	qc_scan.sh + 06/01 / 06/02 elemento por elemento

Scripts

Script	Propósito	Dependencias
scripts/material_cache.py	Huella digital de metraje, búsqueda en caché, registro, reutilización, validación, estadísticas (8 subcomandos)	Python 3, sin paquetes de terceros
scripts/reference_probe.sh	Sonda objetiva de un archivo de referencia o metraje: puntos de corte, duraciones de planos, sonoridad, silencio, color, hojas de contacto	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	QC técnico de un archivo terminado: especificaciones, decodificación, fotogramas negros, congelados, silencio, sonoridad, hoja de contacto	bash + ffmpeg/ffprobe

Verifica el entorno primero: ffmpeg -version && ffprobe -version && python --version. Sin ffmpeg, toda medición objetiva no está disponible — en ese caso, dile al usuario claramente que solo es posible la evaluación manual y que no se pueden dar métricas reproducibles. Nunca fabriques números.

Autoverificación previa a la entrega

• La referencia pasó por S1–S6 y el usuario confirmó (si se usó una referencia)
• Cada pieza de metraje se puede rastrear en la caché hasta su origen y estado de derechos
• No aparecen frases no admitidas como "fluido", "premium" o "texturizado" en la evaluación o el plan
• La sonoridad se ha medido y está dentro de la tolerancia objetivo; True Peak está por debajo del límite
• Los subtítulos no desbordan el área segura, no contienen errores tipográficos y cumplen con el límite de velocidad de lectura
• qc_scan.sh no informa elementos bloqueantes y las Tablas A–G están completas
• La documentación de derechos de música / fuentes / imagen / material de archivo está completa, o se indica el nivel de riesgo
• El nombre del archivo de entrega, el contenedor y el bitrate coinciden con los requisitos de la plataforma

Alcance del material (debe indicarse al usuario)

• El volumen legal no es asesoramiento legal. Los artículos y las posiciones judiciales cambian; para proyectos comerciales o de alto riesgo, haz que un abogado lo revise y confía en el texto oficial más reciente.
• Los parámetros de la plataforma cambian. La duración, el bitrate, el área segura y los objetivos de sonoridad entran en conflicto entre fuentes, por lo que siempre están marcados como "sujetos a la documentación oficial más reciente de la plataforma" — sube y previsualiza para verificar antes de la entrega.
• Los parámetros de auto-mejora no tienen un estándar de la industria. η, δ, N_min y el resto en el volumen 08 son valores iniciales propios de esta biblioteca; existen para que el proceso sea ejecutable, no porque sean óptimos validados.
• Alrededor de 190 elementos "PARA VERIFICAR" están detallados en el cuerpo o al final de cada documento, concentrados en references/00-overview/sources-and-reliability.md (con grados de evidencia A/B/C/D y prioridades P0/P1/P2). Verifica el grado de evidencia de ese archivo antes de citar algo.

Enrutamiento e índices

• references/INDEX.md — ruta más corta y lectura mínima requerida por etapa o tarea
• references/00-overview/knowledge-map.md — mapeo completo de dominio de capacidad y búsqueda rápida de solución de problemas
• references/00-overview/sources-and-reliability.md — grados de evidencia, lista de fuentes, elementos PARA VERIFICAR
• references/00-overview/manifest.csv — índice de archivos legible por máquina

Al buscar en un archivo grande, localiza por palabra clave en lugar de leerlo de principio a fin, por ejemplo, grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md.