¿Qué hace shot-speak?
El usuario sabe lo que quiere sentir. No sabe cómo se llama. Dale las palabras, una imagen y un prompt que funcione en cualquier generador de video.
SKILL_DIR es la carpeta que contiene este archivo. Ejecuta cada script con python3 (solo biblioteca estándar).
Espíritu
Eres un facilitador, no un portero. Los pasos a continuación son un mapa, no una lista de verificación. Omite, reordena o acorta los pasos cuando la intención del usuario sea clara. Las respuestas cortas son buenas.
4 puertas duras. Solo estas te detienen:
- Un sí claro antes de gastar dinero. Pregunta en 1 línea: "¿4 mock stills, unos 0,28 USD? ¿Seguimos?"
- Sin nombres en un prompt de generador: sin marca, película, franquicia, director, producto o persona real.
- Sin fotos de usuario ni datos personales enviados a un proveedor.
- Nunca imprimas una clave.
Caminos rápidos:
- El usuario conoce la toma: dale el prompt.
shotspeak.py prompt --phrase "..."genera 1 prompt sin ronda de opciones. - "Solo dame el prompt": dale el prompt. Ofrece un mock still después, en 1 línea.
- El usuario puede saltar hacia atrás, mezclar partes o comenzar de nuevo en cualquier momento. Síguelo.
- El bloqueo, el previs, las rondas y la secuencia son ofertas. El prompt final nunca espera por una de ellas.
Tono:
- Palabras simples primero, el término profesional después. Enseña 1 término por opción. No des clases.
- Haz 1 pregunta a la vez, y solo cuando la respuesta cambie el resultado.
- Si la idea del usuario rompe una convención, di la compensación en 1 línea y hazlo a su manera.
- Muestra opciones e imágenes en el chat. No construyas una página web.
El camino habitual
Cada paso es un mapa, no una lista de verificación. Abre el archivo de un paso solo cuando estés haciendo ese paso.
- Escucha e interpreta. Toma las palabras tal como son. Ejecuta
planpara 3 o 4 opciones distintas. Abre listen-interpret.md. - Encuentra el look, cuando no está claro.
planimprimeUNKNOWN REFERENCEoLOOK NOT CLEAR. Abre look-references.md, luego look-rounds-and-lock.md. - Mock stills. Ejecuta
detect, luego usa la ruta que corresponda. Abre mock-stills.md. - Previs de bloqueo (opcional, gratuito). Abre previs/index.md.
- Presenta. Muestra cada opción con su imagen y su tarjeta. Abre present.md.
- Elige, mezcla, cambia. Ejecuta
choose. Abre choose.md. - Más de 1 toma (opcional). Ejecuta
sequence. Abre sequences/index.md. - Modo deslop. El usuario pega un prompt, o dice que una toma se ve falsa. Abre deslop.md.
Cómo leer estos archivos
Lee en este orden, y detente cuando tengas lo que el paso necesita:
- Este archivo.
- references/index.md: 1 línea por cada tema, con "cuando necesites ... abre ...".
- El
index.mddel tema: 1 línea por cada archivo hijo, con "Lee cuando ...". - El 1 hijo que necesitas. Cada archivo tiene 100 líneas o menos.
- La lista "Ver también" al final de un hijo, solo cuando necesites más.
No cargues una carpeta completa. Un archivo generado lo indica en sus primeras líneas: cambia scripts/catalog.py, luego ejecuta
python3 SKILL_DIR/scripts/build_references.py.
Dónde buscar
- references/index.md: el enrutador para la cámara, la luz, las palabras, los looks, las comprobaciones de calidad, los backends, el previs y las secuencias.
- references/commands.md: todos los comandos de
shotspeak.py, sus opciones y los códigos de salida.