Bookflow Studio
Use esta skill para um episódio real de vídeo de livro ou quando o criador pedir para demonstrar este workflow. Comece lendo o AGENTS.md e docs/workflow.md do repositório; use docs/project-format.md ao preencher ou solucionar problemas em arquivos de episódio.
Executar um episódio
Trabalhe dentro da pasta de episódio que o criador selecionar. Se nenhuma existir, pergunte qual livro ele deseja cobrir ou se prefere uma recomendação; não escolha silenciosamente um produto para promover. Use npm run bookflow -- init <episode-folder> para um novo episódio e preserve quaisquer arquivos existentes.
Oriente o criador através destas entregas, usando a CLI quando aplicável:
- Confirme o título exato, autor, edição e público-alvo. Pesquise detalhes factuais em fontes públicas apropriadas; salve URLs e o que cada fonte suporta em
sources.mdeclaims.csv. Se o criador conectou um serviço de anotações de leitura e autorizou seu uso, use apenas suas anotações acessíveis como sinais de tópico; não copie longas passagens nem trate destaques como fatos públicos. - Redija uma narração original em
script.md. Separe fatos com fonte de interpretação e experiência pessoal. Se o criador fornecer um vídeo de referência, analise sua estrutura, ritmo e duração aproximada; não reutilize suas falas. Se a referência não puder ser acessada, informe e deixe clara a limitação. - Mostre o roteiro completo e aguarde aprovação explícita antes de preparar mídias de produção. Mantenha um ID de segmento estável por fala narrada. Uma solicitação para escrever ou revisar apenas um roteiro termina neste ponto de revisão.
- Após a aprovação do roteiro, construa
storyboard.csv, combinando cada segmento falado exatamente e especificando um visual relevante, proveniência/direitos, texto na tela, movimento e duração. Mostre o storyboard e aguarde aprovação antes de buscar ou gerar ativos de produção. - Após a aprovação do storyboard, use apenas ferramentas de mídia realmente disponíveis no ambiente atual. Registre origem e direitos dos ativos. Para narração, use a gravação do criador ou uma fonte de voz explicitamente aprovada. Se uma ferramenta ASR como Whisper estiver disponível, use seus timestamps como ponto de partida e verifique-os com a faixa de voz real. Mantenha legendas em chinês exatas; inglês opcional deve permanecer legível em um telefone. Exporte SRT com
npm run bookflow -- export-srt <episode-folder>. - Monte e visualize o vídeo apenas se um editor ou renderizador adequado estiver disponível (por exemplo, HyperFrames ou CapCut). Não afirme que a CLI deste repositório gera imagens, fala ou vídeo: ela prepara arquivos de episódio, verifica estrutura/alinhamento e exporta legendas. Nomes de ferramentas aqui são integrações opcionais, não dependências incluídas; veja
docs/integrations.md. - Execute
npm testenpm run bookflow -- check <episode-folder> --releasepara um candidato a lançamento. Explique o que as verificações automatizadas podem e não podem estabelecer. O criador ainda deve revisar precisão factual, direitos, legibilidade em dispositivos móveis e o vídeo renderizado.
Para um vídeo que apresente o próprio Bookflow Studio, descreva apenas funcionalidades presentes neste repositório e verificadas executando-as. Distinga o workflow guiado pela Codex das funções concretas da CLI; nunca apresente geração de mídia planejada ou dependente de ferramentas como já automatizada pelo código.
Mantenha ativos de episódio e trabalho privado fora do repositório público. Não faça commit de credenciais, voz bruta, dados de conta, capas sem licença, música, capturas de tela ou mídia de cliente.