Communitygithub.com

YuukiMarine/websiteskills

Transforma um artigo ou roteiro de narração em uma apresentação web 16:9 interativa que "parece um vídeo", com opção de sintetizar áudio de narração. Fluxo: artigo original → **produção única** de roteiro + outline + plano de desenvolvimento → **alinhamento único** do usuário em 5 pontos (roteiro / outline / tema / materiais / modo de desenvolvimento) → desenvolvimento web (capítulo por capítulo / sequencial / paralelo) → síntese de áudio opcional (agnóstico de provedor: MiniMax mmx-cli + OpenAI TTS integrados, substituíveis por ElevenLabs / edge-tts / Azure / TTS próprio). O **outline planeja apenas ritmo e densidade de informação, não animações** — as animações são projetadas no momento do desenvolvimento do capítulo, seguindo os princípios PRINCIPLES + ANTI-AI. Cada clique avança um compasso do roteiro, cada passo ocupa a tela inteira, a barra de progresso fica oculta e só aparece ao passar o mouse. Cenários de uso: fazer vídeos com páginas web (PPT dinâmico, mas sem ser PPT), transformar roteiros/artigos em apresentações interativas, criar tutoriais para gravação de tela no Bilibili/YouTube/WeChat Video, fazer demonstrações de produtos/talks com estilo cinematográfico. Esta Skill consolida uma metodologia de design + fluxo de colaboração — não está vinculada a nenhum estilo/fonte/cor específico —, portanto é reutilizável em qualquer tema e estética.

O que é websiteskills?

Esta skill transforma artigos ou roteiros de narração em apresentações web interativas de 16:9, projetadas para simular a experiência de um vídeo durante a gravação de tela. Ela combina um fluxo de trabalho estruturado com uma metodologia de design focada em conteúdo, permitindo que cada clique avance um compasso do roteiro com animações únicas. A skill suporta as plataformas Cursor, Codex, e Claude Code, e é ideal para criadores de conteúdo que desejam produzir vídeos dinâmicos e interativos sem a rigidez de um PPT tradicional. Seu diferencial está no processo colaborativo: o usuário alinha apenas cinco pontos-chave (roteiro, outline, tema, materiais e modo de desenvolvimento) antes de iniciar o desenvolvimento dos capítulos, cada um seguindo princípios rígidos de design animado e anti-AI. Além disso, oferece síntese de áudio opcional e agnóstica de provedor, com integração nativa para MiniMax e OpenAI TTS, facilitando a criação de vídeos completos com narração profissional.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skills/web-video-presentation

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 em if (step === N) no .tsx do capítulo deve ser igual a narrations.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ídaFonte da lista de verificação
script.mdSCRIPT-STYLE.md Auto-verificação em três camadas (forma / estrutura / ler em voz alta)
outline.mdOUTLINE-FORMAT.md Auto-verificação
Implementação de capítulo individual concluídaCHAPTER-CRAFT.md Auto-verificação de conclusão

Modo de execução (em ordem decrescente de capacidade, priorizar a forma mais isolada):

  1. 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).
  2. subAgent (segunda melhor opção): Se não houver capacidade Teams mas puder abrir subagent, usar subagent para seguir o mesmo fluxo.
  3. 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.

FaseObrigatório (ler sempre)Ler uma vez / Consultar conforme necessário
Fase 1.1-1.2 Escrita de conteúdoreferences/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 materiaisreferences/EXAMPLES/ (apenas para estrutura, não para copiar modelo); references/THEMES.md contrato completo de tokens
Fase 3 Síntese de áudioreferences/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çãoreferences/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 forneceO 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 diretamenteSalvar 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:

  1. Gerar script.md: De acordo com references/SCRIPT-STYLE.md, transformar o article em um roteiro de narração platformizado na língua original. Manter article.md sem 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).
  2. Gerar outline.md: De acordo com references/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 escreverO que o outline NÃO deve escrever
Divisão de capítulos / número de steps por capítulo / tempo estimadoTipos 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 articleValores numéricos de duração (não escrever 2.5s / 80120ms)
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.md ao iniciar cada passo, gerando uma verdadeira sensação de vídeo. Veja CHAPTER-CRAFT.md Parte 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

  1. Ler todos os themes/*/theme.json para obter nameZh / descriptionZh / bestFor / mood — não codificar a lista manualmente
  2. Com base no tipo de conteúdo / palavras-chave / tom de script.md, ativamente selecionar 2~3 temas mais adequados (correspondentes ao campo bestFor)
  3. 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.md para criar um themes/<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.md no 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:

  1. Cada subagent não vê a saída dos outros, não pode alinhar mecanicamente
  2. O código dos capítulos está fisicamente separado (uma pasta por capítulo / prefixo CSS próprio), não interferem entre si
  3. 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
  4. 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 / bestFor do theme.json do 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 modificar chapters.ts; ao concluir, executar npx 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árioCaminho recomendado
Fase 3 com áudio sintetizadoModo 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 puladaModo 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ípioUma frase
1Palco fixo 16:9Conteúdo em 1920×1080 + transform scale, sem responsividade
2Contador de steps globalCapítulo é função pura do step, sem temporizadores
3Cada step ocupa a tela inteiraif (step === N) return <FullScene />
4Compasso da narração = stepUm compasso = um step = uma ideia focada
5Controles de canto ocultosBarra de progresso / botão de navegação com opacity 0 por padrão
6Palco sem chromeSem header / footer / número de página / barra de marca
7Animação orientada por conteúdoPrimeiro encontre a ação inerente, só use animação de entrada como fallback se não encontrar; movimento contínuo com cautela
8Revelação múltipla ponto a ponto1 item = 1 step, proibido usar stagger para mostrar N itens simultaneamente
9Mesmo tema em todo o vídeoNão mudar a cor de fundo entre capítulos; cores / fontes seguem tokens, outras escalas livres por capítulo
10Princípio de dupla fontescript 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:

ArquivoQuando lerConteúdo
references/SCRIPT-STYLE.mdObrigatório na Fase 1.2Regras para transformar artigo → roteiro de narração, variações de plataforma
references/OUTLINE-FORMAT.mdObrigatório na Fase 1.2Especificação de campos do outline.md, convenções de nomenclatura, divisão de capítulos, pool de informações
references/CHAPTER-CRAFT.mdEntrada única obrigatória para cada capítulo na Fase 2.4Parte 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 estruturaExemplos de estrutura de capítulo (hook / list-reveal / case-tech-review); não copiar como modelo
references/THEMES.mdAo selecionar / criar / personalizar temaContrato completo de tokens + lista de temas integrados + fluxo de criação
references/AUDIO.mdLer apenas na Fase 3Fluxo 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.mdAo trocar / adicionar provedor TTSContrato de 3 funções + 2 integrados (minimax / openai) + 5 trechos de código prontos (ElevenLabs / edge-tts / macOS say / Azure / Google)
references/RECORDING.mdLer apenas na Fase 4Ferramentas de gravação de tela + pós-produção
themes/Folhear no Checkpoint Plan / Fase 1.2Temas integrados (cada um com theme.json + tokens.css)
scripts/scaffold.shExecutar uma vez na Fase 2.1Scaffold do projeto com um comando

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas