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 acabado de ler; verifique novamente em marcos como após o rascunho e antes da renderização. Leia as janelas disponíveis e os tempos de redefinição. Se o uso for desconhecido, informe sem adivinhar a permissão; mantenha o escopo e as escolhas de 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 significa que a skill está atualizada. Exiba uma falha de atualização em vez de continuar a partir da memória.
1. Aplicar adaptadores de fonte transversais
- Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, grade, 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). Comentários vagos de filmagem 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 retransmita sua saída literalmente. Se estiver desconectado, aplique a barreira em../hyperframes/references/brief-contract.md: em modo colaborativo, aguarde o login ou uma escolha explícita off-line; em modo autônomo, informe o status e continue através de um provedor off-line disponível. Exiba um bloqueador quando nenhum provedor off-line puder satisfazer uma capacidade necessária. A adoção local sozinha não requer uma barreira de autenticação. - Figma: Se alguma entrada for uma URL
figma.com, execute/figmaprimeiro. Construa a partir de seus assets exportados, tokens, componentes ou quadros de storyboard. Não use chamadas brutas do conector Figma porque elas ignoram a sanitização SVG, a proveniência de mídia e a vinculação de token 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, passe adiante. Não faça perguntas sobre o brief. |
Sem brief, mas hyperframes.json ou STORYBOARD.md existe | Retome a partir 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 andaine antes de escrever o brief:
npx hyperframes init "videos/<project>" --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 com suporte de preferência confirmados 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 <name> e não pergunte novamente.
3. Interpretar a forma de execução
Use apenas os termos canônicos de ../hyperframes/references/brief-contract.md:
| Campo | Significado | Efeito |
|---|---|---|
flow | Quem dirige | automation: escolha e execute a rota. companion: cocrie em conversação. |
storyboard | Planejar, esboçar e revisar antes da construção | yes: execute o plano e a revisão do esboço (boards/storyboard.html, formato em ../hyperframes-creative/references/storyboard-recipe.md). no: construa sem ele. |
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 seco, 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, em seguida, defina a colocação/ordem criada
com data-start. Cada segmento de vídeo mantém seu som: o som permanece no clipe (data-has-audio="true"), portanto, cortar o vídeo corta seu som. /hyperframes-core possui esta edição temporal;
use /hyperframes-keyframes apenas para animação de propriedade visual, como
zoom, punch, pan, crop, mask 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 o diretor, não o contratante. Um usuário que escolheu o acompanhamento 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 do 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, cobrança) 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 à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O trabalho artesanal sobe até o 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 gatilhos: 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 plano, esboço ou checkpoint de 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 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. O acompanhamento 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 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 ou tratamento visual não trivial | /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 asset 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 host vêm primeiro para essas); 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, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade de fluxo de trabalho cruzado de acompanhamento | ../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 um estágio apenas quando sua entrada estiver ausente.
- Plano. Declare o arco do visualizador, estrutura, ritmo e direcionador de duração. Use um arquivo para uma única cena curta; use subcomposiçõ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 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 — os 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 você mesmo qualquer look nomeado: para cada look, efeito, tratamento ou transição que o brief nomeia — "linhas de varredura CRT", "glitch", "grão de filme", "varredura de brilho", "explosão de confete" — executenpx hyperframes catalog --query "<o look, em inglês simples>" --jsone leia os principais resultados antes que o plano nomeie como esse look 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...