/video-review
Una ronda de revisión: recopilar todo el lote, consolidarlo por video, corregir cada video que tenga notas al mismo tiempo, verificar cada resultado tú mismo, entregar las siguientes versiones, informar.
Por qué en lote y en paralelo: en la producción de la que provienen estas habilidades, llegaron tres notas con cinco minutos de diferencia y el agente comenzó a corregir la primera en su propio contexto. El contexto se llenó, el revisor tuvo que detenerlo y dijo que gestionar las notas una por una no era eficiente. Al consolidarlas en una sola tabla y asignarlas a tres subagentes en paralelo, las mismas tres correcciones se revisaron y entregaron 70 minutos después. Una corrección nunca es solo un renderizado: edición, narración, renderizado, QA y el informe tomaron de 50 a 90 minutos por video, por lo que las correcciones en serie se multiplican.
0. Configuración
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"
Encuentra el producto (el product.yaml más cercano por encima del directorio actual) y lista sus videos con su versión actual y estado de entrega (skills/video-build/scripts/stages.py en cada uno).
1. Obtener todo el lote
Si el argumento es un archivo, léelo; si es texto, úsalo. Luego pregunta una vez: "¿Estos son todos los comentarios para esta ronda, para cada video? Los videos sin notas se quedan como están." Espera la respuesta antes de corregir nada. Si siguen llegando notas mientras consolidas, agrégalas a la misma ronda; no inicies una corrección por mensaje.
2. Consolidar en una tabla por video
"$PY" "$PVS_HOME/skills/video-review/scripts/feedback_table.py" <directorio_producto> <archivo_notas o -> \
--out <directorio_producto>/reviews/ronda-<fecha>.md
Ordena cada nota, textualmente, debajo del video que nombra (por id, título o encabezado), coloca las notas sobre "todos los videos" en una sección compartida y lista las notas que no puede ubicar. Luego completa, por fila: Significado (tu interpretación, incluyendo lo que no debe cambiar), Aceptación (cómo lo verificarás: un rango de tiempo, una tira, un fotograma) y ¿Regla para todos los videos?
Lee references/review-protocol.md antes de completarlo: cubre errores de dictado, notas que en realidad son reglas y notas que entran en conflicto con el producto.
Tres preguntas que hacer a cada nota:
- ¿Es realmente una regla? Entonces se aplica a todos los videos de esta ronda, no solo a aquel al que el revisor señaló. Un revisor dio una regla de cobertura en un video y tuvo que pedir, horas después, que se aplicara a todos.
- ¿El producto realmente lo hace? Revisa el código antes de prometer una corrección. Si no, una pregunta cerrada con una opción recomendada ("mostrar solo lo que existe").
- ¿Es una característica que faltaba en COVERAGE.md? Entonces la corrección agrega la fila.
Muestra las tablas consolidadas al usuario con un máximo de tres decisiones cerradas (con valores predeterminados indicados). El silencio significa los valores predeterminados. Los videos sin notas se enumeran como intactos.
3. Abrir la siguiente versión de cada video con notas
"$PY" "$PVS_HOME/skills/video-review/scripts/bump_version.py" <directorio_video> --note "<cita>" ...
Hace una copia de seguridad de lines.tsv, timings.json y video/src como v, aumenta la versión de BRIEF a N+1 y abre una sección de changelog con las citas. Se niega cuando v nunca se renderizó (eso saltaría una versión). El renderizado de v permanece intacto: es la referencia de paridad, y un archivo que el revisor pueda haber compartido nunca se sobrescribe.
4. Un subagente de corrección por video, todos a la vez
Completa references/fix-prompt.md para cada video (las palabras textuales del revisor, tu significado y aceptación, lo que ya encontraste en el código con archivo:línea, las reglas compartidas) y lanza cada corrector en el mismo turno con la herramienta Agent, en segundo plano. Realiza las búsquedas de código que alimentan "lo que ya encontré" tú mismo antes de lanzarlos, brevemente; le ahorran a cada corrector la misma búsqueda y detectan notas que el producto no puede satisfacer.
Mientras se ejecutan, no corrijas nada tú mismo ni los molestes con mensajes. Supervisa archivos (stages.py, tiempos de modificación, registros de renderizado). Si un corrector necesita una aprobación, haz al usuario una pregunta cerrada y transmite la respuesta. Si un corrector se detiene, inicia uno nuevo con el mismo mensaje más dónde se detuvo: el estado está en los archivos.
5. Verificar cada resultado tú mismo
Para cada video, independientemente de lo que haya informado el corrector:
- Paridad con respecto a la versión anterior, fuera de los tramos que cambiaron intencionalmente:
"$PY" "$PVS_HOME/skills/render-qa/scripts/parity.py" <mp4 antiguo> <mp4 nuevo> --skip a:b .... Un tramo aprobado que cambió es una regresión: devuélvelo. - QA:
"$PY" "$PVS_HOME/skills/render-qa/scripts/qa.py" <directorio_video> <mp4 nuevo> --strip ...con tiras en cada compás cambiado. Cargarender-qapara saber cómo leerlo; mira las hojas y tiras tú mismo. - La verificación de aceptación de cada nota de tu tabla. Una nota que el renderizado no satisface regresa al mismo corrector (SendMessage: el problema, el rango de tiempo, "no cambiar nada más").
- La sección de changelog en BRIEF.md se completa.
6. Entregar y cerrar la ronda
"$PY" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <directorio_video> <mp4 nuevo> --archive-previous
Luego cierra la ronda, todo junto: las notas que se convirtieron en reglas van a kit/RULES.md (con la fecha y las palabras del revisor) para que la próxima compilación las herede; cada changelog de BRIEF está completo. Un archivo de reglas que deja de actualizarse se vuelve incorrecto, y las reglas luego se repiten manualmente en cada prompt. Si el revisor ya subió versiones anteriores en algún lugar, indica qué archivos deben subirse nuevamente.
7. Informe
| Video | De | A | Notas aplicadas | Dónde verlo | Paridad | QA | Entregado como |
|---|
Luego: videos intactos, reglas añadidas a kit/RULES.md, cualquier cosa no verificada, un máximo de tres decisiones cerradas. En el idioma del usuario, breve, tablas primero.
Referencias
references/review-protocol.md: antes de completar las tablas consolidadas.references/fix-prompt.md: antes de lanzar los correctores.