Vídeo geral
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. 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, 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). Feedback vago de footage 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 repasse sua saída literalmente. Se desconectado, aplique a barreira em../hyperframes-core/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. Informe um bloqueador quando nenhum provedor offline 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 ativos 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 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, 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, entregue. 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 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-core/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-core/references/brief-contract.md:
| Campo | Significado | Efeito |
|---|---|---|
flow | Quem dirige | automation: escolha e execute a rota. companion: cocrie em conversa. |
storyboard | Se o quadro é uma superfície de revisão | yes: execute revisão de plano e esboço. no: construa sem o quadro. |
mode derivado | Como as barreiras 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.
Fluxo companion
Quando flow: companion:
- Leia
BRIEF.mde reconcilie## Assetse## Customizaçõ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 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 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) conforme as nomeia. O usuário reduz 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 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 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 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"). 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 de corpo correspondente do
BRIEF.mdimediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente. - Mantenha as mesmas barreiras 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 obrigató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-core/references/storyboard-format.md e ../hyperframes-core/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; para reprodução e posicionamento no framework, leia também /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 de teto é projetado a partir destes, não lembrado |
| Uma oferta, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade de fluxo de trabalho cruzado companion | ../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 salva 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 motor de duração. Use um arquivo para uma cena única 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 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 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. 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 de 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, dobre a concessão de delegação do subagente (necessária pelo codex para o 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 do usuário, adote mídia existente e resolva apenas o que o brief exige. Inicie o áudio cedo quando seus tempos ditarem 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), depois 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ó se paga em escala. Criar pacotes e aquecer contextos de worker fresco custa minutos e tokens reais: um filme de até ~6 cenas curtas constrói MAIS RÁPIDO inline, neste contexto, uma cena após a outra (medido: 5 cenas curtas ≈ 9 min inline vs ≈ 21 min empacotado). 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 spawn 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 em .hyperframes/frame-packets/ (o bloco de storyboard exato da cena + o corpo do blueprint + cada regra citada, inline) e _role.md (../hyperframes-core/references/frame-worker.md).
5. Validar. Execute todas as verificações de qualidade:
- Um problema de mídia ou provedor? Execute
/media-use→references/quality.md. - Um problema de composition? Execute
/hyperframes-core→references/quality.md. - Um problema de movimento? Execute
/hyperframes-animation→references/quality.md. - Um problema de criatividade? Execute
/hyperframes-creative→references/quality.md. - Um problema de licenciamento ou conformidade? Execute
../hyperframes/references/compliance.md.
- Pré-visualizar aprovação e ajuste fino. Quando a saída do build existir, leia
../hyperframes-core/references/preview-loop.mde, em seguida, executenpx hyperframes previewpara iniciar o servidor de pré-visualização. Mostre ao usuário: "Pré-visualização disponível em: " e espere feedback. Faça ajustes finos baseados no feedback e revalide. - Renderizar a saída final. Execute
npx hyperframes build --productione forneça ao usuário o caminho de saída localizado e uma breve descrição. Não peça aprovação de renderização; a aprovação já ocorreu.
6. Manter o escopo e a profundidade
- Nunca aumente o escopo do vídeo. A cena, duração e complexidade do brief são os limites. Um tratamento projetado não adiciona cenas, prolonga a duração ou adiciona complexidade não solicitada.
- Cada cena deve conter seu próprio conceito. Uma cena que apenas conecta duas outras é uma transição, não uma cena. Cada cena deve avançar a mensagem, não apenas a duração.
- A profundidade do projeto é medida em suporte de mensagem, não em densidade de camadas. Uma cena com uma ideia clara comunicada de forma eficaz tem mais profundidade do que uma cena com dez camadas que não servem a mensagem.
7. Arquivos de skill
Dentro do diretório de skill, os seguintes arquivos compõem este workflow:
SKILL.md— este arquivoscripts/— scripts de suporte para gerenciamento de preferências (prefs.mjs), receitas (recipe.mjs) e pacotes de quadro (frame-packets.mjs)references/— referências para o menu de capacidade e conformidade../hyperframes-core/— skill de base para contratos de composição../hyperframes-creative/— skill criativa para tratamento de movimento e design../hyperframes-animation/— skill de animação para blueprints e transições/media-use— skill de gerenciamento de mídia para ativos, provedores e tratamentos
Não carregue ou modifique arquivos fora desses caminhos sem instrução explícita.
Esta skill é direcionada por BRIEF.md e pela camada de intenção /hyperframes. Atualizações podem ser obtidas executando npx hyperframes skills update general-video.