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 fluxo de trabalho o tenha lido recentemente; verifique novamente em marcos como após o rascunho e antes da renderização. Leia as janelas disponíveis e os tempos de reinicialização. Se o uso for desconhecido, informe isso sem adivinhar a cota; mantenha o escopo e as escolhas do fluxo de trabalho com o usuário.
Antes de confiar neste fluxo de trabalho, execute:
npx hyperframes skills update general-video
Um no-op bem-sucedido indica que a skill está atualizada. Relate uma falha de atualização em vez de continuar com base na memória.
1. Aplicar adaptadores de origem abrangentes
- Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, gradação, 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 desconectado, aplique a barreira em../hyperframes/references/brief-contract.md: colaborativo aguarda o login ou uma escolha offline explícita; autônomo informa o status e continua através de um provedor offline disponível. Relate um bloqueio quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local sozinha não requer barreira 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 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 existentes do projeto e 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, repasse. Não faça perguntas sobre o brief. |
Sem brief, mas hyperframes.json ou STORYBOARD.md existe | Retome de 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 crie o esqueleto 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 com base em preferências 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 plano e revisão de esboço (storyboard.html). no: constrói sem isso. |
mode derivado | Como os pontos de verificação se comportam | Siga o contrato do brief. Nunca pergunte 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 rígido, corte, emenda ou reordenação de filmagem existente, 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, então defina o posicionamento/ordem autoral 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. /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedades visuais, como zoom, punho, pan, corte, máscara ou clip-path em um wrapper interno.
Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.
Fluxo de acompanhamento
Quando flow: companion:
- Leia
BRIEF.mde reconcilie## 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 o modo acompanhante 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 emprestada 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 corta um tratamento; eles nunca devem ter que montar um 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 ofício sobe ao teto; o conteúdo nunca cresce além do que foi solicitado (§ 6).
- Entre os pontos de verificação,
../hyperframes/references/capability-menu.mdfunciona de duas maneiras. Como lista de gatilho: 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 ponto de verificação 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"). 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 do
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. O modo acompanhante 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 | Ler 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, gradação ou transformações | /media-use (as próprias ferramentas de música e efeitos sonoros do aplicativo hospedeiro vêm primeiro para aquelas); 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 de acompanhante, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade entre fluxos de trabalho | ../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 direcionador de duração. Use um arquivo para uma cena curta única; use subcomposições para três ou mais cortes de cena rígidos 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 visual nomeado você mesmo: para cada visual, 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 "<o visual, em inglês simples>" --jsone leia os principais resultados antes que o plano nomeie como esse visual será construído. 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, então também se aplica a um visual que o usuário solicitar no meio da construção. Blocos que o plano nomeia são instalados na etapa 3; crie um visual manualmente apenas após uma pesquisa por ele não retornar nada que se encaixe. Um plano de várias cenas também é registrado como artefato de despacho: um bloco## Frame Npor cena emSTORYBOARD.md—status: outline, umasrc:declarada, a citação de blueprint/regras, um
… [truncado para tradução]