Communitygithub.com

drama-forge

Pipeline automatizada para produção de vídeos curtos verticalizados com continuidade de enredo, personagens e qualidade.

O que é drama-forge?

O Drama-Forge é uma skill especializada em automatizar a produção em lote de vídeos curtos verticalizados, voltada para séries de continuação em plataformas como TikTok, Reels e Shorts. Ela integra todas as etapas do fluxo: roteirização (LLM), geração de vídeo (com MiniMax), dublagem (TTS), edição, e um sistema de controle de qualidade que garante que cada episódio tenha pelo menos 10 segundos, segmentos únicos (sem repetições) e uma estrutura dramática envolvente (gancho no primeiro frame). A skill mantém a consistência de personagens e enredo através de um arquivo de estado (`state.json`), que registra o resumo dos episódios, arcos dramáticos e a evolução dos personagens. Ao final de cada episódio, o pipeline verifica automaticamente a qualidade e, se aprovado, atualiza o estado e gera o próximo episódio — tudo com custo controlado e sem necessidade de intervenção manual. Se um episódio falhar, a correção é feita com `--force-episode N`, que reverte o estado e limpa os artefatos antes de reexecutar.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add ez-xu/drama-forge

Perguntar na sua IA favorita

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

Documentação

/drama-forge — Pipeline de Vídeos Curtos de Continuação

Você é um operador de pipeline de produção de vídeos curtos de continuação. O usuário fornece o nome da série, e você executa o orquestrador, que automatiza todo o fluxo: "roteiro → vídeo → dublagem → edição → controle de qualidade → atualização de estado". O resultado é um vídeo vertical pronto para publicação, e o pipeline avança automaticamente para o próximo episódio (consistência de personagens + continuidade do enredo garantidas pelo arquivo de estado).

Gatilho

O usuário invoca /drama-forge ou menciona naturalmente:

/drama-forge gerar O Renascer de Su Wan próximo episódio
/drama-forge reexecutar episódio 1-2 (problemas de repetição de cena na última vez)
/drama-forge gerar em lote 3 episódios, conto de vingança renascido no estilo antigo
/drama-forge executar auto-verificação primeiro

Comando Único (sempre tente primeiro)

cd <diretório da skill>
python -X utf8 scripts/run_pipeline.py --series "Nome da Série" [parâmetros]

Todas as etapas estão na ordem dentro do código do orquestrador — não execute scripts manualmente passo a passo.

ParâmetroFinalidade
--series NAMENome da série (obrigatório)
--to-episode NGerar continuamente até o episódio N
--force-episode NForçar reexecução do episódio N (reverte estado + limpa artefatos atomicamente)
--with-bgmGerar automaticamente música de fundo AI (music-2.6)
--genre / --directiveGênero / instruções adicionais de roteiro
--dry-runAuto-verificação sem custo, não chama APIs pagas
--workdir PATHDiretório de trabalho (onde fica series/)
--model IDSobrescrever modelo LLM (padrão: abab6.5s-chat)

No Windows, python deve incluir -X utf8 (console GBK quebra caracteres chineses).

Fluxo de Trabalho Padrão

  1. Auto-verificação (obrigatória após alterações no código, sem custo): python -X utf8 scripts/run_pipeline.py --dry-run
  2. Verificação de saldo: --dry-run não verifica saldo. Antes de gerar, faça uma chamada mínima de chat para confirmar (se InsufficientBalanceError parar, informe o usuário para recarregar — note que o MiniMax vídeo só aceita "saldo da plataforma aberta", o dinheiro do pacote de tokens não pode ser usado para vídeo)
  3. Geração: python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm]
  4. Aceitação: Após aprovação pelo controle de qualidade (interno), verifique o arquivo final series/<nome da série>/episodes/epXXX.mp4 + series/<nome da série>/.usage.json (detalhes de custo)

Controle de Qualidade (interno, aborta automaticamente se falhar)

Após cada episódio, o verify é executado automaticamente:

  • Todos os hashes MD5 dos segmentos são diferentes (defesa direta contra repetição acidental de cenas)
  • O arquivo final possui streams de vídeo + áudio, duração ≥ 10s
  • O roteiro contém hook_line (gancho de texto sobreposto no primeiro frame) + duração de cena não uniforme (sem metrônomo)

Falha no controle de qualidade = não atualiza estado, não gera próximo episódio, não gasta dinheiro do próximo. Corrija e reexecute com --force-episode N.

Mecanismo de Continuação (não modifique arquivos de estado manualmente)

  • Personagens/mundo/preparação/resumo ficam em series/<nome da série>/state.json
  • A cada episódio: LLM lê o estado → gera roteiro → após conclusão, escreve o estado de volta (resumo, adição/remoção de preparação, estado de personagens)
  • Reexecutar um episódio deve usar --force-episode N (reverte estado + limpa artefatos automaticamente) — proibido deletar arquivos manualmente
  • Novo personagem: coloque uma foto de visualização (frente/meio corpo/fundo sólido) em assets/characters/ e registre em state.json

Detalhes Completos

  • references/api-reference.md — Todos os parâmetros reais da API (não "otimize")
  • references/pitfall-log.md — Incidentes → causa raiz → defesa (consulte sempre antes de repetir erros)
  • references/quality-gates.md — Explicação dos itens de verificação de qualidade e auto-verificação
  • references/content-quality.md — Roteiro em cinco atos/gramática de gancho/princípios de retenção
  • assets/state.schema.json — JSON Schema do state.json
  • assets/series-template.json — Template de inicialização para novas séries

Habilidades Relacionadas