Vídeo geral
Antes de usar este fluxo de trabalho, execute:
npx hyperframes skills update general-video
Um "no-op" bem-sucedido significa que o skill está atualizado. Informe uma falha de atualização em vez de continuar com base na memória.
1. Aplicar adaptadores de fonte transversais
- Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, correção de cor, LUT, tratamento/efeito, legenda ou operação de mídia, carregue
/media-usee siga../media-use/references/resolve.md(resolver, adotar, reutilizar) e../media-use/references/setup-providers.md(provedores, autenticação). Feedback vago de filmagens e estilos nomeados usam../media-use/references/media-treatments.mdantes de editar; não improvise efeitos de mídia suportados com CSS/SVG/opacidade. Antes da primeira ação autenticada do provedor, executenpx hyperframes auth statuse repita sua saída literalmente. Se estiver desconectado, aplique a proteção em../hyperframes-core/references/brief-contract.md: colaborativo aguarda o login ou uma escolha explícita de offline; autônomo informa o status e continua com um provedor offline disponível. Sinalize um bloqueador quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local por si só não requer proteção de autenticação. - Figma: Se alguma entrada for uma URL
figma.com, execute/figmaprimeiro. Construa a partir de seus ativos exportados, tokens, componentes ou quadros de storyboard. Não use chamadas brutas do conector Figma, pois elas ignoram a sanitização de SVG, a proveniência de mídia e a vinculação de tokens de marca.
Esses adaptadores não alteram o fluxo de trabalho selecionado por /hyperframes.
2. Iniciar a partir do estado do projeto
Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:
| Estado | Ação |
|---|---|
| Edição específica | Faça a edição, preserve as decisões de projeto existentes e, em seguida, reexecute as verificações afetadas. Não reabra a descoberta. |
BRIEF.md existe | Leia-o. Se workflow nomear outro fluxo de trabalho e flow não for companion, passe adiante. Não faça perguntas sobre o brief. |
Sem brief, mas hyperframes.json ou STORYBOARD.md existe | Retome dos arquivos e preferências registradas. Preencha BRIEF.md apenas com fatos conhecidos. |
| Criação nova | Execute /hyperframes e sua camada de intenção. Retorne aqui apenas para workflow: general-video ou flow: companion. |
Para um novo projeto, escolha um nome de diretório em kebab-case a partir do brief e faça o scaffold antes de escrever o brief:
npx hyperframes init "vídeos/<projeto>" --non-interactive --example=blank --skill=general-video
Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes-core/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados baseados em preferência nomeados pelo formato do brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registre padrões inferidos. Aqui <MEDIA_DIR> é o diretório de skill /media-use instalado e <PROJECT_ROOT> é o diretório que contém hyperframes.json. Se a camada de intenção adotou uma receita, aplique-a agora com node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <nome> e não pergunte novamente.
3. Interpretar a forma de execução
Use apenas os termos canônicos de ../hyperframes-core/references/brief-contract.md:
| Campo | Significado | Efeito |
|---|---|---|
flow | Quem dirige | automation: escolha e execute a rota. companion: cocrie em conversação. |
storyboard | Se o quadro é uma superfície de revisão | yes: execute a revisão do plano e esboço. no: construa sem o quadro. |
mode derivado | Como os portões de checkpoint se comportam | Siga o contrato do brief. Nunca peça ao usuário para nomear um modo. |
Não invente sinônimos para estes estados. Um sinal contínuo de "apenas construa" é tratado pela camada de intenção e chega como flow: automation, storyboard: no.
- Para
flow: automation, escolha a rota e declare-a em uma linha na primeira atualização de progresso. - Para uma edição específica, faça a edição sem inventar uma nova rota.
Fluxo de colaboração
Quando flow: companion:
- Leia
BRIEF.mde reconcilie## Ativose## Personalizaçõesaceitos com os artefatos do projeto. Complete o trabalho aceito que ainda está pendente; deixe o trabalho concluído em paz; não ofereça uma capacidade aceita novamente como se fosse nova. - Chegue como o diretor, não o empreiteiro. Um usuário que escolheu colaboração escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que você pode defender. O primeiro plano é o tratamento teto: o arco da história (pegue emprestado a lente de gênero mais próxima — menu § Lentes de gênero), a especificação de design, o tratamento de movimento de cada cena citado pelo nome (§ 5 da disciplina de plano), as transições, a identidade de áudio — música e marcas sonoras, ou silêncio deliberado — o material do usuário colocado, e uma abertura e fechamento projetados. Diga o que cada camada adiciona em uma linha; sinalize as caras (tempo de renderização, login, faturamento) ao nomeá-las. O usuário reduz um tratamento; nunca deve ter que montar um aprovação por aprovação.
- O teto pertence ao conceito, não à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O trabalho artístico sobe ao teto; o conteúdo nunca cresce além do que foi solicitado (§ 6).
- Entre checkpoints,
../hyperframes/references/capability-menu.mdfunciona de duas maneiras. Como a lista de gatilho: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como o canal de atualização de cada passagem: um checkpoint de plano, esboço ou construção pode carregar uma ou duas ofertas rastreadas apontadas para o material que o usuário está olhando ("a estática da cena 3 quer o tratamento de contagem regressiva"). Leia antes de oferecer; nunca despeje o catálogo completo. - Após o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção correspondente do corpo de
BRIEF.mdimediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente. - Mantenha os mesmos portões de storyboard, validação, pré-visualização final e aprovação de renderização. Colaboração muda quem dirige, não o que a qualidade exige.
4. Carregar conhecimento necessário antes de cada estágio
Estas leituras são obrigatórias quando sua condição corresponde:
| Condição | Leia antes de agir |
|---|---|
| Qualquer HTML de composição ou layout de cena | /hyperframes-core; use references/determinism-rules.md para seu contrato de layout |
| Qualquer criação não trivial ou tratamento visual | /hyperframes-creative → references/house-style.md e references/video-composition.md |
| Qualquer movimento, animação ou transição de cena | /hyperframes-animation; siga seu roteamento para as regras, adaptadores, blueprints ou referências de transição correspondentes |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md e ../hyperframes-core/references/review-loop.md |
| Qualquer ativo ou operação de mídia, incluindo narração, música de fundo, efeitos sonoros, legendas, correção de cor ou transformações | /media-use; para reprodução e posicionamento de framework também leia /hyperframes-core → references/variables-and-media.md |
| Montagem de múltiplas cenas | ../hyperframes-core/references/production-loop.md |
flow: companion, antes do primeiro plano | /hyperframes-creative → references/story-spine.md e references/house-style.md; a lente de gênero mais próxima e o ../hyperframes/references/capability-menu.md completo — o tratamento teto é projetado a partir destes, não lembrado |
| Uma oferta de capacidade de colaboração, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade de fluxo de trabalho cruzado | ../hyperframes/references/capability-menu.md |
| Uma especificação de design existe, antes da aprovação final | /hyperframes-creative → references/design-adherence.md |
Não substitua estas leituras por recordação. A divulgação progressiva economiza contexto apenas quando a referência correspondente é realmente carregada.
5. Executar a composição
Use esta ordem de dependência. Pule um estágio apenas quando sua entrada estiver ausente.
-
Plano. Declare o arco do visualizador, estrutura, ritmo e driver de duração. Use um arquivo para uma cena curta única; use sub-composições para três ou mais cortes de cena difíceis ou qualquer cena reutilizada. Leia
/hyperframes-creative→references/story-spine.mdpara arcos narrados,references/beat-direction.mdpara ritmo e/hyperframes-core→references/composition-patterns.mdpara estrutura. Para um brief de múltiplas cenas aberto, expanda o prompt através de/hyperframes-creative→references/prompt-expansion.md. Um plano de múltiplas cenas cita a forma de cada cena: um id de blueprint de/hyperframes-animation→blueprints-index.mdquando um se encaixa, ou as regras nomeadas que compõe derules-index.mdquando nenhum se encaixa — nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Um plano de múltiplas cenas também é registrado como o artefato de despacho: um bloco## Quadro Npor cena emSTORYBOARD.md—status: outline, umsrc:declarado, a citação do blueprint/regras e o texto da batida — mesmo quandostoryboard: no. O bloco é a unidade de despacho; o quadro é apenas a superfície de revisão. -
Revisar o plano quando solicitado. Para
storyboard: yes, execute o loop de revisão compartilhado sobre esses blocos. Parastoryboard: no, continue sem abrir o quadro. Quando uma pausa de plano acontecer de qualquer forma, incorpore a concessão de delegação de subagente (necessária para codex no despacho da etapa 4) nessa pausa, em vez de parar novamente mais tarde. -
Resolver dependências. Instale blocos de registro antes do trabalho paralelo. Prepare ativos de usuário, adote mídia existente e resolva apenas o que o brief exige. Comece o áudio cedo quando seus tempos determinarem a duração.
-
Construir cenas. Para uma peça curta de cena única, implemente a cena em seu momento mais visível antes de adicionar movimento (o wireframe confirmado, quando presente, é esse estado final e não deve ser redesenhado), então anime a partir de seu blueprint ou regras citadas — leia o corpo completo da receita (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md) antes de escrever o movimento.O despacho só compensa em escala. Criar pacotes e aquecer contextos de worker frescos custa minutos e tokens reais: um filme de até ~6 cenas curtas constrói MAIS RÁPIDO em linha, neste contexto, uma cena após a outra (medido: 5 cenas curtas ≈ 9 min em linha vs ≈ 21 min com pacotes). Distribua apenas quando o plano exceder isso — mais cenas, ou individualmente pesadas — e então dê a cada worker 2–3 cenas, não uma, e gere todos os workers em uma única onda (uma segunda onda quase dobra o tempo). Ao despachar:
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"O construtor escreve um pacote limitado por cena sob
.hyperframes/frame-packets/(o bloco exato de storyboard da cena + o corpo do blueprint + cada regra citada, embutida) e_role.md(../hyperframes-core/references/frame-worker.md). Invoque para cada pacote:hyperframes-codex: "Uma equipe de edição de vídeo está completando a cena #N do quadro. Leia o plano de cena e artefatos; siga as regras do blueprint e o contrato _role.md. Retorne artefatos de cena completos."Colete retornos em
.hyperframes/frame-packets/no diretório de projeto e apenas então monte na saída final. -
Verificar. Valide as pré-condições de renderização sem renderizar e sinalize os problemas de artefato em vez de limpá-los silenciosamente. Para verificação de contrato de sub-composição explícita, renomeie
transaction-rooteupdate-destination; caso contrário, pule a renomeação. -
Renderizar. Execute
npx hyperframes rendere envie a aprovação através das verificações de revisão. Para o modo colaborativo, após o usuário aprovar uma pré-visualização, executenpx hyperframes rendercomo estágio final.
6. Tratamento de conteúdo
- O conteúdo nunca cresce além do que o brief solicitou. Esta habilidade não gera mais material de origem, não estende a duração sem autorização e não adiciona cenas ou quadros além do plano. Dentro do envelope do brief aplica-se o tratamento teto do § 3.
- A verdade da história decide quais cenas existem; o plano as veste. Se um brief pede "dois ângulos da bandeira", a primeira passagem fornece uma cena de dois ângulos da bandeira, não três cenas de ângulos amplos e um passeio de drone.
Registro
Registre cada chamada de adaptador de mídia como uma decisão em Configuração: source: <adaptador> e as ações realizadas dentro dele. Registre o modelo escolhido para qualquer chamada de modelo não determinística em Modelos. Nunca registre o diretório de trabalho atual.