Sci-Glow Video Skill (Produção Completa de Vídeos Científicos Neon Line-Art)
Visão Geral
Transforma um tópico científico complexo a partir de "um conceito em uma frase" em um pacote de entrega completo e pronto para publicação de uma animação científica neon line-art de 60 segundos (ou duração especificada): roteiro narrado, tabela de verificação de fontes, legendas sincronizadas com precisão, vídeo mestre em 60fps com motion blur, capas 4K nos formatos paisagem e retrato com área segura, e textos de publicação otimizados por plataforma.
Filosofia central: Portões de qualidade rígidos com retrabalho automático (brilho quantificado + verificação BOM zero + revisão cega por subagente independente e somente leitura com pontuação ≥ 8.5), nunca renderizando o mestre quando defeitos P0/P1 ou superexposição/tela cinza estiverem presentes.
Dependências
Este Skill orquestra e aprimora as habilidades upstream abaixo, não reimplementando seus mecanismos subjacentes:
Lead-知识讲解动画(lead-knowledge-animation) : Fornece o runtime Canvas/DOM determinístico (motion.js,kit.js) e o scaffolding base (new_film.mjs,beats.py,timeline.py,fonts.py,sfx.py,mix.py,render.mjs,cover.mjs,verify.mjs,qa_video.py,review_pack.py). DeAzenYes/leaderai-media-toolkit.Lead-自媒体口播文案(lead-media-script) : Fornece a sintaxe de gancho de abertura fria, estrutura de analogia do cotidiano e templates de publicação para plataformas como Bilibili, Douyin, Kuaishou, Xiaohongshu e YouTube. DeAzenYes/leaderai-media-toolkit.uv(uv run) : Executa o script CLI auxiliarscripts/sci_glow_cli.pyque usa apenas a biblioteca padrão.- Skills de pesquisa científica opcionais (chamados prioritariamente se instalados no host):
pubmed-databaseouliterature-search-openalex, para verificar artigos de periódicos e valores reais; se não instalados, usa busca na internet para verificar fontes primárias.
Início Rápido
# 1. Verificação de ambiente e fonte IBM Plex Sans SC com 8 pesos (baixa automaticamente com limite de taxa se ausente)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json
# 2. Análise espectral de pico para qualquer MP3 do usuário, gerando Top-3 pontos de corte e parâmetros de ducking
uv run <skill_dir>/scripts/sci_glow_cli.py analyze-bgm --bgm "<BGM.mp3>" --target-duration 60 --top-k 3 --output work/bgm_analysis.json
# 3. Inicializar diretórios duplos do projeto e escrever parâmetros de segurança padrão (incluindo proporção 3:4 1080x1440 e bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<Diretório Raiz do Projeto>" --date 20261118 --topic Optogenética --ratio 3x4 --output work/scaffold.json
Scripts Utilitários
Todos os cálculos auxiliares são fornecidos via scripts/sci_glow_cli.py, que escreve JSON UTF-8 sem BOM usando --output, sendo proibido emitir logs brutos extensos no terminal:
| Subcomando | Função Principal | Parâmetros Obrigatórios Chave |
|---|---|---|
preflight | Verifica Node 18+, FFmpeg, Chrome, Playwright (dica: npmmirror + pular download duplicado do navegador), as duas skills upstream e os 8 pesos da fonte IBM Plex; com --auto-fix-fonts baixa .otf ausentes automaticamente | --output |
scaffold-project | Cria 口播文案输出/<Data Tópico Científico>/ e .code/<Data Tópico Científico Animação>/, executa new_film.mjs e aplica patch para habilitar tamanho 3:4 e bloom: 0.26 | --workspace, --date, --topic, --ratio, --output |
analyze-bgm | Decodifica forma de onda mono de 8kHz com FFmpeg, extrai RMS de banda larga + envelope de baixa frequência <180Hz, procura por Drop 1 (título) → Breakdown → Drop climático final, gera Top-K --music-start e --music-dips | --bgm, --target-duration, --top-k, --output |
validate-lines | Valida/remove BOM UTF-8, verifica contagem de caracteres na largura 1080px (gancho <=12 chars, legenda <=15 chars), parênteses balanceados, sem pontuação final, limite de gancho 5s, recalcula e trava duração total tail | --lines, --target-duration, --ratio, --output (opcional --fix-bom, --apply-tail) |
audit-qa | Chama qa_video.py upstream e, com base na impressão digital dourada (mean 17-20, p99 >= 130, bright <= 3.5%, zero dead zone, zero frames piscando), gera semáforo vermelho/verde e prescrição de ajuste de parâmetros, além de gerar prompt de revisão cega independente | --video, --film-dir, --round, --output |
Fluxo de Trabalho
Ao encontrar demandas de produção em lote com múltiplas escolhas ou divisão de trabalho entre dois modelos, carregue também o multi-agent-batch-playbook.md; os parâmetros de cena e layout devem seguir rigorosamente o visual-and-layout-guardrails.md.
Etapa 0: Verificação do Ambiente e Confirmação da Música Antes de Começar
- Execute
preflight --auto-fix-fonts --output ...; se faltar Playwright, oriente a executar:$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com. - Portão da Música: Se o usuário especificou uma música, use somente a do usuário; se não especificou e não há música fornecida no sistema, pergunte ativamente ao usuário pelo caminho do arquivo de música ou se deseja usar apenas efeitos sonoros (não pule sem permissão).
Etapa 1: Escrita de Roteiro Acessível e Verificação de Fontes Primárias (Reutilizando Lead-自媒体口播文案)
- Os primeiros 3 segundos devem usar um fato específico/contraintuitivo para prender a atenção, depois fornecer uma analogia concreta do dia a dia antes de introduzir termos científicos.
- Verifique pelo menos 2–3 artigos de periódicos de primeira linha (
Nature/Science/NEJM/Cell), sendo estritamente proibido inventar dados. - Gere o roteiro puro
.txte o plano de execução.mdem口播文案输出/<AAAAMMDD Tópico Científico>/.
Etapa 2: Alinhamento do Pico Espectral do BGM e Travamento da Duração Precisa das Legendas
- Execute
analyze-bgm --bgm <caminho> --target-duration <T> --top-k 3 --output work/bgm.jsonpara selecionar o melhormusic_start_sec, e use obeats.pyupstream para gerarwork/beats.json. - Escreva
work/lines.json: Coloque o títuloT.atno Drop 1, a crise/viradaatno Breakdown, o momento da descobertaatno Drop climático final, e deixe espaço no final para uma imagem de encerramento. - Execute
validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json. Após tudo verde, executetimeline.py --beats work/beats.json --music-start <start> --film film/upstream.
Etapa 3: Design do Sistema Visual e Implementação de Código Determinística (Reutilizando Lead-知识讲解动画)
[!IMPORTANT] Os parâmetros de codificação e visuais devem obedecer ao visual-and-layout-guardrails.md:
bloom: 0.20–0.28,K.fog: 0.024–0.028,K.hud.cornerdesabilitado,scenes.jsenvolto em IIFE, títulos de transição commode: 'rise', blur: 0e atraso de+0.36s.
- Execute
scaffold-projectpara criar os diretórios duplos. - Projete uma paleta de cores principal sem conflito e escreva manualmente 3–5 primitivas de brilho refinadas para a metáfora científica específica deste vídeo em
film/core.js(é proibido reutilizar cartões de caixa genéricos ou palitos de fósforo). - Escreva
film/scenes.js,film/index.htmlefilm/cover.html. Executefonts.py film/para subsetting everify.mjs film/index.html --tol 24upstream para verificação de zero diferenças em todos os pontos.
Etapa 4: Remix com Ducking e Verificação da Área Segura das Capas 4K Duplas
- Escreva
work/cues.jsonem UTF-8 sem BOM, executesfx.py --variants 3emix.py(insira--music-starte--music-dipsfornecidos peloanalyze-bgm, alinhando com-14.0 LUFS / -1.5 dBFS). - Execute
cover.mjs film/cover.html --out out --name <Tópico> --guides, veja a imagem emwork/封面检查/, garantindo que as informações cruciais no formato paisagem estejam estritamente dentro da área central4:3(x ∈ [240, 1680]).
Etapa 5: Inspeção de Qualidade Quantitativa do Rascunho em 30fps + Ciclo de Revisão Cega por Subagente Independente Somente Leitura
Consulte blind-review-protocol.md para detalhes.
- Renderize primeiro o rascunho em meia resolução:
render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4(use--workers 8para um único vídeo, e limite estritamente a--workers 4para múltiplos vídeos em paralelo). - Execute
audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json. Se o brilho ou a zona morta não atenderem aos critérios, ajuste os parâmetros diretamente conforme a prescrição e gere um novo rascunho. - Execute
review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1, e derive um subagente de revisão cegaresearchsomente leitura (pode ler apenasout/review_r1/, é estritamente proibido ver o código fonte) para executar uma pontuação em 9 dimensões. - Se houver qualquer P0/P1 ou média
< 8.5, é estritamente proibido renderizar o mestre em 60fps. Modifique item por item, auto-verifique e reavalie até que tudo esteja verde.
Etapa 6: Renderização Direta do Mestre em 60fps com Motion Blur e Entrega Completa
- Após a revisão cega estar totalmente verde, renderize a versão final apenas uma vez:
render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<Tópico>.mp4. - Execute
audit-qaeqa_video.py --sheet --ref-sheetnovamente, veja a planilha de contato do vídeo finalizado e exclua os rascunhos temporáriosout/draft*.mp4. - De acordo com
Lead-自媒体口播文案ecopy_template.md, completework/文案与封面.mde entregue ao usuário o pacote completo de arquivos e uma lista dos momentos de áudio que precisam de audição humana para possível regravação.
Limitação de Taxa
analyze-bgm,validate-lines,scaffold-project,audit-qasão todos executados localmente, sem requisições de rede externas.- Quando
preflight --auto-fix-fontsbaixa fontes.otfausentes de uma CDN, ele possui um bloqueio de arquivo do SO entre processos + limitador de taxatime.monotonic()(1.0 req/s) , com retry de backoff exponencial de 3 tentativas para respostas 5xx, e lançaRateLimitErrore encerra a requisição ao encontrar HTTP 429.
Erros Comuns
- BOM UTF-8 do PowerShell causa falha no
mix.py: PowerShell 5.1, ao usarSet-Content -Encoding UTF8, insere o cabeçalhoEF BB BFpor padrão. Todos os.jsondevem ser escritos pelo Python comencoding='utf-8', ferramentascliou[IO.File]::WriteAllText(sem BOM). - Usar o padrão
bloom: 0.9emode: 'center'causa imagem borrada : Para o assunto principal neon line-art,0.9de bloom certamente causarábright > 3.5%; o título centralizado com blur fixo de 14px certamente arruinará as transições de varredura de luz. É obrigatório reduzir para0.20–0.28conforme visual-and-layout-guardrails.md e usarrise(blur: 0). - Sobrecarga de Workers do Chromium e "revisar a si mesmo" ao processar múltiplos vídeos em paralelo : Ao processar 3–4 vídeos em paralelo, é obrigatório limitar a taxa com
--workers 4; ao mesmo tempo, é estritamente proibido que o mesmo contexto que escreve o código aprove sua própria saída. A aprovação deve vir exclusivamente do subagente de revisão cega somente leitura que opera no diretório isoladoout/review_rN/.