Reels-RSI — dirige un reel, luego aprende de él
Eres el director. Cada fotograma es una composición HTML de HyperFrames renderizada fotograma a fotograma por Chrome sin interfaz gráfica — código, no un modelo de video. Todos los pasos deterministas son comandos reels <comando> (en PATH; reels --help). Funciona en cualquier agente que pueda leer archivos, escribir archivos y ejecutar comandos; los subagentes son opcionales.
Primera ejecución: reels doctor — si faltan fuentes/SFX ejecuta reels setup.
Cada ejecución: lee references/quality-bar.md (define lo completado) y ejecuta reels lessons digest — esas son lecciones de reels anteriores; síguelas. Una vez que existe el proyecto, reels lessons digest --project <directorio> las reduce al preset, aspecto y modo de este reel (los paquetes de fotogramas ya contienen las lecciones de fotogramas reducidas).
Ruta por género
| El usuario quiere… | Lee | Preset |
|---|---|---|
| 科普/讲解 (explicar una idea o proceso) | script-and-storyboard.md | deepspace para física/astronomía/tecnología · notebook para vida/biología/geografía |
| 历史/人物/战役/朝代/文明 | history.md | ink para historia china/poesía · atlas para historia mundial/rutas · notebook para resumen a línea |
| 题目讲解 / 知识点 / 古诗 / 笔顺 | solve.md | chalk para pizarrón · notebook para niños · ink para poesía clásica |
| 故事短片 / 无台词 | techniques.md, styles.md | cualquiera; solo music:, sin SCRIPT.md |
| "Haz esto al estilo de este video" | reels analyze <video> primero, luego la fila correspondiente | — |
| > 3 min | capítulos, cada uno su propio proyecto → reels concat | — |
| Promo de producto / MV / ≤15 s gráfico en movimiento / subtítulos sobre metraje | el flujo de trabajo HyperFrames correspondiente (npx hyperframes skills); entrega en chino con reels fonts + reels captions | — |
Paso 0 — Brief (una ronda corta, recomendaciones primero)
Pregunta solo lo que la solicitud deja abierto, en un mensaje, cada uno con un valor predeterminado recomendado:
题目 y 角度 (tesis de una línea) · 时长 (60–90 s; ≈ 4.5–5 字/segundo) · 画幅 (16:9 B站/YouTube · 9:16 抖音/视频号)
· 风格 (preset anterior, o un look nombrado en styles.md) · 配音 (zh-CN-YunxiNeural voz masculina animada ·
XiaoxiaoNeural voz femenina cálida · YunjianNeural voz profunda · en-US-AndrewNeural; ElevenLabs si ELEVENLABS_API_KEY)
· 语言 (中文 · English · 日本語 · 한국어 — narración, texto en pantalla y subtítulos todo en ese idioma; reels voice lo detecta desde SCRIPT.md, voces predeterminadas en reels_rsi/langs.py) · 字幕 (mismo idioma · 中英双语 bilingüe · ninguno) · 音乐 (pista del usuario en assets/music/, de lo contrario un estado de ánimo) · 审阅 (sí: plan → look-dev → final).
"直接做 / don't ask" ⇒ toma todos los valores predeterminados, indícalos en una línea, sin barreras.
Una foto de un problema (练习册拍照) → solve.md "Problema desde una foto": transcríbelo y reformúlalo en la compuerta del plan.
Paso 1 — Investigación y datos
Verifica cada afirmación, número, fecha y nombre (historia: dos fuentes para hechos controvertidos; resolución: calcula la respuesta en código). Escribe BRIEF.md (frontmatter workflow: faceless-explainer, flow: automation, storyboard, message, destination, aspect, language, audience, length, angle, voice, style_preset; cuerpo ## Intent, ## Notes con fuentes/cálculos).
Paso 2 — Proyecto
reels new videos/<slug> --preset <preset> --title "<título>" --desc "<una línea>"
Luego escribe BRIEF.md y capture/extracted/visible-text.txt (datos) en él; cada comando posterior se ejecuta dentro del proyecto. Mapas: reels geo --project . --layers countries,coastline,rivers. Imágenes de época:
reels commons search "…" / reels commons get --project . --name x "File:…". 笔顺: reels hanzi 字 --project ..
Paso 3 — Guion y storyboard
SCRIPT.md (## Línea N — … (Fotograma N) + texto hablado indentado; líneas **EN:** para bilingüe) y
STORYBOARD.md (frontmatter format, duration, message, arc, audience, mode, music; por fotograma ## Frame N — título con scene, voiceover, duration, transition_in, status: outline, src: compositions/frames/NN-nombre.html, route, sfx, keyMessage). Detalles: script-and-storyboard.md.
Compuerta: presenta tesis, lista de fotogramas (ver / oír / ruta), duración, estilo, voz, música — espera.
Paso 4 — Voz, sincronización, música
reels voice --project . [--voice …] [--rate +5%]
Da voz a cada línea, escribe los tiempos de palabra en audio_meta.json, sincroniza las duraciones reales en el storyboard y construye la banda sonora sobre los cortes reales. Revoca voz de un fotograma: --only 3.
Paso 5 — Diseño visual
Escribe ## Dirección de video una vez en STORYBOARD.md (roles de paleta, estilo nombrado, gramática de movimiento, ritmo, lista negativa). Por fotograma, una lista de tomas con referencia temporal sincronizada con los tiempos de palabra hablada: un movimiento de cámara por fotograma, un héroe rico (quality-bar.md). Elementos para todo el reel (regla de año, barra de capítulo) → una superposición (compositions/overlays/<nombre>.html, history.md).
Paso 6 — Construir fotogramas
reels packets --project . # .reels/packets/_role.md + un paquete por fotograma (incluye tiempos de palabra + lecciones)
reels fonts --project .
6a Look-dev: construye primero dos fotogramas héroe (fotograma 1 + el más visual) y cualquier superposición; márcalos como animated; ejecuta reels finalize .; mira snapshots/contact-sheet.jpg. Compuerta: "¿Esta dirección visual es correcta?"
6b El resto: con subagentes, uno por fotograma en paralelo — cada uno recibe la ruta del proyecto, su ID de fotograma y los fotogramas héroe aprobados como referencia, y se le dice: lee .reels/packets/_role.md y tu paquete, escribe solo tu fotograma, ejecuta reels lint --frame <id>, responde con una línea.
Sin subagentes, constrúyelos tú mismo en orden desde los mismos paquetes. Marca cada uno como status: animated.
Paso 7 — Finalización y bucle de revisión
reels finalize .
fuentes → subtítulos → música → SFX → ensamblaje → superposiciones → transiciones → verificación de HyperFrames (lint, tiempo de ejecución, diseño, contraste) → reglas de Reels-RSI (errores de reels anteriores) → SRT → instantáneas.
Cada pasada se registra en .reels/. Corrige cada error y advertencia en los archivos de fotogramas (nunca en el índice generado). Puntúa cada fotograma según R1–R6 de la hoja de contactos (reels score . agrega un juez visual cuando está configurado); cualquier valor < 4 → corrige → finaliza de nuevo. ≥ 1 ronda, ≤ 3.
Vista más cercana: reels times --project . --frame 04 → reels hf --project . snapshot --at <t>.
Paso 8 — Renderizado y entrega
reels render . --quality high
reels cover --project . --composition # si existe compositions/cover.html
reels cover --project . --frame 08 # si no: el fotograma más revelador solo, sin subtítulos
Entrega renders/video.mp4, renders/cover.jpg, renders/subtitles*.srt, CREDITS.md si corresponde;
duración; IDs de fotograma para ediciones; qué se tomó por defecto.
Paso 9 — Aprender (siempre, toma un minuto)
- Registra cada comentario que el espectador hizo durante la ejecución, textualmente:
reels feedback --project . "Los subtítulos son demasiado pequeños" [--frame 04] [--approve]. reels retro .— propone lecciones del registro de ejecución, las diferencias de corrección y los comentarios en la bandeja de entrada (sin modelo retro configurado:reels retro . --evidence-only, lee.reels/retro/evidence.md, y presenta ≤ 3 lecciones tú mismo conreels lessons add "…" --kind doc|rule|taste --scope frame|director|history|solve). Una buena lección es general ("las etiquetas del mapa permanecen por encima de y=900 porque…"), nunca un hecho sobre este tema.- Muestra la bandeja de entrada (
reels lessons list --state inbox) y pregunta cuáles conservar; acepta solo lo que el espectador apruebe (reels lessons accept <id>). Una lección de tiporulese acepta con una comprobación funcional:reels rules new <id>, escriberule.py+bad.html+good.html,reels rules test <id>, luegoreels lessons accept <id> --rule-dir ~/.reels/rules/<id>. En modo "直接做", deja las propuestas en la bandeja de entrada y menciona cuántas están esperando.
Ediciones posteriores a la entrega
Cambia solo lo que se pidió: copia → SCRIPT.md + reels voice --only N + texto del fotograma → finalizar → render. Visual → ese HTML del fotograma → finalizar → render. Nunca reconstruyas fotogramas no modificados.
Registra la solicitud con reels feedback — las ediciones son las mejores lecciones.
Mejoras opcionales (activadas automáticamente por el entorno)
ELEVENLABS_API_KEY → voces de ElevenLabs [no probado] · OPENAI_API_KEY / GEMINI_API_KEY → capas de ilustración de reels image debajo de las capas de código [no probado] · una pista en assets/music/ → la banda sonora · un modelo juez (reels config set roles.judge provider:model) → reels score califica fotogramas.
Trampas conocidas (manejadas por los comandos — no las deshagas)
Kokoro no puede hablar mandarín → edge-tts · whisper devuelve una oración en chino como una palabra → tiempos de palabra TTS · los subtítulos estándar unen palabras con espacios → reels captions · el renderizador Chrome no tiene fuentes CJK → reels fonts + @font-face en cada fotograma · el ensamblador pierde el tipo de pista de subtítulos → finalize lo vuelve a agregar · npm puede servir una CLI no publicada → los proyectos fijan su versión de HyperFrames.