Communitygithub.com

drama-audio-soundstage

Cuarta etapa de la línea de producción industrializada de series cortas: ingeniería de sonido y composición musical con evitación inteligente. Se encarga del refinamiento de audio posterior a la generación de video H3.

¿Qué es drama-audio-soundstage?

Drama Audio Soundstage es una habilidad especializada para la postproducción de audio en series cortas (short dramas), diseñada para entornos como Claude Code, Cursor o Codex. Su propósito es limpiar y optimizar el audio generado por IA (H3) eliminando ruidos de fondo persistentes (zumbidos, viento) mediante un algoritmo de puerta de audio basado en resta espectral (spectral subtraction audio gating). Además, integra un sistema de detección de idioma con Whisper ASR para interceptar automáticamente desviaciones del mandarín estándar, evitando que fragmentos con pronunciación errónea o ruido se filtren al producto final. La característica más destacada es la mezcla con ducking de cadena lateral (sidechain ducking) usando FFmpeg, que reduce el volumen de la música de fondo en -14 dB instantáneamente cuando un personaje habla y lo recupera suavemente al callar, logrando un acabado cinematográfico profesional. La habilidad procesa segmentos de video, aplica parámetros físicos precisos (umbral, ratio, ataque, release) y produce un archivo final sincronizado con la banda sonora y un informe de calidad de ASR.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abserari/drama-production-skills/tree/HEAD/skills/drama-audio-soundstage

Preguntar en tu IA favorita

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

Documentación

Drama Audio Soundstage (Ingeniería de Sonido y Composición Musical Inteligente)

Posición del proceso: Diseño de sonido y composición musical comercial para series cortas. Sin generalidades inútiles: No explica qué es una pista de audio; solo consolida parámetros de limpieza por puerta de audio, umbrales de detección de idioma y curvas de mezcla con ducking de cadena lateral.


1. Contrato de ejecución, entrada y salida

  • Entrada:
    1. Storyboard de video con audio nativo de la 3.ª etapa: segments/{seg_id}.mp4;
    2. Música de fondo (BGM) de alta calidad independiente: assets/bgm/*.wav.
  • Salida:
    1. Storyboard limpio de ruido de fondo: cleaned_segments/{seg_id}.mp4;
    2. Video final con BGM de 90 s de suspense corporativo y ducking inteligente de cadena lateral: [nombre_del_episodio]_final_ducked.mp4;
    3. Informe de calidad de ASR sobre idioma y precisión del diálogo.

2. SOP técnico: Limpieza por puerta de audio con resta espectral (Audio Gate)

Fenómeno: El audio generado por H3 a menudo contiene un zumbido eléctrico continuo de baja frecuencia, ruido de viento falso o ruido ambiental molesto que arruina la inmersión audiovisual. Objetivo: Eliminar por completo el ruido de fondo continuo, conservando al 100% el diálogo y los sonidos de acción breves (saca de espada, golpe en la mesa, pasos).

2.1 Parámetros clave de la puerta y su significado físico

Al ejecutar scripts/audio_gate.py se aplica el conjunto de parámetros de oro:

  • --bed-q 15: Percentil de la ventana deslizante temporal (percentil 15), identifica con precisión el ruido de fondo continuo;
  • --alpha-bed 6.0: Intensidad de eliminación del ruido continuo;
  • --alpha-fx 1.0: Factor de protección de sonidos transitorios/diálogo; cuanto menor, más completo es el diálogo;
  • --fx-snr 4.0: Umbral de relación señal/ruido;
  • --quiet-gain 0.03: Coeficiente de atenuación de tramos de silencio puro.

Comando:

python scripts/audio_gate.py --in segments/seg01.mp4 --out cleaned_segments/seg01.mp4

3. SOP técnico: Intercepción automatizada de desviación de idioma mandarín con ASR

Fenómeno: La pronunciación de los personajes deriva hacia pseudoinglés, galimatías o ruido no chino, afectando gravemente la entrega.

3.1 Intercepción y criterio

Tras la escritura, se ejecuta una verificación ultrarrápida de idioma con Whisper ligero:

  1. Extraer los primeros 5 segundos de la pista de audio para identificar el idioma;
  2. Criterio de aprobación: language == "zh" y confianza prob >= 0.85;
  3. Acción de intercepción: si se detecta en u otro idioma, se lanza automáticamente LanguageDriftError, se marca el storyboard como fallido y se desencadena una nueva ejecución con otra semilla.

4. SOP técnico: Mezcla con ducking de cadena lateral de nivel cinematográfico (Sidechain Ducking)

Prohibición (contraejemplo): ¡No colocar el BGM a volumen fijo debajo del video sin más! El diálogo quedará ahogado por la música de fondo, sin ninguna sensación de capas cinematográficas.

4.1 Curva de oro de sidechaincompress nativo de FFmpeg

Se usa el diálogo como señal de control de cadena lateral para comprimir dinámicamente el BGM en tiempo real:

  • Volumen base del BGM: bgm_volume = 0.35;
  • Umbral (Threshold): ducking_threshold = 0.06 (en cuanto la voz se abre, se dispara el descenso);
  • Profundidad de descenso (Ratio): ducking_ratio = 5.0 (cuando se habla, el BGM desciende instantáneamente aprox. -14 dB, dejando la banda de frecuencia completamente clara para la voz);
  • Tiempo de ataque (Attack): ducking_attack_ms = 80ms (descenso suave inmediato al inicio de la primera sílaba, sin estallidos bruscos);
  • Tiempo de liberación (Release): ducking_release_ms = 400ms (cuando el diálogo calla, el BGM sube suavemente durante 0.4 s, realzando la tensión).

Comando:

python scripts/cinematic_audio_mixer.py --input concat_raw.mp4 --output final_ducked.mp4 --bgm assets/bgm/suspense.wav

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

comfy-h3-render-core

短剧工业化管线·第 3 工序:H3 物理视频渲染与防翻车调度。负责与本地 ComfyUI 服务交互,调度 MiniMax H3 进行 Turbo 8-step 视频生成。硬核沉淀:Windows WDDM 驱动锁防御、潜空间 32 整除铁律、单人发音锁定与全员闭嘴抑制指令装配、首帧 I2V 安全注入、分镜间显存防泄漏。

comfy-h3-video-producer

本地 ComfyUI 剧本转视频自动生产管线(MiniMax H3)。用户给剧本要求用 ComfyUI 出分镜视频,或提到"一采二采/超分/班长套件/CSGlide/工作流生成视频"时使用。覆盖:工作流握手(不写死节点号)、导演调度与段规划、H3 提示词、提交与自动监工、一采双检闸门、收片清床音与拼接、断点续产。

drama-director-staging

短剧工业化管线·第 1 工序:编剧与导演分镜调度。负责将剧情大纲或小说文本转化为符合短剧视听规律的工业级分镜。内置:6 大动态运镜轮换决策树、台词纯中文汉字归一化(数字大写)、短剧快节奏 20~28 字密度调控、单人发言与旁观者闭嘴标注。

drama-finishing-upscaler

短剧工业化管线·第 5 工序:终期成片与 1080p 超分增强。负责全集分镜无损拼接与院线级 1080p 超分辨率放大。硬核沉淀:FFmpeg concat 零损耗直拼、RealESRGAN x2plus GPU 独占 FP16 批量超分(~4.8fps)、原生高质量避让音轨无损混流、ffprobe 工业级物理参数验收。

drama-keyframe-forge

短剧工业化管线·第 2 工序:分镜定帧与资产一致性。负责在视频渲染前,建立全局风格母卡 (Style Bible),并为每个分镜前置生成“场景+人物+道具”三合一的 16:9 高清定帧垫图。彻底根治 T2V 盲跑带来的人脸变形、角色换脸、场景变色与道具软化。

Skills relacionados