Communitygithub.com

Sci-Glow Video Skill (发光线描科普视频全流程制片)

Flujo de trabajo integral para producir videos educativos de ciencia con estilo glow-line: animación determinista a 60fps, subtítulos sincronizados con la voz, edición de audio con drops de BGM para generar clímax, portadas 4K en formato horizontal y vertical, y un riguroso sistema de control de calidad con revisión ciega por sub-agentes independientes.

¿Qué es Sci-Glow Video Skill (发光线描科普视频全流程制片)?

Este Skill orquesta la producción completa de videos educativos de ciencia en el estilo de líneas brillantes (glow-line), transformando un concepto científico desde una simple frase hasta un conjunto de entregables listos para publicar en plataformas como YouTube, Bilibili o TikTok. Está diseñado para trabajar con los Skills base 'Lead-自媒体口播文案' y 'Lead-知识讲解动画', tomando sus outputs y añadiendo capas de control de calidad, edición de audio avanzada y sub-agentes de revisión ciega. El flujo se divide en etapas: desde la comprobación del entorno, la redacción de guiones con verificación de fuentes (vía PubMed, OpenAlex o búsqueda web), el alineamiento de clips de BGM con picos de frecuencia (Drop, Breakdown, Drop final) para maximizar el impacto narrativo, hasta el diseño visual con parámetros calibrados (bloom 0.20-0.28) y la generación de portadas 4K. Su valor diferencial radica en su motor de calidad: un pipeline de 'fabricación con puertas', que incluye verificación de brillo, detección de anomalías, y un proceso de revisión ciega ejecutado por un sub-agente independiente (sin acceso al código fuente) que puntúa el borrador en 9 dimensiones. Solo cuando se alcanza una puntuación mínima de 8.5 y no existen defectos P0/P1, se procede al renderizado final a 60fps con desenfoque de movimiento y mezcla de audio a -14.0 LUFS. Además, soporta la producción en paralelo de múltiples videos, el diseño de tres picos emocionales en cada video, y el auto-revisión de parámetros en caso de fallo de calidad, garantizando un alto estándar de publicación sin necesidad de supervisión humana.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Sci-Glow Video Skill (发光线描科普视频全流程制片)?

Visión General

Transforma de manera estable un concepto científico desde "una frase" hasta un conjunto completo de entregables listos para publicar: un guion de voz (solo texto), una tabla de verificación de fuentes, un script de subtítulos con sincronización precisa de beats, un máster MP4 a 60fps con desenfoque de movimiento, portadas 4K horizontales y verticales ajustadas al área segura, y textos promocionales para diferentes plataformas.

Filosofía central: Puerta de calidad automática con rehacer (brillo cuantificado + verificación de cero BOM + revisión ciega por sub-agente independiente ≥ 8.5), bajo ningún concepto se renderiza el máster si existen defectos P0/P1 o sobreexposición que cause una pantalla gris.

Dependencias

Este Skill orquesta y potencia las capacidades de niveles inferiores, sin reimplementar sus motores base:

  • Lead-知识讲解动画 (lead-knowledge-animation): Proporciona el runtime Canvas/DOM determinista (motion.js, kit.js) y el andamiaje de bajo nivel (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): Proporciona la sintaxis de gancho de inicio en frío, las estructuras de analogías cotidianas y las guías de redacción para publicaciones en B站/Douyin/视频号/小红书/YouTube. De AzenYes/leaderai-media-toolkit.
  • uv (uv run): Ejecuta el script CLI auxiliar de biblioteca estándar scripts/sci_glow_cli.py.
  • Habilidades de búsqueda científica (opcional): Si el host las tiene instaladas (pubmed-database o literature-search-openalex), se priorizan para verificar artículos y valores reales; si no, se usa la búsqueda web para confirmar fuentes primarias.

Inicio Rápido

# 1. Verificar entorno y 8 pesos de IBM Plex Sans SC (si faltan, descargar con limitación de velocidad)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json

# 2. Analizar el espectro de clímax de un MP3 de usuario, mostrar top-3 puntos de inicio y parámetros de pre-dipping
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 el proyecto con dos directorios y parámetros seguros por defecto (incluye 3:4 1080x1440 y bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<ruta raíz del proyecto>" --date 20261118 --topic optogenética --ratio 3x4 --output work/scaffold.json

Scripts Utilitarios

Todos los cálculos auxiliares se proporcionan a través de scripts/sci_glow_cli.py, escribiendo uniformemente con --output un JSON UTF-8 sin BOM. Prohibido volcar grandes bloques de logs brutos a la terminal:

SubcomandoFunción PrincipalParámetros Obligatorios Clave
preflightVerificar Node 18+, FFmpeg, Chrome, Playwright (sugerir npmmirror + evitar descargar navegador duplicado), los dos skills superiores y los 8 pesos de IBM Plex; con --auto-fix-fonts descargar automáticamente los .otf faltantes--output
scaffold-projectCrear 口播文案输出/<fecha tema科普>/ y .code/<fecha tema科普动画>/, ejecutar new_film.mjs y parchear para habilitar tamaño 3:4 y bloom: 0.26--workspace, --date, --topic, --ratio, --output
analyze-bgmDecodificar forma de onda mono a 8kHz con FFmpeg, extraer RMS de banda completa + envolvente de baja frecuencia <180Hz, buscar Drop 1 (tarjeta de título) → Breakdown → Drop final de clímax, generar Top-K de --music-start y --music-dips--bgm, --target-duration, --top-k, --output
validate-linesValidar/eliminar BOM UTF-8, verificar conteo de caracteres en ancho de 1080px (gancho <=12, subtítulo <=15), paréntesis balanceados, sin puntuación final, límite de 5s para ganchos, recalcular y fijar duración total tail--lines, --target-duration, --ratio, --output (opcional --fix-bom, --apply-tail)
audit-qaLlamar al skill superior qa_video.py y según las huellas de oro (mean 17-20, p99 >= 130, bright <= 3.5%, cero zonas muertas, cero frames parpadeantes) dar semáforo verde/rojo y receta de ajuste, además generar prompt de revisión ciega independiente--video, --film-dir, --round, --output

Flujo de Trabajo

Cuando se encuentren demandas de producción en paralelo (múltiple opción) o división de trabajo entre dos modelos, cargar al mismo tiempo multi-agent-batch-playbook.md; los parámetros de imagen y maquetación deben cumplir estrictamente visual-and-layout-guardrails.md.

Paso 0: Verificación de entorno y confirmación de música antes de empezar

  1. Ejecutar preflight --auto-fix-fonts --output ...; si falta Playwright, guiar para ejecutar: $env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com.
  2. Puerta de música: si el usuario especificó una canción, usar solo esa; si no especificó y no hay canción local correspondiente, preguntar activamente al usuario por la ruta del archivo o cambiar a solo efectos de sonido (no saltarse sin consultar).

Paso 1: Redacción de guion sin barreras y verificación de fuentes primarias (reutilizar Lead-自媒体口播文案)

  1. Los primeros 3 segundos deben captar la atención con un número concreto o un hecho contraintuitivo; luego dar una analogía cotidiana concreta antes de introducir términos científicos.
  2. Verificar al menos 2-3 fuentes de revistas primarias (Nature / Science / NEJM / Cell), prohibido inventar datos.
  3. Generar guion de texto plano .txt y plan de ejecución .md en 口播文案输出/<YYYYMMDD tema科普>/.

Paso 2: Alineación de clímax espectral de BGM y fijación de duración de subtítulos

  1. Ejecutar analyze-bgm --bgm <ruta> --target-duration <T> --top-k 3 --output work/bgm.json para seleccionar el mejor music_start_sec, y usar el skill superior beats.py para generar work/beats.json.
  2. Escribir work/lines.json: colocar el título T.at en Drop 1, el momento de giro/crisis at en Breakdown, el instante de avance at en Drop final de clímax, y dejar espacio al final para una imagen de cierre.
  3. Ejecutar validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json; solo cuando todo esté verde, ejecutar el skill superior timeline.py --beats work/beats.json --music-start <start> --film film/.

Paso 3: Diseño del sistema visual e implementación de código determinista (reutilizar Lead-知识讲解动画)

[!IMPORTANT] Los parámetros de codificación y diseño visual deben cumplir visual-and-layout-guardrails.md: bloom: 0.20–0.28, K.fog: 0.024–0.028, K.hud.corner deshabilitado, scenes.js envuelto en IIFE, títulos de transición con mode: 'rise', blur: 0 y retraso +0.36s.

  1. Ejecutar primero scaffold-project para crear los dos directorios.
  2. Diseñar una paleta de colores principal que no entre en conflicto, en film/core.js escribir 3-5 capas de primitivas de brillo fino para la metáfora científica específica del video (prohibido reutilizar tarjetas generales de cuadros o figuras de palo en caja repetitivas).
  3. Escribir film/scenes.js, film/index.html y film/cover.html, ejecutar el skill superior fonts.py film/ para subconjunto de fuentes y verify.mjs film/index.html --tol 24 para verificación de cero puntos con diferencia máxima 24.

Paso 4: Mezcla con dipping y verificación del área segura de portadas 4K duales

  1. Escribir work/cues.json en UTF-8 sin BOM, ejecutar sfx.py --variants 3 y mix.py (rellenar --music-start y --music-dips dados por analyze-bgm, nivelar a -14.0 LUFS / -1.5 dBFS).
  2. Ejecutar cover.mjs film/cover.html --out out --name <tema> --guides, ver visualmente las imágenes en work/封面检查/, asegurando que la información clave de la portada horizontal caiga estrictamente dentro del 4:3 central (x ∈ [240, 1680]).

Paso 5: Revisión cuantitativa de borrador a 30fps + bucle de revisión ciega por sub-agente independiente

Ver blind-review-protocol.md.

  1. Renderizar primero el borrador a mitad de resolución: render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4 (para un solo video usar --workers 8, para múltiples videos concurrentes controlar estrictamente --workers 4).
  2. Ejecutar audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json. Si el brillo o las zonas muertas no cumplen, modificar parámetros según la receta y re-renderizar el borrador directamente.
  3. Ejecutar review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1, derivar un sub-agente de revisión ciega de solo lectura research (solo puede leer out/review_r1/, prohibido ver el código fuente) que ejecute una puntuación en 9 dimensiones.
  4. Si existe cualquier P0/P1 o puntuación media < 8.5, prohibido renderizar el máster a 60fps, modificar uno por uno, autoverificar, y volver a revisar hasta que todo esté verde.

Paso 6: Renderizado directo del máster a 60fps con desenfoque de movimiento y entrega completa

  1. Una vez que la revisión ciega esté completamente verde, renderizar la versión final solo una vez: render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<tema>.mp4.
  2. Ejecutar de nuevo audit-qa y qa_video.py --sheet --ref-sheet, verificar visualmente la hoja de contacto de la pieza terminada y eliminar los borradores temporales out/draft*.mp4.
  3. Según Lead-自媒体口播文案 y copy_template.md, completar work/文案与封面.md, entregar al usuario el conjunto completo de archivos y una lista de momentos de re-grabación de audio que requieran escucha humana.

Limitación de Velocidad

  • analyze-bgm, validate-lines, scaffold-project, audit-qa se ejecutan todos localmente, sin solicitudes de red externa.
  • preflight --auto-fix-fonts al descargar fuentes .otf faltantes desde un CDN, tiene implementado un bloqueo de archivo OS entre procesos + limitador de velocidad time.monotonic() (1.0 req/s), con 3 reintentos con retroceso exponencial ante 5xx, y lanza excepción RateLimitError ante HTTP 429, terminando la solicitud.

Errores Comunes

  1. BOM UTF-8 de PowerShell que causa fallo en mix.py: PowerShell 5.1 con Set-Content -Encoding UTF8 escribe un encabezado EF BB BF. Todos los .json deben escribirse con encoding='utf-8' de Python, herramientas cli o [IO.File]::WriteAllText (sin BOM).
  2. Usar por defecto bloom: 0.9 y mode: 'center' causa imagen borrosa: Un sujeto de líneas brillantes con 0.9 de bloom causará inevitablemente bright > 3.5%, y el título center con desenfoque fijo de 14px arruinará las transiciones de barrido de luz. Se debe reducir a 0.20–0.28 según visual-and-layout-guardrails.md y usar rise (blur: 0).
  3. Sobrecarga de Workers de Chromium y "autoevaluación" en producción concurrente: Con 3-4 videos en paralelo, se debe limitar --workers 4; además, nunca permitir que el mismo contexto que escribe el código se autoevalúe y apruebe; la firma debe pasar por el sub-agente de revisión ciega de solo lectura en el directorio aislado out/review_rN/.

Skills relacionados