Remotion 中文心理短片
Uso com Claude Code
Este skill é direcionado principalmente ao Claude Code. Após a instalação em um dos seguintes locais, ele estará disponível:
-
Skill pessoal:
~/.claude/skills/remotion-chinese-psychology-video/ -
Skill do projeto:
.claude/skills/remotion-chinese-psychology-video/ -
Pode ser invocado diretamente digitando
/remotion-chinese-psychology-video. -
Também pode ser acionado por meio de uma solicitação em linguagem natural para vídeos curtos de psicologia ou ideias em chinês, fazendo com que o Claude o carregue automaticamente com base na descrição.
-
Leia apenas os arquivos
references/correspondentes quando a tarefa exigir; não carregue todas as instruções de uma só vez. -
Siga as permissões de ferramentas e o diretório de sessão atuais do Claude Code; este skill não amplia permissões por conta própria.
Objetivo de Entrega
Transformar o roteiro em chinês fornecido pelo usuário em um projeto Remotion v4 executável, modificável e exportável, entregue em formato zip.
A menos que o usuário especifique o contrário, o projeto deve atender a:
- Node.js 18+, Remotion v4, TypeScript.
- 1920×1080, 30 fps.
- Fonte chinesa: NotoSerifSC (思源宋体).
npm install && npm run devdeve permitir a pré-visualização;npm run builddeve permitir a exportação.- O projeto deve incluir
tools/make_audio.py, que usa Python + NumPy para sintetizar efeitos sonoros principais com base nos tempos do roteiro, gerandopublic/soundtrack.wav. - O projeto deve incluir um README explicando a estrutura do projeto, como modificar o roteiro e como regenerar o áudio.
- Não deve incluir narração ou música de fundo; apenas efeitos sonoros sincronizados com precisão com os eventos visuais.
- O zip não deve conter
node_modules, cache de pré-visualização ou outros arquivos temporários.
Considere o roteiro já confirmado pelo usuário, a atribuição de autoria, a direção visual e outras escolhas explícitas como conteúdo fixo. Altere apenas quando o usuário solicitar explicitamente. Cues não alterados devem manter o design visual original, adereços, paleta de cores e animações locais.
Bloqueio de Requisitos
Antes de iniciar a produção, verifique de forma independente:
- Se o roteiro inclui gancho, pergunta, nome do tema e parágrafo explicativo.
- Se o autor, duração fixa,
dur/pausepor frase, paleta de cores ou cenas específicas foram fornecidos. - Se o usuário solicitou exportação direta sem verificação quadro a quadro. Se sim, ainda assim conclua as verificações de tipo e integridade do projeto.
- Se a modificação do roteiro altera o ponto de partida absoluto de cues inalterados. Se alterar, mantenha seu visual e animações locais, mas recalcule a linha do tempo global e os efeitos sonoros.
- Se existem restrições conflitantes que não podem ser satisfeitas simultaneamente. Identifique o conflito primeiro e adote a interpretação executável mais razoável; não viole silenciosamente o conteúdo já confirmado.
Por padrão, não adicione narração, música de fundo, marcas d'água na tela, logotipos, autor (a menos que fornecido no roteiro ou pelo usuário) ou enredo não solicitado.
Estabelecer Linha do Tempo de Cues
Leia references/cue-timing.md primeiro e, em seguida, crie a única fonte de dados da linha do tempo.
-
Cada frase que pode ser um plano independente corresponde a um
cueIdestável. -
Determine os limites da cena primeiro e, em seguida, calcule a duração; não deixe que os componentes React estimem o ponto de partida.
-
Para cues normais, os segundos são calculados usando os parâmetros do usuário:
seconds = max(minDuration, baseHold + visibleCharacterCount / charsPerSecond + pause) -
pauseé uma pausa adicional opcional;duré um valor de substituição fixo em segundos; se presente, ignora a fórmula epause. -
Converta a duração em quadros inteiros em 30 fps e faça com que o início do próximo cue seja igual ao quadro final do cue anterior.
-
A duração total é a soma de todos os quadros dos cues; se for necessário um atraso no final, defina
tailFramesseparadamente. -
Coloque parâmetros, cues, cenas e eventos sonoros em alguns arquivos de configuração auditáveis. O README deve informar ao usuário onde modificar.
O número de caracteres chineses visíveis, se a pontuação conta, a espera base, o número de caracteres por segundo e a duração mínima devem ser configurados explicitamente no projeto, não espalhados nos componentes de cena. Se o usuário não fornecer parâmetros, use um conjunto razoável de valores padrão e documente no README.
Direção Primeiro, Codificação Depois
Crie o eixo visual principal e o storyboard para o vídeo atual. Leia references/creative-direction.md primeiro e, em seguida, tome as seguintes decisões antes de escrever os componentes:
- Estilo do boneco de palito: formato, espessura de linha, proporções, articulações e cor de identificação consistentes em todo o vídeo.
- Sistema de materiais, iluminação, espaço e cores relacionado ao tema.
- Adereços, ações e metáforas visuais independentes para cada cue.
- Trajetória de câmera contínua no primeiro ato, ação de revelação do tema e mecanismo de revelação do título.
- Quais palavras-chave da legenda precisam de destaque, quais números ou elementos de interface precisam de desvio independente.
Cada abertura de vídeo deve ser redesenhada. Não reutilize trajetórias de câmera, composições ou efeitos de título de vídeos anteriores. Cada cena também deve ter seus próprios adereços e eventos, sem degenerar para um boneco de palito parado ao lado da legenda.
Requisitos Rigorosos do Primeiro Ato
O primeiro ato consiste no gancho, preparação e revelação do título do tema, com duração alvo de 10 a 20 segundos.
- Tente usar uma única tomada contínua; use movimento de câmera contínuo em 2D, 2.5D ou 3D.
- Não use uma apresentação de slides PPT horizontal e simplista.
- O gancho deve primeiro apresentar um problema, perda, contradição ou anomalia visual, e então nomear o tema.
- A entrada do título deve ser projetada de forma única e "encenar" o significado do tema; não use apenas um simples push/pull, fade in letra por letra ou zoom.
- Se houver autor, coloque uma linha pequena e clara de atribuição abaixo do título; a linha pequena ainda não deve ficar abaixo do limite de legibilidade da tela.
- Se o gancho for uma cue do próprio roteiro, garanta que a performance esteja sincronizada com a primeira frase da legenda; não termine a performance antes que a legenda apareça.
Implementação do Projeto Remotion
Use configuração centralizada para conduzir a Composition:
- Em
calculateMetadataou local equivalente, calculedurationInFramesda composition a partir dos dados dos cues. - Use
Sequenceunificado ou mapeamento de quadros absoluto para evitar desvios de múltiplos temporizadores independentes. - Aguarde o carregamento de
NotoSerifSCcomdelayRender/continueRenderou um fluxo confiável de carregamento de fontes; não deixe que o primeiro quadro mostre uma fonte substituta. - Crie um mapeamento claro de componentes para cada cue. Os componentes recebem apenas seu próprio cue e parâmetros locais.
- Animações locais usam quadros relativos dentro do cue; eventos sonoros globais são registrados com cue ID + segundos dentro do cue e depois mapeados para quadros absolutos.
- Para movimento de câmera, use âncoras estáveis e transformações reversíveis; quando a interface precisa estar nítida, o movimento da câmera deve parar em uma postura legível.
- Mantenha nomes de componentes e limites de configuração sustentáveis; proíba empilhar todos os planos em um único arquivo enorme.
Limite Rigoroso de Legibilidade
- O texto do corpo da tela não deve ser menor que 44 px; palavras-chave geralmente têm 60–200 px.
- As legendas devem ter cerca de 66–68 px e usar um fundo sólido, como um gradiente escuro ou um fundo de papel creme, para melhorar o contraste.
- Texto claro com contorno escuro; texto escuro em um fundo suficientemente claro.
- Não use texto "fantasma" semitransparente como informação legível.
- Mantenha uma margem de segurança nas quatro bordas da tela; reserve cerca de 200 px na parte inferior para legendas. Adereços principais, números, botões e títulos não devem ser obstruídos por legendas, máscaras, pálpebras, partículas ou cortes de câmera.
- Ao ampliar a tela de um telefone, editor, interface chave ou números importantes, garanta que a informação esteja completamente visível.
- Se o texto da interface principal permanecer pequeno após o zoom, coloque os números ou conclusões principais em caracteres grandes independentes em ambos os lados, mas sem fingir que fazem parte da interface principal.
- Verifique bordas de texto, contorno, contraste, obstrução e tamanho mínimo de fonte em quadros representativos; não confie apenas no código para julgar que "deve estar claro".
Áudio
Leia references/audio-synthesis.md primeiro e, em seguida, escreva tools/make_audio.py.
- Crie uma tabela de eventos, vinculando cliques, deslizes, batimentos cardíacos, estilhaços, bolhas, tesouras, passos, etc., ao cue ID e ao tempo dentro do cue.
- Os efeitos sonoros devem compartilhar a mesma fonte de eventos ou o mesmo mapeamento de tempo que os eventos visuais; não mantenha dois conjuntos de tempos aproximados.
- No ponto de revelação do tema, efeitos sonoros rítmicos muito curtos são permitidos, mas não devem formar música de fundo contínua.
- Use NumPy e a biblioteca padrão Python para gerar PCM WAV determinístico. Padrão: 48 kHz, 16-bit, mono ou estéreo.
- A reexecução do script deve sobrescrever
public/soundtrack.wav, e o resultado deve ser consistente com a tabela de eventos. - O README deve documentar dependências, comandos, tabela de eventos e caminho de saída.
Modificação do Roteiro
Quando o usuário fornecer um novo roteiro, combine-o de acordo com as seguintes regras:
- O roteiro antigo é completamente substituído pelo novo.
- Use cue IDs estáveis e texto normalizado para determinar quais cues de texto não foram alterados.
- Cues inalterados mantêm o componente de cena original, design visual, adereços, paleta de cores e animações locais.
- Cues novos ou com texto modificado exigem redesign do plano e legenda correspondentes; se a mudança estrutural quebrar o eixo temático, permita redirecionar o segmento contínuo afetado.
- Recalcule a duração de cada cue, o ponto de partida global e o número total de quadros da composition.
- Devido à mudança na duração do cue anterior, o ponto de partida absoluto de cues inalterados pode mudar; isso não equivale a alterar seu conteúdo visual. Todas as
Sequencesubsequentes, eventos sonoros e quadros-chave de câmera devem ser sincronizados e transladados. - Regere o WAV e verifique se todos os efeitos sonoros ainda estão alinhados com os pontos de evento locais.
- Não altere o autor, fonte, resolução, sistema visual ou cenas não afetadas como consequência de uma única modificação de roteiro.
Se o usuário solicitar "nenhuma alteração em outras imagens" e a duração do roteiro mudar, explique que não é possível manter a posição temporal absoluta inalterada; priorize manter o conteúdo visual inalterado e recalcule a linha do tempo.
Verificação e Empacotamento
Após concluir o projeto, execute scripts/audit_project.py para uma verificação estática de entrega e, em seguida, execute a verificação de tipo do próprio projeto. Quando o usuário solicitar verificação normal, renderize quadros representativos e inspecione manualmente:
- O quadro de revelação do tema no primeiro ato, o quadro do título e a linha do autor.
- O meio de cada cue e o estado antes do final.
- A legenda mais longa, o maior zoom da câmera e a interface mais complexa.
- Visibilidade completa da tela do telefone, números principais, linhas e palavras-chave.
- Verifique pelo menos o mapeamento de quadros entre a tabela de eventos sonoros e os cues correspondentes; se o ambiente permitir reprodução, ouça eventos importantes; caso contrário, indique explicitamente.
Quando o usuário disser "exportar diretamente o pacote zip, sem verificação", não faça pré-visualização quadro a quadro, mas conclua a verificação de tipo e a verificabilidade do empacotamento.
Use references/delivery-checklist.md para a verificação final. O diretório raiz do zip deve conter diretamente os arquivos do projeto executável, evitando um nível adicional de diretório sem significado; o README deve estar no diretório raiz do projeto.
Na resposta de entrega, forneça uma descrição breve:
- O que foi feito.
- O design independente do primeiro ato e do título.
- As cenas subsequentes.
- Os eventos sonoros e o método de geração.
- Quais partes foram verificadas e quais não foram.