Instalação em plugins: Antes dos comandos de configuração ou atualização, siga as regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Convenções do HyperFrames Studio
O Studio desenha uma linha da timeline por elemento de nível superior. Um projeto que segue as regras abaixo abre como uma linha do tempo curta e legível; um que não segue abre como uma parede de linhas sem rótulo que o usuário não pode editar. Estas são convenções para o que construir. Para saber como alterar um clipe, siga /hyperframes-core references/creator-editing-recipes.md e nunca invente uma forma diferente da mesma edição.
0. Fale antes de construir
Leia a mensagem antes de abrir um arquivo. Decida o que ela pede:
| A pessoa | Você |
|---|---|
| nomeia uma mudança, por mais educada que seja ("aumente o título", "pode cortar a terceira cena?") | Faça-a. |
| dá uma nota de sensação sobre o filme construído ("a introdução parece brusca", "não é longo o suficiente") | Encontre a causa, mude a coisa mensurável, diga o que a nota significava e o que mudou, e registre conforme /hyperframes-creative references/storyboard-recipe.md § 4. |
| faz uma pergunta e não nomeia nenhuma mudança ("por que o título pula?") | Responda-a. Não mude nada. |
| diz para não mudar nada, espere, "só pensando", "vamos conversar" | Não mude nenhum arquivo, nem mesmo uma correção que você notou. Ofereça-a em palavras. |
| traz uma ideia para este filme sem nenhuma mudança concreta ("quero que o final pareça maior") | Proponha a mudança e adicione-a ao plano (abaixo). Não mude nenhum arquivo de composição. |
| pede um novo filme | Planeje-o (§ 5). |
| aprova um plano ("construa", "vamos") | Construa o que foi aprovado. |
Uma mensagem que faz uma pergunta e nomeia uma mudança recebe a resposta e a mudança. Apenas quando você não consegue saber se ela pede algo é uma conversa: uma resposta errada custa uma mensagem; uma construção errada custa uma longa execução e uma rodada de notas.
Uma resposta de conversa:
- Responda primeiro, em palavras simples, em algumas frases.
- Faça apenas perguntas cuja resposta mude o filme, cada uma com uma resposta recomendada e sua compensação ("30 segundos cabem em um feed; 60 deixam espaço para a demonstração").
- Quando houver uma ideia para moldar: para um novo filme, direções conforme
/hyperframesreferences/pitch-round.md; para uma ideia sobre este filme, duas ou três opções para a parte nomeada. Recomende uma. - Termine com o próximo passo e a palavra que o inicia ("Diga construir e eu começarei").
Mantenha o plano no projeto, não apenas no chat: a próxima mensagem pode iniciar uma nova sessão que não pode ver esta. Adicione-o ao STORYBOARD.md da forma como /hyperframes-creative references/storyboard-recipe.md § 4 registra uma rodada; nunca sobrescreva quadros bloqueados. Se a pessoa pediu para não mudar nada, não escreva nada: coloque o plano na resposta e ofereça-se para salvá-lo.
1. Cada cena é uma sub-composição
A composição raiz contém apenas hosts temporizados, mídia e áudio. Qualquer cena com estrutura aninhada (uma div contendo filhos, um título com um subtítulo, um gráfico) é seu próprio arquivo carregado com data-composition-src, conectando em /hyperframes-core references/sub-compositions.md.
Marcação aninhada deixada dentro da raiz não se torna uma linha própria. Ela se esconde dentro de uma linha opaca que não pode ser cortada ou movida parte por parte.
Autor como se um lint de estrutura rejeitasse qualquer violação.
2. Uma faixa de legendas
- Todas as legendas vivem em uma faixa: um único host de sub-composição (um
data-track-index) marcado comdata-track-kind="captions"que carrega cada grupo de legendas em ordem. - Nunca uma linha por grupo de legendas, e nunca legendas misturadas em uma faixa com outro tipo.
- As regras de temporização de palavras não mudam: veja
/embedded-captionse as regras de lintcaption_*.
3. Um tipo de elemento por faixa
Agrupe por tipo para que cada linha seja uma coisa que o usuário possa selecionar, silenciar ou arrastar como um conjunto.
| Tipo | data-track-kind |
|---|---|
| Vídeo base / A-roll | video (da tag) |
| Cenas, sobreposições, gráficos | graphics |
| Legendas | captions |
| Áudio (narração, música, efeitos sonoros) | audio (da tag) |
Coloque data-track-kind em hosts de sub-composição. Os tipos de vídeo e áudio vêm da tag, então <video> e <audio> não precisam de atributo. Dê a cada tipo seu próprio data-track-index; o número é apenas para exibição; ele nunca muda o que é renderizado por cima. Use CSS para camadas.
4. Zonas seguras
Qualquer régua ou sobreposição de caixa segura vive no painel de pré-visualização, nunca dentro da composição, portanto não adicione elementos de guia ao HTML. Ambos os enquadramentos (wide e vertical) usam as mesmas duas caixas seguras, os padrões do Premiere. A alternância de pré-visualização as desenha com uma marca no ponto médio de cada borda. Fonte: ACTION_SAFE_PERCENT e TITLE_SAFE_PERCENT em packages/studio/src/utils/previewSafeMargins.ts.
| Caixa | Proporção do quadro | Recuo em cada borda |
|---|---|---|
| Ação segura | 90% | 5% |
| Título segura | 80% | 10% |
- Margens seguras: tudo visível fica dentro da caixa de ação segura (90%), e legendas e conteúdo-chave ficam dentro da caixa de título segura (80%).
- Layouts dois-em-um e 50/50 mantêm o conteúdo de cada metade dentro da caixa de título segura.
5. Um novo filme: plano, storyboard, construir
Os filmes hyperframes-launches foram feitos nesta ordem. Cada etapa tem um proprietário; siga-a e não a reafirme aqui.
| Etapa | Proprietário |
|---|---|
| 1. Brief | /hyperframes references/intent-interview.md. Dentro de um projeto existente, apenas uma continuação do mesmo filme permanece: uma nova versão ou um resumo, mesmo fluxo de trabalho e proporção. Faça suas perguntas obrigatórias, pule hyperframes init, nunca sobrescreva BRIEF.md ou STORYBOARD.md, adicione uma nova seção datada a cada um e diga isso na resposta. Um filme com um fluxo de trabalho ou proporção diferente inicia um novo projeto, e a resposta diz isso. |
| 2. Direções | /hyperframes references/pitch-round.md |
| 3. Storyboard | /hyperframes-creative references/storyboard-recipe.md |
| 4. Construir | O fluxo de trabalho para o qual o brief direciona (/hyperframes § 2) e suas próprias referências |
| 5. Notas | /hyperframes references/review-loop.md |
O que os filmes de lançamento adicionam, para um lançamento de produto. Onde o arco escolhido do fluxo de trabalho diz o contrário, o arco vence.
- Filmagem real para o produto lançado. Peça uma gravação de tela no brief, a menos que o fluxo de trabalho a capture por si só (um site a partir de sua URL), e segure seu espaço com um placeholder rotulado até que chegue. Nunca aproxime a IU do produto lançado. Uma ferramenta de terceiros mostrada como contexto (um app de chat, um editor) é reconstruída fielmente a partir de uma captura.
- Um mundo. A mesma janela ou tela continua através dos beats. Examine cada corte: o que quer que persista não deve pular.
- Cursores e conteúdo rolado. Um cursor, ou conteúdo que a própria janela rola para fora, sai pela borda da janela ou quadro, não desaparecendo no meio do quadro. Trocas de elemento e texto seguem o
cut-catalog.mddo fluxo de trabalho, onde ele tiver um. - Feche no comando ou no endereço, com o logotipo pousando em uma filmagem que ainda está se movendo.
- Informe o tempo de execução em cada versão. Ultrapassar o alvo é uma decisão da pessoa, não sua.
Verificando seu trabalho
Execute hyperframes check (ele executa lint) e corrija cada descoberta. Em seguida, abra o projeto no Studio e verifique se a linha do tempo mostra uma linha base, uma linha por host de cena, uma linha de legendas e as linhas de áudio.