Communitygithub.com

sci-glow-video-skill

Fluxo de trabalho completo de produção de vídeos científicos em estilo neon line-art, 60fps com animações determinísticas, legendas sincronizadas com BGM, remix de áudio com ducking e capas 4K duplas, com controle de qualidade quantitativo e revisão cega por subagentes independentes, suportando produção em lote com perguntas de múltipla escolha.

O que é sci-glow-video-skill?

O 'Sci-Glow Video Skill' é um fluxo de trabalho completo e automatizado para a produção de vídeos animados de divulgação científica no estilo 'neon line-art' (traçado luminoso). Seu objetivo é transformar um tópico científico complexo em um pacote de entrega completo e de alta qualidade, incluindo roteiro narrado, verificação de fontes, legendas sincronizadas com o ritmo da música, vídeo mestre em 60fps com motion blur, capas 4K nos formatos paisagem e retrato, e textos de publicação para diferentes plataformas. O fluxo é orquestrado a partir de um prompt inicial do usuário e depende de habilidades upstream ('Lead-知识讲解动画' para renderização e 'Lead-自媒体口播文案' para roteiro) e scripts utilitários Python/Node.js. Uma característica fundamental do sistema é seu rigoroso controle de qualidade: ele impõe 'portões de qualidade' que forçam o retrabalho se os vídeos não passarem em verificações quantitativas de brilho e em uma revisão cega realizada por um subagente de IA isolado que avalia 9 dimensões, garantindo que nenhum defeito P0/P1 seja liberado. O fluxo de trabalho em 6 etapas guia desde a verificação do ambiente e análise do BGM até a renderização final e entrega, com regras claras para evitar erros comuns como codificação UTF-8 com BOM e configurações de bloom excessivamente altas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zy27488/sci-glow-video-skill/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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). De AzenYes/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. De AzenYes/leaderai-media-toolkit.
  • uv (uv run) : Executa o script CLI auxiliar scripts/sci_glow_cli.py que usa apenas a biblioteca padrão.
  • Skills de pesquisa científica opcionais (chamados prioritariamente se instalados no host): pubmed-database ou literature-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:

SubcomandoFunção PrincipalParâmetros Obrigatórios Chave
preflightVerifica 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-projectCria 口播文案输出/<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-bgmDecodifica 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-linesValida/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-qaChama 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

  1. 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.
  2. 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-自媒体口播文案)

  1. 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.
  2. Verifique pelo menos 2–3 artigos de periódicos de primeira linha (Nature / Science / NEJM / Cell), sendo estritamente proibido inventar dados.
  3. Gere o roteiro puro .txt e o plano de execução .md em 口播文案输出/<AAAAMMDD Tópico Científico>/.

Etapa 2: Alinhamento do Pico Espectral do BGM e Travamento da Duração Precisa das Legendas

  1. Execute analyze-bgm --bgm <caminho> --target-duration <T> --top-k 3 --output work/bgm.json para selecionar o melhor music_start_sec, e use o beats.py upstream para gerar work/beats.json.
  2. Escreva work/lines.json: Coloque o título T.at no Drop 1, a crise/virada at no Breakdown, o momento da descoberta at no Drop climático final, e deixe espaço no final para uma imagem de encerramento.
  3. 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, execute timeline.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.corner desabilitado, scenes.js envolto em IIFE, títulos de transição com mode: 'rise', blur: 0 e atraso de +0.36s.

  1. Execute scaffold-project para criar os diretórios duplos.
  2. 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).
  3. Escreva film/scenes.js, film/index.html e film/cover.html. Execute fonts.py film/ para subsetting e verify.mjs film/index.html --tol 24 upstream 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

  1. Escreva work/cues.json em UTF-8 sem BOM, execute sfx.py --variants 3 e mix.py (insira --music-start e --music-dips fornecidos pelo analyze-bgm, alinhando com -14.0 LUFS / -1.5 dBFS).
  2. Execute cover.mjs film/cover.html --out out --name <Tópico> --guides, veja a imagem em work/封面检查/, garantindo que as informações cruciais no formato paisagem estejam estritamente dentro da área central 4: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.

  1. 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 8 para um único vídeo, e limite estritamente a --workers 4 para múltiplos vídeos em paralelo).
  2. 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.
  3. Execute review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1, e derive um subagente de revisão cega research somente leitura (pode ler apenas out/review_r1/, é estritamente proibido ver o código fonte) para executar uma pontuação em 9 dimensões.
  4. 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

  1. 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.
  2. Execute audit-qa e qa_video.py --sheet --ref-sheet novamente, veja a planilha de contato do vídeo finalizado e exclua os rascunhos temporários out/draft*.mp4.
  3. De acordo com Lead-自媒体口播文案 e copy_template.md, complete work/文案与封面.md e 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-qa são todos executados localmente, sem requisições de rede externas.
  • Quando preflight --auto-fix-fonts baixa fontes .otf ausentes de uma CDN, ele possui um bloqueio de arquivo do SO entre processos + limitador de taxa time.monotonic() (1.0 req/s) , com retry de backoff exponencial de 3 tentativas para respostas 5xx, e lança RateLimitError e encerra a requisição ao encontrar HTTP 429.

Erros Comuns

  1. BOM UTF-8 do PowerShell causa falha no mix.py : PowerShell 5.1, ao usar Set-Content -Encoding UTF8, insere o cabeçalho EF BB BF por padrão. Todos os .json devem ser escritos pelo Python com encoding='utf-8', ferramentas cli ou [IO.File]::WriteAllText (sem BOM).
  2. Usar o padrão bloom: 0.9 e mode: 'center' causa imagem borrada : Para o assunto principal neon line-art, 0.9 de 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 para 0.20–0.28 conforme visual-and-layout-guardrails.md e usar rise (blur: 0).
  3. 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 isolado out/review_rN/.

Habilidades Relacionadas