Painel de Controle de Vídeos Curtos
Um vídeo, da ideia à publicação, acontece dentro de um único diretório. Esta skill cuida de três coisas: como criar o diretório, como percorrer as cinco etapas e o que é considerado "aprovado" em cada etapa.
Ela não ensina como escrever um roteiro (isso é responsabilidade da short-video-plan), não substitui modelos de geração e não realiza a edição prática do vídeo. O que ela garante é: em qualquer produção, ao abrir o diretório, você sabe exatamente em que etapa está, o que fazer a seguir e se pode prosseguir.
I. As Cinco Etapas
S1 Roteiro/Storyboard → G1 → S2 Prompts → G2 → S3 Geração → G3 → S4 Entrega → G4 → S5 Publicação → G5 → Concluído
| Etapa | O que fazer | Principal Produto | Quem faz |
|---|---|---|---|
| S1 Roteiro/Storyboard | Tópico, tipo, estrutura, roteiro, storyboard de conteúdo | 01-plano-de-producao.md | short-video-plan |
| S2 Prompts | Storyboard → Lista de Ativos + Lista de Geração | 02-lista-de-ativos.md, 03-lista-de-geracao.md | short-video-prompt |
| S3 Geração | Preparar ativos, depois gerar segmentos de vídeo | 04-midias/ | short-video-assets + short-video-generate |
| S4 Entrega | Juntar segmentos, legendar, musicar, mixar | 05-video-final/ | Ferramenta de edição |
| S5 Publicação | Título, capa, hashtags, horário, identificação | 06-pacote-de-publicacao.md | Esta skill |
Avance apenas uma etapa por vez. Pular etapas é a principal fonte de retrabalho — se G2 não foi aprovado e você parte para a geração, o material gerado certamente não corresponderá aos números das cenas.
II. Padrão de Diretório (Esta Skill é a Única Autoridade)
Todos os produtos vão para o mesmo diretório. O local padrão é outputs/ na raiz do projeto. Outras etapas não devem definir suas próprias regras de diretório; todas obedecem a esta seção.
2.1 Estrutura
outputs/
└── 2026-09-29-nao-dormir-bem-como-tdah/
├── 00-status-do-fluxo.md
├── 01-plano-de-producao.md
├── 02-lista-de-ativos.md
├── 03-lista-de-geracao.md
├── 04-midias/
│ ├── 01-imagens-de-ativos/
│ ├── 02-primeiro-frame/
│ └── 03-segmentos/
├── 05-video-final/
│ └── video-final-v1.mp4
└── 06-pacote-de-publicacao.md
A utilidade dos prefixos numéricos: ao abrir o diretório, os arquivos são ordenados por fluxo de processo; você vê em que etapa está e o que falta, sem precisar de um arquivo de navegação extra.
2.2 Nome do Diretório
Formato fixo: YYYY-MM-DD-Titulo
| Item | Requisito |
|---|---|
| Data | Data de criação do diretório, não muda depois |
| Separador | Um hífen entre data e título; o título também usa hífens para conectar palavras |
| Tamanho | Título com 8–15 caracteres |
| Proibido | Barras (/, ), dois pontos, asteriscos, interrogação, aspas, colchetes, barra vertical, espaços e pontuação |
| Nomes Duplicados | Mesma data e mesmo título, adicione -2, -3 |
O título deve ser a frase mais reconhecível do tópico selecionado, não o nome da categoria:
| Inválido | Válido |
|---|---|
| Dica Educativa | Não dormir bem como TDAH |
| Vídeo TikTok | Comida quente por fora, fria por dentro |
| Tópico de 22 de outubro | Café em garrafa térmica esfria em meio dia |
Método de avaliação: Três meses depois, só de olhar o nome do diretório, você consegue lembrar de que vídeo se trata? Nomes de categoria você certamente não lembrará; o tópico, sim.
2.3 Três Regras de Ouro
- O nome do diretório, uma vez criado, não muda. Se mudar, uma série de caminhos de referência de mídia será quebrada. Se quiser alterar o título, mude o título de publicação no
06-pacote-de-publicacao.md, não mexa no diretório. - Não altere a data entre os dias. Se continuar no dia seguinte, o diretório ainda terá a data do dia em que foi criado, não crie um novo diretório.
- Um vídeo, um diretório. Séries, ramificações de matriz não viram subdiretórios; crie um novo diretório com um título que inclua um termo distintivo.
2.4 Primeiro Passo ao Iniciar
Quando o usuário disser "iniciar um novo vídeo", pergunte primeiro as três coisas, depois crie o diretório:
- Plataforma (Douyin / Weibo Video / Xiaohongshu)
- Duração alvo
- Direção em uma frase
Em seguida, faça quatro coisas em ordem:
- Gere o nome do diretório conforme 2.2, leia em voz alta para o usuário confirmar — esta é a única chance de renomear sem custo
- Crie o diretório e os quatro subdiretórios:
04-midias/01-imagens-de-ativos,02-primeiro-frame,03-segmentos,05-video-final - Escreva
00-status-do-fluxo.md: etapa atual = S1, preencha o perfil de aceitação do projeto, todos os cinco portões marcados como "não iniciado" - Passe para S1, entregue à camada de conteúdo
Se o nome não for confirmado antes da criação, o custo de renomear depois é por conta do usuário.
III. Arquivo de Status
00-status-do-fluxo.md é o ponto de salvamento deste vídeo. Atualize imediatamente após cada avanço de etapa, não acumule.
Campos obrigatórios:
| Campo | Função |
|---|---|
| Nome do diretório, data de criação, plataforma, duração alvo | Identificação |
| Etapa atual | Seis opções: S1 / S2 / S3 / S4 / S5 / Concluído |
| Resultado dos cinco portões | G1–G5 um por um: Aprovado / Reprovado / Não iniciado |
| Lista de produtos | Arquivos existentes + arquivos ausentes |
| Itens bloqueadores | Onde está travado agora, quem está esperando |
| Perfil de aceitação do projeto | Tipo de conteúdo, objetivo, intenção de ritmo, limite máximo de intervalo sem fala, como suporta momentos de silêncio, restrições rígidas, aprovador/condições de aprovação |
| Registro de versões | Uma linha por alteração: data + o que mudou + por quê |
Modelo em assets/flow-state-template.md.
Isso resolve um problema bem específico: trocar de sessão, pular uma semana ou mudar de pessoa para continuar; lendo este arquivo, é possível retomar. Sem ele, no terceiro dia você teria que revisar todo o material para lembrar onde parou.
IV. Os Cinco Portões
Os portões só têm dois resultados: Aprovado ou Reprovado. Se for Reprovado, pare nesta etapa. Não é permitido "fazer primeiro, vê depois".
G1 · Portão de Roteiro/Storyboard (S1 → S2)
- As cinco seções do
01-plano-de-producao.mdestão completas e passaram na auto-verificação das oito perguntas - A duração total do storyboard está com desvio ≤30% da meta
- Cada cena dura 2–6 segundos, numeração de cena contínua sem pulos
- Verificação de linha vermelha aprovada: sem eficácia não comprovada, sem depoimentos inventados, sem linguagem absolutista, sem informações pessoais
- Usuário confirmou o tópico e o roteiro
- Perfil de aceitação do projeto preenchido; se plataforma, duração alvo ou restrições rígidas não estiverem confirmadas, registre o valor padrão autorizado pelo usuário, caso contrário, pare em S1
- O perfil de aceitação declarou o limite máximo do intervalo sem fala; para projetos que permitem silêncio longo, a forma de suporte para os segmentos de silêncio foi esclarecida
- Cada cena tem preenchidos: função, percepção do público, dependências prévias, fatos visíveis-chave e intenção de duração; para segmentos sem fala, descreva o suporte por ação, som foley, música ou atmosfera
- Ao usar a skill de planejamento, execute seu
scripts/check_plan.pypara eliminar erros mecânicos de campo, duração e número de dependência; ao instalar apenas a skill de fluxo, verifique manualmente conforme a lista de verificação G1 e registre que o script não foi executado
G2 · Portão de Lista de Geração (S2 → S3)
- Cada prompt tem um número de cena correspondente, sem prompts extras
- A soma das durações de cada segmento difere da duração total do storyboard em ≤1 segundo
- Os números de ativos referenciados na lista de geração estão todos definidos na lista de ativos, sem referências pendentes
- O modo principal está definido: Primeiro/Último frame OU imagem de referência, escolha um; geração de texto para vídeo é usada apenas para cenas sem assunto principal
- Cenas com parâmetros de produto, embalagem, logotipo, etc., estão marcadas como "deve usar imagem real", não são delegadas à geração de texto para vídeo puro
- Para segmentos com fala, o texto original está escrito no prompt, idêntico palavra por palavra à narração do storyboard (narração não é dublada separadamente; se faltar, o segmento fica mudo)
- O campo "descrição visual" de cada prompt de segmento lista: assunto principal, estado, ação, ambiente, iluminação, plano, ângulo/posição de câmera, movimento de câmera e dependências/fatos visíveis; itens não aplicáveis têm explicação
- Fatos visíveis-chave, dependências prévias e intenção de duração do storyboard foram mapeados para o primeiro frame ou para a ação dentro do segmento
G3 · Portão de Material de Mídia (S3 → S4)
- Cada segmento tem uma versão utilizável; os que faltam estão escritos nos itens bloqueadores
- A geometria do produto não está deformada, a etiqueta está legível e inalterada
- Segmentos adjacentes podem ser conectados: mesmo produto, mesma direção de luz, mesmo formato de tela
- Pontos de identificação icônicos e suas quantidades na lista de características do IP/personagem foram verificados cena por cena no segmento finalizado
- Quando há múltiplos candidatos para a mesma cena, a versão escolhida está registrada na lista
- Segmentos com fala foram verificados auditivamente frase por frase: nenhuma frase faltando, nenhuma palavra-chave pronunciada erroneamente
- A conclusão da fala finalizada está registrada em
04-midias/00-veredito-de-fala.json; a transcrição de palavras-chave ambíguas serve apenas como auxílio para verificação auditiva - A revisão completa do material de todo o vídeo foi feita manualmente em ordem cronológica, verificando causalidade entre cenas, estado de personagens/produtos, continuidade espacial e ritmo; o storyboard de primeiro frame antes da geração não substitui este item
- Se houver uma linha do tempo de fala do segmento finalizado, faça uma pré-verificação de ritmo primeiro; se não houver legenda do vídeo final, registre para teste real em S4, não tome a pré-verificação como conclusão do vídeo final
- Itens de pós-produção como sons foley e sobreposição de texto na lista de geração têm um plano de execução em S4, sem promessas pendentes
G4 · Portão de Vídeo Final (S4 → S5)
- A duração real tem desvio ≤10% da meta
- Execute o script
scripts/check_rhythm.pydesta skill com a legenda do vídeo final e a duração real; o relatório e a conclusão da verificação auditiva são anexados ao00-status-do-fluxo.md; lacunas na legenda são apenas um proxy indicador para segmentos sem fala - A legenda corresponde ao que é realmente ouvido no áudio (não ao que está no roteiro original — se houver erro de fala, o que é ouvido prevalece)
- Voz clara, música de fundo não abafa a voz
- Formato de tela, resolução e taxa de quadros atendem aos requisitos da plataforma alvo
- O intervalo sem fala mais longo do vídeo final é determinado por verificação auditiva manual, com o relatório de lacunas de legenda auxiliando a localização; se exceder o valor declarado no perfil de aceitação e não estiver declarado como segmento não-verbal no storyboard, é rejeitado
- Intervalos declarados como permitindo silêncio longo devem ter ação, som foley, música ou atmosfera descritos no storyboard, e o produto entregue deve marcar o arquivo e o ponto de tempo correspondentes
- Todos os itens de pós-produção prometidos na lista de geração foram concluídos e podem ser localizados no produto, ou têm uma isenção explícita do aprovador
G5 · Portão de Pré-Publicação (S5 → Concluído)
- Categorias fortemente regulamentadas (medicamentos, suplementos, dispositivos médicos, finanças, educação) passaram por revisão separada
- Conteúdo gerado por IA foi identificado conforme exigido pela plataforma
- Título, capa, hashtags e horário de publicação estão prontos
- Sem informações pessoais, sem retratos ou locais não autorizados
V. Cartão de Transferência
As etapas só se comunicam por meio de arquivos, não através de "onde paramos mesmo". Ao final de cada etapa, preencha um cartão e escreva na seção "Transferência" do arquivo de status:
| Transferência | O que deve conter no cartão |
|---|---|
| S1 → S2 | Tabela de storyboard de seis colunas e detalhes de cada cena (percepção/dependências/fatos visíveis/intenção de duração), nome real e especificações do produto, informações que devem ser apresentadas realisticamente |
| S2 → S3 | Tarefa de geração de cada segmento: número do segmento, duração, prompt, número da imagem de referência, modo, número de candidatos |
| S3 → S4 | Lista de mídia: nome do arquivo, número do segmento, duração, usabilidade; se as falas foram verificadas auditivamente segmento por segmento, se o BGM já foi selecionado |
| S4 → S5 | Arquivo do vídeo final, duração, formato de tela, material de capa, pontos fortes e palavras-chave de hashtag |
Campos completos em references/stage-specs.md.
VI. Continuar um Vídeo Inacabado
Quando o usuário disser algo como "continue aquele vídeo sobre não dormir bem":
- Liste os diretórios sob
outputs/, faça a correspondência pelo nome; se não houver correspondência, pergunte, não adivinhe - Leia
00-status-do-fluxo.md, primeiro apenas a etapa atual e os itens bloqueadores, não leia todos os produtos imediatamente - Relate três linhas: onde parou, o que está bloqueando, qual o próximo passo
- Após confirmação, entre na etapa correspondente
Não refaça tudo do zero. Também não pule o arquivo de status para inferir a etapa — errar pode reabrir um portão já aprovado.
VII. Relacionamento com Sub-skills
| Camada | Quem | O que gerencia |
|---|---|---|
| Camada de Fluxo | Esta skill | Diretório, etapas, portões, status, transferência |
| Camada de Conteúdo | short-video-plan | Tópico, tipo, estrutura, roteiro, storyboard de conteúdo |
| Camada de Prompts | short-video-prompt | Storyboard → Lista de Ativos + Lista de Geração |
| Camada de Ativos | short-video-assets | Lista → Imagens: programar, gerar candidatos, aceitar, salvar |
| Camada de Geração | short-video-generate | Lista → Segmentos: criar tarefas, sondar downloads, verificar mídia, manter registros |
| Camada de Entrega | Ferramenta de edição | Juntar, legendar, musicar, mixar |
Três regras:
- A camada de conteúdo não define diretórios, apenas entrega o produto final ao local especificado pela camada de fluxo
- A camada de prompts não reorganiza o conteúdo, apenas traduz; esta skill não copia seu método de trabalho
- A camada de ativos não altera conteúdo ou prompts, apenas garante que a imagem seja criada, corresponda e seja aprovada
- A camada de geração não altera o design visual, apenas anima a imagem finalizada e mantém registros rastreáveis de tarefas
- A camada de fluxo não reescreve as diretrizes de escrita de nenhuma camada, apenas julga se o portão foi aprovado
Em caso de conflito: diretório e nomes de arquivo seguem esta skill; julgamento de conteúdo segue short-video-plan.
VIII. Limites
- Não escreve diretrizes de roteiro: tópico, estrutura, roteiro e escrita de storyboard estão na camada de conteúdo; esta skill não os repete
- Não substitui modelos de geração: define tarefas e padrões de aceitação, não garante que uma geração específica será bem-sucedida
- Não realiza edição prática: define padrões para o vídeo final, a montagem específica é feita na ferramenta de edição
- Não promete tráfego: os cinco portões garantem "fluxo sem lacunas, material conectável, publicação em conformidade", não garantem dados de desempenho
- Não substitui regras de plataforma e revisão legal: políticas de plataforma e leis mudam; categorias fortemente regulamentadas devem ser confirmadas separadamente
IX. Materiais de Referência (Carregar Conforme Necessário)
| Arquivo | Quando ler |
|---|---|
references/stage-specs.md | Antes de cada etapa, ao preencher o cartão de transferência |
references/delivery-and-publish.md | Em S4 para montar o vídeo final, em S5 para gerar o pacote de publicação |
references/regression-cases.md | Após modificar scripts ou critérios de portão |
assets/flow-state-template.md | Ao criar um novo fluxo, ao atualizar o status |
assets/publish-pack-template.md | Em S5 ao preencher o pacote de publicação |
O método de trabalho de S2 não está dentro desta skill; é responsabilidade da
short-video-prompt. Esta skill só cuida de: verificar G1 antes de entrar em S2 e aplicar G2 após gerar a nova lista.