Revisión de guiones
Cada guion es un archivo markdown. El revisor lo lee en una página local y sus notas vuelven a ti como markdown. Todos los comandos son python3 scripts/script_review.py <comando>, con la ruta relativa a la carpeta de esta habilidad. Se requiere Python 3.9 o superior, sin paquetes que instalar.
El ciclo de revisión
- Guarda el guion. Escribe el contenido en un archivo temporal y ejecuta
script_review.py new --title "<título>" --body-file <archivo> --status drafted. Imprime el id del guion, la ruta del archivo y la dirección de la página. Pon una frase o latido en cada línea de la lectura, para que cada línea pueda tener su propio comentario. - Inicia la página. Ejecuta
script_review.py up, luegoscript_review.py open <id>. Dale al revisor la dirección. - Espera las notas. Ejecuta
script_review.py wait <id>en segundo plano. Imprime las notas cuando el revisor haga clic en Enviar notas y sale con código 2 después de dos horas sin envío. - Aplica las notas. Edita el archivo del guion con el cambio más pequeño que responda a cada nota. La página abierta se recarga sola y marca las líneas que cambiaron.
- Repite desde el paso 3 hasta que las notas digan "Looks good." Ese envío también mueve un borrador al estado aprobado.
Si no estabas esperando cuando se enviaron las notas, script_review.py inbox imprime cada conjunto no leído.
Reglas para revisar
- Mantén las ediciones del revisor palabra por palabra. Las líneas listadas bajo "edits (already saved to the file)" son sus propias palabras y ya están en el archivo antes de que veas las notas. Cámbiala solo cuando una nota te lo pida.
- Cambia solo lo que cubre una nota. No reescribas líneas que no tengan comentario.
- Aplica "Edits that didn't land" manualmente. La línea se movió antes del envío, así que el archivo no se modificó.
- Deja las claves del frontmatter que no estableciste. Cambia el estado con
script_review.py status <id> <estado>, no editando el archivo. - No borres un archivo de guion a menos que el revisor lo pida.
El formato del archivo
---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---
## Spoken Script
Your first line, one sentence per line.
The second line.
## Alternate hooks
Hook 2 (question): A second opening line to film.
## Caption
Anything else you keep with the script.
Copy read en la página copia la sección Spoken Script como un párrafo, luego cada gancho alternativo desde hook 2 hacia arriba como "Two. <línea>". Un archivo sin sección Spoken Script se lee completo. script_review.py read <id> imprime el mismo texto.
Otros comandos
list [--status <estado>] [--json]: cada guion con su estado y recuento de palabras.status <id> <estado>: establece un estado (idea,drafted,ready,filmed,postedpor defecto).config: la configuración en uso y la ruta del archivo de configuración.down: detiene el servidor de la página.
La configuración (carpetas, puerto, nombres de secciones, estados, nombre del revisor) y el acceso desde el teléfono mediante Tailscale se describen en el README en la raíz del repositorio.