Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Vídeo geral
Execute npx hyperframes usage --json no início, a menos que o workflow tenha acabado de lê-lo; depois, verifique novamente em marcos como após o rascunho e antes da renderização. Leia as janelas disponíveis e os tempos de reset. Se o uso for desconhecido, diga isso sem adivinhar a franquia; mantenha o escopo e as escolhas do workflow com o usuário.
Antes de confiar neste workflow, execute:
npx hyperframes skills update general-video
Um no-op bem-sucedido significa que a skill está atualizada. Exiba 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, logo, 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 transmita sua saída literalmente. Se estiver desconectado, aplique a trava em../hyperframes/references/brief-contract.md: colaborativo aguarda o login ou uma escolha explícita de modo offline; autônomo informa o estado e continua por meio de um provedor offline disponível. Exiba um bloqueador quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local por si só não requer trava 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 diretas do conector Figma, pois elas ignoram a sanitização SVG, a proveniência da mídia e a vinculação de tokens de marca.
Esses adaptadores não alteram o workflow 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 existentes do projeto, depois reexecute as verificações afetadas. Não reabra a descoberta. |
BRIEF.md existe | Leia-o. Se workflow nomear outro workflow 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 a partir de 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 "videos/<projeto>" --non-interactive --example=blank --skill=general-video
Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados e 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 da skill /media-use instalada 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 da execução
Use apenas os termos canônicos de ../hyperframes/references/brief-contract.md:
| Campo | Significado | Efeito |
|---|---|---|
flow | Quem dirige | automation: escolhe e executa a rota. companion: cocria em conversa. |
storyboard | Planejar, esboçar e revisar antes da construção | yes: executa o plano e a revisão do esboço (storyboard.html). no: constrói sem isso. |
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 esses 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.
Para um corte brusco, aparar, emendar ou reordenar filmagens existentes, duplique a mesma fonte de vídeo em vários elementos de clipe. Em cada cópia, defina o intervalo de origem com data-media-start mais data-duration, depois defina o posicionamento/ordem de autoria com data-start. Cada segmento de vídeo mantém seu som: o som permanece no clipe (data-has-audio="true"), então cortar o vídeo corta seu som. O /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedade visual, como zoom, punch, pan, crop, máscara ou clip-path em um wrapper interno. Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.
Fluxo Companion
Quando flow: companion:
- Leia
BRIEF.mde reconcilie os## Assetse## Customizationsaceitos 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 diretor, não como empreiteiro. Um usuário que escolheu companion 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 de teto: o arco da história (pegue 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 planejamento), 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 corta um tratamento; eles nunca devem ter que montar um, aprovação por aprovação.
- O teto pertence ao conceito, não ao kit de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O ofício sobe ao teto; o conteúdo nunca cresce além do que foi pedido (§ 6).
- Entre checkpoints,
../hyperframes/references/capability-menu.mdfunciona de duas maneiras. Como lista de disparo: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como 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 estatística da cena 3 quer o tratamento de contagem regressiva"). Leia-o antes de oferecer; nunca despeje o catálogo completo. - Depois que 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. Companion muda quem dirige, não o que a qualidade exige.
4. Carregar conhecimento necessário antes de cada etapa
Estas leituras são obrigatórias quando sua condição corresponder:
| 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/references/storyboard-format.md e ../hyperframes/references/review-loop.md |
| Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, correção de cor ou transformações | /media-use; para reprodução e posicionamento do framework, leia também /hyperframes-core → references/variables-and-media.md |
| Montagem de várias cenas | ../hyperframes/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 de teto é projetado a partir destes, não lembrado |
| Uma oferta de capacidade companion, captura, grade de batidas, vídeo generativo, mapa, publicação ou capacidade de workflow 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 essas 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 uma etapa apenas quando sua entrada estiver ausente.
-
Plano. Declare o arco do espectador, estrutura, ritmo e condutor de duração. Use um arquivo para uma cena curta única; use sub-composições para três ou mais cortes duros de cena 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 várias cenas aberto, expanda o prompt através de/hyperframes-creative→references/prompt-expansion.md. Um plano de várias 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 ele 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. Pesquise o catálogo ao vivo antes de planejar construir qualquer aparência nomeada você mesmo: para cada aparência, efeito, tratamento ou transição que o brief nomeia — "scanlines CRT", "glitch", "grão de filme", "varredura de brilho", "explosão de confete" — executenpx hyperframes catalog --query "<a aparência, em inglês simples>" --jsone leia os principais resultados antes de o plano nomear como essa aparência será construída. A pesquisa não precisa de nada instalado: nenhum projeto, nenhumaddanterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) de qualquer diretório, portanto, também se aplica a uma aparência que o usuário solicita no meio da construção. Blocos que o plano nomeia são instalados no estágio 3; crie uma aparência manualmente apenas depois que uma pesquisa por ela não retornar nada que se encaixe. Um plano de várias 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, uma lista de transições de entrada e saída, a orientação do ativo ("inserir ativo X aqui"), e a duração-alvo em segundos. Nenhum ativo é aplicado ainda. -
Esboço. Construa
storyboard.htmlusando../hyperframes/references/storyboard-format.md; quando a etapa de plano existe, o esboço a usa como autoridade; quando a etapa de plano é ignorada (edição curta específica, cena única, nenhum storyboard), o esboço é opcional. Parastoryboard: no, pule completamente os estágios 2 e 5 do plano. As miniaturas podem ser texto; caixas delimitadoras com IDs de blueprint e chamadas de "inserir filme de estoque de [descrição] aqui" são permitidas. A pós-produção é proibida neste estágio — sem efeitos, sem suavização, sem layout fino. -
Criar ativos. Crie ativos de mídia ausentes (Ímã de abastecimento), arte SVG, mashups de áudio, locuções ou cenas de vídeo sintéticas (geração). Execute as ações necessárias e coloque-as em sua árvore de ativos com referências de layout. Ímãs de abastecimento de primeira execução aplicam-se aqui; planilhas de lotes adiadas não. Não empilhe edições de camadas de mídia em um momento — cada ativo obtém sua edição em seu nó de composição. Se qualquer ativo necessitar de uma capacidade não instalada, instale-o de
../hyperframes/references/capability-menu.mdou relate-o como um bloqueador que requer instalação manual. -
Pré-visualização de construção. Execute o construtor de pré-visualização. Relate um erro se a pré-visualização falhar. Para multi-cena, use o loop de produção + loop de revisão. Exiba a pré-visualização final.
-
Avaliar. Avalie a saída renderizada. Leia
/hyperframes-creative→references/design-adherence.mdquando uma especificação de design existir ereferences/video-composition.mdpara regras de layout. Corrija problemas de layout, design e movimento (regressão) iterando na composição e reconstruindo até que a saída atenda aos requisitos da especificação.
6. Documentar decisões
Após cada etapa, registre as escolhas não padrão que afetam os resultados em uma seção ## Decisões de BRIEF.md. Inclua a justificativa: qual alternativa foi considerada e por que foi rejeitada. Registre preferências confirmadas através do mecanismo de prefs. Nunca registre palpites.
7. Vídeo de saída
Após a renderização bem-sucedida, não modifique, remova ou substitua o vídeo de saída. A saída de um construtor geral de vídeo é um arquivo de vídeo; não o trate como ativo de origem para extração de quadros, análise ou transformação posterior.