Reels-RSI — dirija um reel e aprenda com ele
Você é o diretor. Cada frame é uma composição HTML HyperFrames renderizada frame a frame pelo
Chrome headless — código, não um modelo de vídeo. Todos os passos determinísticos são reels <comando>
(no PATH; reels --help). Funciona em qualquer agente que possa ler arquivos, escrever arquivos e executar
comandos; subagentes são opcionais.
Primeira execução: reels doctor — se as fontes/SFX estiverem faltando, execute reels setup.
Toda execução: leia references/quality-bar.md (define o que é "pronto") e execute
reels lessons digest — essas são lições de reels anteriores; siga-as. Assim que o projeto existir,
reels lessons digest --project <dir> as restringe ao preset, aspecto e modo deste reel
(os pacotes de frame já carregam as lições de frame restritas).
Roteiro por gênero
| O usuário quer… | Leia | Preset |
|---|---|---|
| 科普/讲解 (explicar uma ideia ou processo) | script-and-storyboard.md | deepspace Física/Astronomia/Tecnologia · notebook Vida/Biologia/Geografia |
| 历史/人物/战役/朝代/文明 | history.md | ink História da China/Poesia · atlas História mundial/Rotas · notebook Esboço rápido |
| 题目讲解 / 知识点 / 古诗 / 笔顺 | solve.md | chalk Quadro negro · notebook Infantil · ink Poesia clássica |
| 故事短片 / 故事 sem falas | techniques.md, styles.md | qualquer; music: apenas, sem SCRIPT.md |
| "Faz igual a este vídeo" | reels analyze <vídeo> primeiro, depois a linha correspondente | — |
| > 3 min | capítulos, cada um seu próprio projeto → reels concat | — |
| promo de produto / MV / ≤15 s motion graphic / legendas sobre cenas | o fluxo HyperFrames correspondente (npx hyperframes skills); entregue em chinês com reels fonts + reels captions | — |
Etapa 0 — Briefing (uma rodada curta, recomendações primeiro)
Pergunte apenas o que a solicitação deixou em aberto, em uma única mensagem, cada uma com uma recomendação padrão:
题目 & 角度 (tese em uma linha) · 时长 (60–90 s; ≈ 4,5–5 caracteres/segundo) · 画幅 (16:9 B站/YouTube · 9:16 Douyin/视频号)
· 风格 (preset acima, ou um visual nomeado de styles.md) · 配音 (zh-CN-YunxiNeural voz masculina animada ·
XiaoxiaoNeural voz feminina calorosa · YunjianNeural voz grave · en-US-AndrewNeural; ElevenLabs se ELEVENLABS_API_KEY)
· 语言 (中文 · English · 日本語 · 한국어 — narração, texto na tela e legendas tudo no mesmo; reels voice detecta a partir do SCRIPT.md, vozes padrão em reels_rsi/langs.py) · 字幕 (mesmo idioma · 中英双语 · nenhum) · 音乐 (faixa do usuário em assets/music/, senão um clima) · 审阅 (sim: plano → look-dev → final).
"直接做 / don't ask" ⇒ assuma todos os padrões, declare-os em uma linha, sem barreiras.
Uma foto de um problema (练习册拍照) → solve.md "Problema a partir de uma foto": transcreva e reformule na etapa de plano.
Etapa 1 — Pesquisa e fatos
Verifique cada afirmação, número, data e nome (história: duas fontes para fatos contestados; resolução: calcule
a resposta em código). Escreva BRIEF.md (frontmatter workflow: faceless-explainer, flow: automation,
storyboard, message, destination, aspect, language, audience, length, angle, voice,
style_preset; corpo ## Intent, ## Notes com fontes/cálculos).
Etapa 2 — Projeto
reels new vídeos/<slug> --preset <preset> --title "<título>" --desc "<uma linha>"
Em seguida, escreva BRIEF.md e capture/extracted/visible-text.txt (fatos) dentro dele; todo comando posterior é executado
dentro do projeto. Mapas: reels geo --project . --layers countries,coastline,rivers. Imagens de época:
reels commons search "…" / reels commons get --project . --name x "File:…". 笔顺: reels hanzi 字 --project ..
Etapa 3 — Roteiro e storyboard
SCRIPT.md (## Linha N — … (Frame N) + texto falado indentado; linhas **EN:** para bilíngue) e
STORYBOARD.md (frontmatter format, duration, message, arc, audience, mode, music; por
frame ## Frame N — título com scene, voiceover, duration, transition_in, status: outline,
src: compositions/frames/NN-name.html, route, sfx, keyMessage). Detalhes: script-and-storyboard.md.
Ponto de verificação: apresente tese, lista de frames (ver / ouvir / rota), duração, estilo, voz, música — aguarde.
Etapa 4 — Voz, timing, música
reels voice --project . [--voice …] [--rate +5%]
Dá voz a todas as linhas, escreve os timings das palavras em audio_meta.json, sincroniza as durações reais no
storyboard, constrói a base musical nos cortes reais. Refazer a voz de um frame: --only 3.
Etapa 5 — Design visual
Escreva ## Video direction uma vez no STORYBOARD.md (funções da paleta, estilo nomeado, gramática de movimento, ritmo,
lista negativa). Por frame, uma lista de tomadas com código de tempo alinhada aos tempos das palavras faladas: um movimento de câmera por
frame, um herói rico (quality-bar.md). Elementos abrangentes do reel (régua de ano, barra de capítulo) → uma sobreposição
(compositions/overlays/<nome>.html, history.md).
Etapa 6 — Construir frames
reels packets --project . # .reels/packets/_role.md + um pacote por frame (incl. tempos das palavras + lições)
reels fonts --project .
6a Look-dev: construa primeiro dois frames heróis (frame 1 + o mais visual) e qualquer sobreposição; marque-os como
animated; reels finalize .; olhe em snapshots/contact-sheet.jpg. Ponto de verificação: "Esse direção visual está correta?"
6b O restante: com subagentes, um por frame em paralelo — cada um recebe o caminho do projeto, seu
ID de frame e os frames heróis aprovados como referência, e é instruído: leia .reels/packets/_role.md
e seu pacote, escreva apenas seu frame, execute reels lint --frame <id>, responda com uma linha.
Sem subagentes, construa-os você mesmo em ordem a partir dos mesmos pacotes. Marque cada um como status: animated.
Etapa 7 — Finalização e loop de revisão
reels finalize .
fontes → legendas → música → SFX → montagem → sobreposições → transições → verificação HyperFrames (lint,
runtime, layout, contraste) → regras do Reels-RSI (erros que reels anteriores cometeram) → SRT → snapshots.
Cada passo é registrado em .reels/. Corrija todos os erros e avisos nos arquivos de frame (nunca no
índice gerado). Pontue cada frame em R1–R6 a partir da folha de contato (reels score . adiciona um juiz
visual quando configurado); qualquer coisa < 4 → corrija → finalize novamente. ≥ 1 rodada, ≤ 3.
Inspeção mais detalhada: reels times --project . --frame 04 → reels hf --project . snapshot --at <t>.
Etapa 8 — Renderização e entrega
reels render . --quality high
reels cover --project . --composition # se compositions/cover.html existir
reels cover --project . --frame 08 # senão: o frame mais revelador sozinho, sem legendas
Entregue renders/video.mp4, renders/cover.jpg, renders/subtitles*.srt, CREDITS.md se houver;
duração; IDs dos frames para edições; o que foi padronizado.
Etapa 9 — Aprender (sempre, leva um minuto)
- Registre cada observação que o espectador fez durante a execução, na íntegra:
reels feedback --project . "As legendas estão muito pequenas" [--frame 04] [--approve]. reels retro .— propõe lições a partir do log de execução, dos diffs de correção e do feedback, para a caixa de entrada (sem modelo de retrospectiva configurado:reels retro . --evidence-only, leia.reels/retro/evidence.md, e registre ≤ 3 lições você mesmo comreels lessons add "…" --kind doc|rule|taste --scope frame|director|history|solve). Uma boa lição é geral ("rótulos de mapa devem ficar acima de y=900 porque…"), nunca um fato sobre este tópico.- Mostre a caixa de entrada (
reels lessons list --state inbox) e pergunte quais manter; aceite apenas o que o espectador aprovar (reels lessons accept <id>). Uma lição do tiporuleé aceita com uma verificação funcional:reels rules new <id>, escrevarule.py+bad.html+good.html,reels rules test <id>, entãoreels lessons accept <id> --rule-dir ~/.reels/rules/<id>. No modo "直接做", deixe as propostas na caixa de entrada e mencione quantas estão aguardando.
Edições após a entrega
Altere apenas o que foi solicitado: cópia → SCRIPT.md + reels voice --only N + texto do frame → finalize →
renderize. Visual → o HTML desse frame → finalize → renderize. Nunca reconstrua frames não modificados.
Registre a solicitação com reels feedback — edições são as melhores lições.
Atualizações opcionais (ativadas automaticamente pelo ambiente)
ELEVENLABS_API_KEY → Vozes ElevenLabs [não testado] · OPENAI_API_KEY / GEMINI_API_KEY →
reels image camadas de ilustração sob camadas de código [não testado] · uma faixa em assets/music/ → a base
musical · um modelo juiz (reels config set roles.judge provider:model) → reels score avalia frames.
Armadilhas conhecidas (tratadas pelos comandos — não as desfaça)
Kokoro não consegue falar Mandarim → edge-tts · whisper retorna uma frase em chinês como uma única palavra → timings
de palavras TTS · legendas padrão juntam palavras com espaços → reels captions · o Chrome de renderização não tem fontes
CJK → reels fonts + @font-face em cada frame · o montador perde o tipo da faixa de legendas →
finalize a readiciona · npm pode servir uma CLI não publicada → projetos fixam sua versão do HyperFrames.