Web Video Presentation
Transforma um artigo ou roteiro de narração em uma página web que "se passa por vídeo", pronta para gravação de tela, com opção de sintetizar áudio de narração. O resultado = projeto Vite + React + TS + áudio dividido por capítulo.
Cenários de uso
- "Tenho um roteiro de narração / um artigo, me ajude a fazer um vídeo" — conteúdo guiado por narração
- Quero fazer um "PPT dinâmico"
- Gravação de tela 16:9 widescreen, texto grande, espaços em branco, cada tela com efeito de movimento
- Ensino / demonstração de produto / keynote com estilo cinematográfico
- Conteúdo para Bilibili / YouTube / TikTok
Esta Skill tem como núcleo a metodologia + fluxo de colaboração. O modelo do scaffold fornece tokens e primitivas, mas cada decisão estética (esquema de cores, tipografia, estilo de animação) deve ser redesenhada para o seu tema — não copie.
Visão geral do fluxo de trabalho
Fase 1 Escrita de conteúdo
1.1 Identificar entrada do usuário
1.2 Produção única de script.md + outline.md
(roteiro de narração + plano de desenvolvimento)
▼
[Checkpoint Plan] ← Deve parar. Alinhar 5 coisas de uma vez:
roteiro / outline / tema / materiais / modo de desenvolvimento
▼
Fase 2 Desenvolvimento web
2.1 Scaffold (de acordo com o tema selecionado)
2.2 Capítulo 1 = thread principal + versão completa (âncora obrigatória)
▼
[Nó rígido] Usuário valida Capítulo 1 ← Não pode pular
▼
2.3 Capítulos 2~N (de acordo com o modo selecionado: A capítulo por capítulo / B sequencial / C paralelo)
▼
[Checkpoint Audio] ← Deve parar. Sintetizar áudio ou não?
▼
Fase 3 Síntese de áudio (opcional)
▼
Fase 4 Gravação de tela + pós-produção
Convenção do diretório de trabalho (o agente cria/edita no diretório atual do usuário):
meu-video/
├── article.md # Obrigatório quando o usuário fornece o texto original — não deletar! Fonte de informação visual durante o desenvolvimento
├── script.md # Obrigatório: roteiro de narração platformizado na língua original (determina os compassos)
├── outline.md # Obrigatório: plano de desenvolvimento (divisão em capítulos + conteúdo de cada passo + pool de informações)
└── presentation/ # Projeto Vite + React + TS gerado pelo scaffold
├── src/chapters/<NN>-<id>/
│ ├── <Chapter>.tsx # Implementação visual
│ ├── <Chapter>.css
│ └── narrations.ts # ★ Fonte única de verdade para número de steps + texto de narração
├── scripts/
│ ├── extract-narrations.ts # Varre todos os narrations.ts → audio-segments.json
│ ├── synthesize-audio.sh # Runner agnóstico de provedor (loop pelos segments)
│ └── tts-providers/ # Um .sh por provedor (2 integrados)
│ ├── README.md # Contrato de 3 funções + 5 trechos de código prontos (11labs / edge-tts / say / azure / gcloud)
│ ├── minimax.sh # Provedor padrão, usa mmx-cli
│ └── openai.sh # OpenAI TTS integrado (curl + OPENAI_API_KEY)
├── audio-segments.json # Saída do extract (revisar antes da síntese)
└── public/audio/<id>/<N>.mp3 # Opcional: áudio sintetizado
Crucial:
narrations.tsé a fonte única de verdade para o número de steps e a síntese de áudio. O maior N + 1 que aparece emif (step === N)no.tsxdo capítulo deve ser igual anarrations.length. Isso garante que 5 lugares (script / outline / código do capítulo / chapters.ts / arquivos de áudio) nunca dessincronizem.
Protocolo de auto-verificação obrigatório (ao longo de toda a Skill)
Para cada uma das três saídas abaixo, após a conclusão, deve-se executar: auto-verificação → correção → depois relatar / avançar:
| Saída | Fonte da lista de verificação |
|---|---|
script.md | SCRIPT-STYLE.md Auto-verificação em três camadas (forma / estrutura / ler em voz alta) |
outline.md | OUTLINE-FORMAT.md Auto-verificação |
| Implementação de capítulo individual concluída | CHAPTER-CRAFT.md Auto-verificação de conclusão |
Modo de execução (em ordem decrescente de capacidade, priorizar a forma mais isolada):
- Agent Teams (ideal): Abrir um agente revisor independente, fornecer a ele "caminho do arquivo de saída + lista de verificação correspondente + contexto chave", e fazê-lo verificar item por item e relatar estritamente as conclusões (quais itens passaram / quais falharam + evidências + sugestões de reescrita).
- subAgent (segunda melhor opção): Se não houver capacidade Teams mas puder abrir subagent, usar subagent para seguir o mesmo fluxo.
- Auto-verificação (fallback): Se o agente atual não tiver nenhuma das capacidades acima, deve verificar estritamente item por item — não é permitido apenas dar uma olhada e aprovar.
Regra de ferro: Após obter as conclusões, primeiro corrija a saída com base nos itens que falharam, depois reporte ao usuário "concluído + conclusão da verificação + o que foi alterado". Relatar diretamente as conclusões originais sem corrigir = violação.
Guia de leitura de arquivos por fase
Diferentes fases leem diferentes arquivos. Em sessões longas, o agente tende a esquecer os princípios, especialmente a "implementação de capítulo individual" da Fase 2.4 que se repete N vezes — a cada vez, deve-se revisitar as restrições centrais.
| Fase | Obrigatório (ler sempre) | Ler uma vez / Consultar conforme necessário |
|---|---|---|
| Fase 1.1-1.2 Escrita de conteúdo | references/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (texto original do usuário, se houver) | — |
| Checkpoint Plan Selecionar tema | — | themes/*/theme.json (ler dinamicamente todos, listar com bestFor recomendado + descriptionZh); references/THEMES.md (quando o usuário quiser entender o sistema de temas) |
| Fase 2.1 Scaffold | — | SKILL.md seção atual ler uma vez |
| Fase 2.4 Implementar capítulo individual (×N vezes, chamado por 2.2 / 2.3) | references/CHAPTER-CRAFT.md única entrada — Parte 0 Dez princípios / Parte 1 5 perguntas para começar / Parte 2 Árvore de decisão relação→ação / Parte 3 Caixa de ferramentas visual / Parte 4 Referência de duração / Parte 5 Antipadrões anti-AI / Parte 6 Regras rígidas de código (incluindo restrição obrigatória de narrations.ts) / Parte 7 Auto-verificação de conclusão / Parte 8 Consulta rápida de feedback + themes/<id>/theme.json do tema atual + parágrafo do outline.md do capítulo atual + article.md parágrafo correspondente ao capítulo atual + lista de materiais | references/EXAMPLES/ (apenas para estrutura, não para copiar modelo); references/THEMES.md contrato completo de tokens |
| Fase 3 Síntese de áudio | references/AUDIO.md (contém fluxo narrations.ts → segments.json → qualquer provedor, com minimax + openai integrados) | templates/scripts/tts-providers/README.md (ao trocar de provedor / usar TTS próprio) |
| Fase 4 Gravação de tela + pós-produção | references/RECORDING.md (contém ?auto=1 para gravação automática) | — |
| Selecionar / criar / personalizar tema | — | references/THEMES.md |
Ao escrever um capítulo, leia apenas
CHAPTER-CRAFT.md. Dez princípios / auto-prompting inicial / árvore de decisão / antipadrões anti-AI / auto-verificação de conclusão — tudo consolidado nesta única entrada.EXAMPLES/não é leitura obrigatória — primeiro projete livremente com base no conteúdo, consulte apenas se travar (consulte a "forma" do âncora, não copie).
Fase 1 — Escrita de conteúdo (produção única)
1.1 Identificar entrada do usuário
| O que o usuário fornece | O que fazer |
|---|---|
| Artigo original (texto escrito / artigo de WeChat / artigo acadêmico / blog) | Produção única de script.md + outline.md (1.2), passar Checkpoint Plan |
| Roteiro de narração / script de vídeo diretamente | Salvar como script.md, produção única de outline.md (versão simplificada 1.2), passar Checkpoint Plan |
| Nada, apenas diz "me ajude a fazer um vídeo sobre o tema X" | Perguntar de volta: primeiro forneça um material ou esboço. A Skill não concebe conteúdo pelo usuário |
1.2 Produção única de script.md + outline.md
As duas saídas são concluídas em um único pensamento:
- Gerar
script.md: De acordo comreferences/SCRIPT-STYLE.md, transformar o article em um roteiro de narração platformizado na língua original. Manterarticle.mdsem deletar — ele é a fonte de detalhes para o pool de informações do outline e para as imagens na implementação do capítulo (princípio de dupla fonte). - Gerar
outline.md: De acordo comreferences/OUTLINE-FORMAT.md, dividir em capítulos + dividir em steps + extrair o pool de informações do primeiro parágrafo de cada capítulo.
Limites do outline (crucial):
| O que o outline deve escrever | O que o outline NÃO deve escrever |
|---|---|
| Divisão de capítulos / número de steps por capítulo / tempo estimado | Tipos específicos de animação (blur clear / wipe / spring) |
| Conteúdo da tela de cada passo (hero / dados / slogan / itens de lista) | Meios de implementação CSS (filter / SVG / clip-path) |
| Pool de informações do capítulo: números / citações / casos / tags extraídos do article | Valores numéricos de duração (não escrever |
| Prefixo do nome da relação entre passos ("contraste de opostos" / "lista progressiva" / "frase de efeito" etc., dica opcional) | Micro-ritmos como movimento contínuo / escalonamento |
Razão para não escrever animações no outline: Animar fixo no outline = o agente do capítulo se degrada a uma máquina de tradução; deixar espaço em branco permite que o agente do capítulo projete livremente com base na "árvore de decisão orientada por conteúdo" do
CHAPTER-CRAFT.mdao iniciar cada passo, gerando uma verdadeira sensação de vídeo. VejaCHAPTER-CRAFT.mdParte 0 Princípio 7.
Após salvar, deve-se primeiro executar a auto-verificação antes de prosseguir para o Checkpoint Plan: De acordo com o "Protocolo de auto-verificação obrigatório" acima, executar para script.md / outline.md respectivamente (priorizar Agent Teams → subAgent → auto-verificação), corrigir com base nas conclusões e só então entrar no Checkpoint Plan.
Checkpoint Plan — 5 coisas alinhadas de uma só vez (Nó rígido)
Após escrever script.md + outline.md, deve-se parar. O usuário confirma 5 coisas simultaneamente neste nó.
Trabalho preparatório do agente neste momento
- Ler todos os
themes/*/theme.jsonpara obternameZh/descriptionZh/bestFor/mood— não codificar a lista manualmente - Com base no tipo de conteúdo / palavras-chave / tom de
script.md, ativamente selecionar 2~3 temas mais adequados (correspondentes ao campobestFor) - Revisar a seção "lista de materiais" no final de
outline.md
Modelo de resumo (esqueleto, agente preenche conforme o caso)
Plano de conteúdo concluído, arquivos de saída:
📄 article.md {se o usuário forneceu o texto original, mantido}
📄 script.md {X} caracteres / ~{T} minutos
📄 outline.md {N} capítulos / {M} passos + pool de informações de cada capítulo + lista de materiais no final
Visão geral dos capítulos:
1. <id> <Título do capítulo> <S> passos ~<T>s
2. ...
Agora, alinhar 5 coisas de uma só vez:
1. Roteiro (script.md) precisa de alterações?
Pode editar o arquivo diretamente, ou me dizer oralmente a direção da alteração.
2. Plano de desenvolvimento (outline.md) precisa de alterações? Foco em:
- A divisão de capítulos / número de steps / tempo estimado é razoável? (Razoável: cada capítulo 30~60s)
- O conteúdo da tela de cada passo está claro?
- O "pool de informações" no primeiro parágrafo de cada capítulo tem detalhes suficientes do article para ancorar as imagens?
- A lista de materiais no final está completa?
3. Qual tema escolher? Minhas recomendações:
★ <Recomendação 1: nameZh (id)> — porque <correspondência bestFor>; <resumo descriptionZh>
★ <Recomendação 2 / Recomendação 3>
Outras opções: <temas restantes, nameZh + uma frase>
Também posso te ajudar a criar um novo tema (veja references/THEMES.md).
4. Como preparar os materiais reais? Uma lista aproximada das imagens necessárias para este vídeo: <listar lista aproximada>
a) Eu seleciono a partir de <caminho do material existente> b) Você fornece c) Tudo placeholder
5. Qual modo de desenvolvimento escolher?
**O Capítulo 1, independentemente do modo, deve ser feito na thread principal + validado pelo usuário** (âncora obrigatória).
A diferença está no Capítulo 2 e seguintes:
A) Padrão · Confirmação capítulo por capítulo (recomendado)
Cada capítulo concluído pausa para validação → risco controlado / ritmo mais estável
B) Desenvolvimento sequencial após o Capítulo 1 (não paralelo)
Capítulos 2~N feitos sequencialmente na thread principal, depois validação unificada → velocidade média / adequado para agentes que não suportam paralelismo
C) Desenvolvimento paralelo após o Capítulo 1 (subagent)
Capítulos 2~N feitos em paralelo com subagents → mais rápido / usuário controla o número de paralelismos (quantos capítulos por vez)
⚠️ Haverá diferenças de estilo entre os capítulos (esperado, com fallback das restrições do tema)
Após receber o feedback:
- Roteiro / outline precisam de alterações: editar o arquivo diretamente, após editar pingar uma vez (ou descrever oralmente para o agente alterar)
- O tema deve estar definido para entrar na Fase 2. Se o usuário disser "você escolhe o tema para mim" → pegar a primeira recomendação, informar ao usuário o que foi escolhido e por quê, dar oportunidade de desistir
- Modo definido → Entrar na Fase 2
Fase 2 — Desenvolvimento web
2.1 Scaffold
bash <caminho-para-web-video-presentation>/scripts/scaffold.sh \
./presentation \
--theme=<id do tema selecionado pelo usuário>
bash <caminho-para-web-video-presentation>/scripts/scaffold.sh --list-themes
Tema personalizado → Primeiro, siga o fluxo "Criar novo tema" em
references/THEMES.mdpara criar umthemes/<meu-tema>/, depois--theme=<meu-tema>.
O scaffold inclui uma demo 01-example. Deletar antes de escrever o conteúdo real do primeiro capítulo:
rm -rf presentation/src/chapters/01-example
E remover o import e o item do array EXAMPLE_CHAPTER em presentation/src/registry/chapters.ts.
2.2 Capítulo 1 — Thread principal + validação obrigatória
Central: Capítulo 1 = versão completa de uma só vez (ritmo + visual + materiais reais completos). Não existe conceito de "versão esqueleto" — o primeiro capítulo já deve ser um modelo que o usuário possa validar diretamente.
Por que o Capítulo 1 deve estar na thread principal:
- É a primeira aplicação do guia
CHAPTER-CRAFT.mdno tema atual + assunto atual - Se houver lacunas no guia / cores do tema / tokens de fonte insuficientes, o Capítulo 1 certamente as exporá — com feedback humano é possível corrigir o guia / ajustar o tema, quanto mais cedo, menor o custo
- Os capítulos subsequentes (sejam sequenciais ou paralelos) devem consultar o padrão de código do Capítulo 1, portanto, Capítulo 1 = "âncora de estilo" do projeto atual (não é obrigatório que os capítulos sejam consistentes entre si, mas o capítulo em si deve ter poder de persuasão completo)
Após concluir o Capítulo 1, deve-se parar para aguardar a validação do usuário:
Capítulo 1 <id> concluído. Servidor de desenvolvimento rodando em localhost:5173.
Foco da validação:
□ A atmosfera visual está correta? Corresponde às expectativas de <nameZh do tema>?
□ O ritmo está correto? Alguns passos muito rápidos / muito lentos / com informação muito escassa?
□ As animações orientadas por conteúdo estão adequadas? Ou alguns passos têm animações de entrada sem pensar?
□ Princípio de dupla fonte: A tela tem detalhes que "a narração não menciona, mas o article pode ancorar"?
□ Verificação anti-AI: Gradiente roxo-rosa / bordas coloridas arredondadas / ilustrações falsas / emoji estão presentes?
Me diga os problemas que eu ajusto pontualmente. Quando estiver OK, me diga "continuar", e eu farei o Capítulo 2 e seguintes de acordo com o modo selecionado.
2.3 Capítulos 2~N — De acordo com o modo selecionado
Regra comum a todos os modos: Cada capítulo é desenvolvido independentemente de acordo com CHAPTER-CRAFT.md. O estilo não precisa ser totalmente consistente entre os capítulos — os tokens de cor/fonte do tema garantem a unidade visual básica; animação / ritmo / demonstração visual são deixados para a liberdade criativa de cada capítulo, o que é um design esperado.
Modo A · Padrão · Confirmação capítulo por capítulo
Capítulo 2 concluído → pausa para validação → OK → Capítulo 3 → pausa → ... → Capítulo N. Cada capítulo é validado independentemente, problemas corrigidos a qualquer momento, menor risco, ritmo mais estável. Quando o usuário não especifica o modo, este é o padrão.
Modo B · Desenvolvimento sequencial após Capítulo 1
Capítulo 2 → Capítulo 3 → ... → Capítulo N feitos sequencialmente na thread principal, depois validação unificada no final. Velocidade média, adequado para ambientes onde o agente não suporta tarefas paralelas.
Modo C · Desenvolvimento paralelo após Capítulo 1 (subagent)
Usar subagents para fazer os Capítulos 2~N em paralelo, número máximo de paralelismos controlado pelo usuário ("4 capítulos por vez" / "2 capítulos por vez"). Mais rápido, mas haverá diferenças de estilo entre os capítulos — isso é esperado, porque:
- Cada subagent não vê a saída dos outros, não pode alinhar mecanicamente
- O código dos capítulos está fisicamente separado (uma pasta por capítulo / prefixo CSS próprio), não interferem entre si
- Os tokens do tema garantem unidade visual básica (cores / fontes / números hero / cards / linhas de separação / decoração), a atmosfera não foge do esperado
- Inconsistência de estilo = a sensação de um vídeo escrito à mão por humanos (múltiplas vozes / múltiplas perspectivas)
O prompt do subagent paralelo deve incluir:
- Parágrafo do outline do capítulo atual (com pool de informações)
- Caminho de
references/CHAPTER-CRAFT.md(leitura única obrigatória — requisitos de demonstração visual + revelação progressiva + princípio de dupla fonte + anti-AI + linhas vermelhas de código + auto-verificação de conclusão, tudo neste arquivo) descriptionZh/mood/bestFordotheme.jsondo tema atual (consultar a atmosfera, animação / duração / tamanho da fonte / emoji decididos livremente pelo agente do capítulo)- Código do Capítulo 1 como referência de "estilo de código" (não como "objeto de cópia visual")
- Regra rígida: Prefixo CSS independente por capítulo (
.cd-/.mg-/.pm-/ ...); não modificarchapters.ts; ao concluir, executarnpx tsc --noEmit
Importante: Independentemente do modo escolhido, o usuário pode alternar o modo a qualquer momento. Após o Capítulo 2 estar OK, o usuário pode dizer "faz o restante em paralelo" / "faz o restante capítulo por capítulo".
2.4 Implementar capítulo individual (a ser seguido por cada capítulo)
Orientações detalhadas em references/CHAPTER-CRAFT.md — entrada única de leitura obrigatória, cobrindo: requisitos de demonstração visual / revelação progressiva / seleção de conteúdo / princípio de dupla fonte / estética básica de apresentação visual / anti-AI / linhas vermelhas de código / auto-verificação de conclusão.
Pontos centrais (detalhados em CHAPTER-CRAFT.md):
- Cada capítulo deve ter demonstração visual CSS / SVG / Canvas / JS, proibido capítulo puramente textual
- Revelação progressiva: Listas / itens devem ser 1 item = 1 step, proibido mostrar N itens de uma vez
- Princípio de dupla fonte: Ritmo segue o roteiro de narração (a ordem não pode ser alterada), detalhes voltam ao artigo original (pool de informações + parágrafo do article deste capítulo)
- Auto-verificação de conclusão item por item, se não atender, volte e corrija — de acordo com o "Protocolo de auto-verificação obrigatório" acima (priorizar Agent Teams → subAgent → auto-verificação), corrija antes de reportar a entrega do capítulo ao usuário
2.5 Bump STORAGE_KEY após grandes alterações
Após alterar chapters.ts (adicionar / deletar / reordenar capítulos, ou alterar o comprimento de narrations.ts de um capítulo), bump STORAGE_KEY em presentation/src/hooks/useStepper.ts (ex.: v4 → v5), para evitar que o cursor persistido caia em um step inexistente.
Checkpoint Audio — Sintetizar áudio ou não? (Nó rígido)
Após o término da Fase 2, deve-se parar e perguntar ao usuário:
Página web concluída, {N} capítulos {M} passos. Servidor de desenvolvimento rodando em localhost:5173.
Deseja sintetizar áudio para fazer uma "gravação de tela com reprodução automática"?
✓ Sintetizar → Varrer todos os narrations.ts dos capítulos, gerar audio-segments.json,
chamar o provedor TTS para sintetizar cada passo como um mp3 em public/audio/.
Após a síntese, usar o modo ?auto=1 para gravar a tela em um único take (áudio e vídeo naturalmente sincronizados).
Dois provedores integrados:
• minimax (mmx-cli) — Padrão, timbre chinês estável
• openai (OPENAI_API_KEY) — Baseado em curl, a maioria já tem a chave
Outros backends (ElevenLabs / edge-tts gratuito / macOS say offline /
Azure / Google) veja os trechos prontos em scripts/tts-providers/README.md.
✗ Não sintetizar → Pular Fase 3, ir diretamente para Fase 4 com gravação manual + dublagem posterior.
Se quiser sintetizar → Fase 3. Se não quiser → diretamente Fase 4.
Fase 3 — Síntese de áudio (opcional)
Fluxo detalhado em references/AUDIO.md. Versão resumida:
cd presentation
npm run extract-narrations # Varre todos os narrations.ts → audio-segments.json
# Deixe o usuário dar uma olhada no audio-segments.json para confirmar o texto
npm run synthesize-audio # Provedor padrão minimax, incremental
# Ou usar openai integrado (requer OPENAI_API_KEY):
PRESENTATION_TTS=openai npm run synthesize-audio
# Ou personalizado: escrever um scripts/tts-providers/<nome>.sh, veja README.md do diretório
Após a síntese, informe ao usuário: localização da saída / número total de segmentos / quais segmentos têm duração anormal (muito longa = o step deve ser dividido; muito curta = texto muito raso) — dê a última oportunidade de calibrar o ritmo. Então, vá para a Fase 4.
Fase 4 — Gravação de tela + pós-produção
Veja references/RECORDING.md. Dois caminhos:
| Cenário | Caminho recomendado |
|---|---|
| Fase 3 com áudio sintetizado | Modo Auto em um único take: Abrir localhost:5173/?auto=1 no navegador → Pressionar SPACE → O vídeo inteiro é reproduzido automaticamente → Parar a gravação → Cortar o início e o fim, e o vídeo está pronto, sem necessidade de sincronizar a trilha de áudio na pós-produção |
| Fase 3 pulada | Modo Manual padrão: clicar para avançar → Dublar em qualquer ferramenta de edição na pós-produção |
O agente deve, após a Fase 3 / Checkpoint Audio, informar ativamente ao usuário o caminho de gravação adequado.
Dez princípios (lista de uma frase)
A descrição completa está em references/CHAPTER-CRAFT.md Parte 0 — consulte lá ao escrever um capítulo, abaixo é apenas um índice.
| # | Princípio | Uma frase |
|---|---|---|
| 1 | Palco fixo 16:9 | Conteúdo em 1920×1080 + transform scale, sem responsividade |
| 2 | Contador de steps global | Capítulo é função pura do step, sem temporizadores |
| 3 | Cada step ocupa a tela inteira | if (step === N) return <FullScene /> |
| 4 | Compasso da narração = step | Um compasso = um step = uma ideia focada |
| 5 | Controles de canto ocultos | Barra de progresso / botão de navegação com opacity 0 por padrão |
| 6 | Palco sem chrome | Sem header / footer / número de página / barra de marca |
| 7 | Animação orientada por conteúdo | Primeiro encontre a ação inerente, só use animação de entrada como fallback se não encontrar; movimento contínuo com cautela |
| 8 | Revelação múltipla ponto a ponto | 1 item = 1 step, proibido usar stagger para mostrar N itens simultaneamente |
| 9 | Mesmo tema em todo o vídeo | Não mudar a cor de fundo entre capítulos; cores / fontes seguem tokens, outras escalas livres por capítulo |
| 10 | Princípio de dupla fonte | script define o compasso, article define a densidade visual (cai no pool de informações) |
Consulta rápida de feedback comum do usuário
Tabela simplificada em references/CHAPTER-CRAFT.md Parte 8 "Consulta rápida de feedback comum". Crucial: Primeiro identifique em qual camada está (ritmo / visual / conteúdo / código), depois altere a menor fatia possível, não refaça o capítulo inteiro.
Recursos relacionados
Marcados com "quando ler", para evitar ler tudo de uma vez:
| Arquivo | Quando ler | Conteúdo |
|---|---|---|
references/SCRIPT-STYLE.md | Obrigatório na Fase 1.2 | Regras para transformar artigo → roteiro de narração, variações de plataforma |
references/OUTLINE-FORMAT.md | Obrigatório na Fase 1.2 | Especificação de campos do outline.md, convenções de nomenclatura, divisão de capítulos, pool de informações |
references/CHAPTER-CRAFT.md | Entrada única obrigatória para cada capítulo na Fase 2.4 | Parte 0 Dez princípios / Parte 1 5 perguntas para começar / Parte 2 Árvore de decisão relação→ação / Parte 3 Caixa de ferramentas visual / Parte 4 Duração / Parte 5 Antipadrões anti-AI / Parte 6 Regras rígidas de código / Parte 7 Auto-verificação de conclusão / Parte 8 Consulta rápida de feedback |
references/EXAMPLES/ | Opcional — ver estrutura | Exemplos de estrutura de capítulo (hook / list-reveal / case-tech-review); não copiar como modelo |
references/THEMES.md | Ao selecionar / criar / personalizar tema | Contrato completo de tokens + lista de temas integrados + fluxo de criação |
references/AUDIO.md | Ler apenas na Fase 3 | Fluxo de síntese de áudio agnóstico de provedor, uso do minimax integrado, caminho para trocar de provedor, resolução de problemas |
templates/scripts/tts-providers/README.md | Ao trocar / adicionar provedor TTS | Contrato de 3 funções + 2 integrados (minimax / openai) + 5 trechos de código prontos (ElevenLabs / edge-tts / macOS say / Azure / Google) |
references/RECORDING.md | Ler apenas na Fase 4 | Ferramentas de gravação de tela + pós-produção |
themes/ | Folhear no Checkpoint Plan / Fase 1.2 | Temas integrados (cada um com theme.json + tokens.css) |
scripts/scaffold.sh | Executar uma vez na Fase 2.1 | Scaffold do projeto com um comando |