Communitygithub.com

leecyno1/newma-media-studio

Usar após corte bruto/recepção e antes da geração de assets ao converter scripts de artigos, ASR, legendas ou HTML bruto em planos de tomada, planos de cena, escolhas de template, estados de composição, transições, políticas de áudio e portas de revisão.

O que é newma-media-studio?

Este skill implementa a camada de direção em um pipeline de produção de vídeo, atuando como o ponto de controle entre a recepção do roteiro/corte bruto e a geração de materiais. Ele oferece suporte a seis faixas de produção distintas: orador presencial com evidências em PIP/B-roll/gráficos, investigação em estilo VOX, explicações científicas sem apresentador baseadas em HTML, apresentadores digitais/entrevistas duplas, curtas-metragens cinematográficos e vídeos promocionais comerciais. Após receber entradas como scripts, legendas, relatórios de corte bruto e arquivos HTML, o skill produz um conjunto abrangente de artefatos de planejamento, incluindo planos de cena detalhados, roteiros de ferramentas, especificações de alegações e livros razão de evidências, antes de qualquer renderização. Ele impõe regras rigorosas sobre seleção de composição, ritmo de edição (70-100 microtomadas em 4-5 minutos), autenticidade de evidências e políticas de colisão, enquanto roteia beat conceituais para ilustrações e dados reais para renderizadores de evidências. A saída deve passar por portas de qualidade (scene_plan_quality_gate, claim_evidence_gate, renderer_contract_gate) antes da renderização, garantindo que qualquer problema de precisão factual, adesão à narração ou integridade da evidência seja resolvido. O skill é executado principalmente via scripts Python, com pontos de entrada específicos para cada faixa, e integra-se ao sistema de manifesto de execução de projeto para rastreamento de artefatos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/newma-media-studio/tree/HEAD/skills/dasheng-video-director

Perguntar na sua IA favorita

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

Documentação

Newma Video Director

Função

Você é a camada de direção. Seu trabalho é transformar conteúdo em um plano de vídeo revisável, não renderizar a mídia final.

Este skill fica entre a recepção de roteiro/corte bruto e a geração de materiais:

brief/script -> director scene_plan -> claim/evidence ledger -> storyboard review -> asset build/render

Use este skill para seis faixas registradas. Leia configs/video/director_registry.json primeiro e use o perfil de diretor correspondente:

  • 真人出镜口播: o orador é a âncora de confiança; evidências, PIP, B-roll, gráficos, documentos e transições conduzem o ritmo.
  • VOX 调查解释: uma pergunta central, mapa de evidências, contra-argumento, conclusão qualificada, tomadas geradas por Shotcraft/Remotion e explicativas.
  • 无真人 HTML 科普: a narração é a linha do tempo; cenas HTML animadas carregam narração, prova, ritmo e estrutura.
  • AI 数字人: apresentador único ou entrevista dupla; cada fonte de apresentador é gerada independentemente e composta por turnos de orador ativo.
  • 电影短剧: apenas planejamento por padrão; produza roteiro, bíblia de personagem/continuidade e storyboard, mas não chame APIs de vídeo externas pagas.
  • 广告宣传片: um objetivo, um CTA, revelação antecipada do produto, assets reais de produto/prova, memória de marca e áreas seguras multiaspecto.

Todas as seis faixas seguem:

素材接收 -> 编剧/口播重写 -> 导演分镜 -> 素材生成 -> 剪辑合成 -> 渲染 -> QC/交付

Leitura Obrigatória

Antes de produzir um plano de diretor, leia:

  • docs/technical/video-pipeline-governance.md
  • docs/technical/video-editing-driving-mechanism.md
  • configs/video/video_editing_driver_rules.json
  • configs/video/director_feedback_memory.json
  • configs/video/tool_registry.json
  • configs/video/director_registry.json
  • configs/external/reserved_projects.json
  • configs/video/reference_video_dna_registry.json
  • ~/Desktop/自媒体创作/00_范式学习/视频训练/每日博主自学习/knowledge/index.md quando a base de conhecimento de autoaprendizagem diária existir
  • O manifesto de pipeline relevante:
    • configs/video/pipelines/talking_head.yaml
    • configs/video/pipelines/vox_explainer.yaml
    • configs/video/pipelines/explainer_html.yaml
    • configs/video/pipelines/digital_human.yaml
    • configs/video/pipelines/cinematic_short_drama.yaml
    • configs/video/pipelines/commercial_promo.yaml

Entradas

Aceite qualquer combinação de:

  • project_run_manifest.json
  • brief.json
  • script.json
  • roughcut_gate_report.json
  • roughcut_edl.json ou decisões de edição de segmento mantido equivalentes quando legendas foram geradas antes do corte bruto
  • agent_proofread.srt
  • captions_full.json
  • article.html
  • commercial_brief.json para commercial_promo_video
  • explainer_storyboard.json
  • gráficos de rascunho, imagens, tabelas e referências de dados
  • perfil de estilo opcional em ~/Desktop/自媒体创作/00_范式学习/视频训练/<style_id>/style_profile.json
  • perfil de estilo curado opcional selecionado de configs/video/reference_video_dna_registry.json
  • notas candidatas de autoaprendizagem do criador opcionais em ~/Desktop/自媒体创作/00_范式学习/视频训练/每日博主自学习/

Notas de autoaprendizagem são consultivas. Leia o perfil contínuo do criador, o playbook do diretor, o playbook estético e o mapeamento de stack técnico apenas quando seu escopo corresponder à faixa atual. Prefira regras com evidência explícita e confiança maior. Nunca deixe um candidato automático substituir um perfil histórico aprovado, a evidência do artigo atual ou feedback do usuário registrado neste skill.

Não selecione uma referência apenas pelo nome do criador. Selecione por escopo de produção:

  • explicação financeira clássica estilo Xiaolin para finanças densas com orador;
  • referência de entrevista Xiaolin mais recente apenas para gramática de conversa e demonstração de produto;
  • referência Wizard mais recente para gramática de documentário visual em tela cheia sem humano;
  • referência imobiliária XHS aprovada para mapas profissionais, tabelas, planos e explicação orientada por métricas.

Contrato de Saída

Sempre produza um scene_plan antes da geração de materiais:

  • scene_plan.json
  • tool_routing_plan.json, registrando ferramenta principal, ferramenta de backup, ferramenta bloqueada e motivo de dependência para cada fase de produção e cada quadro de storyboard
  • scene_plan_quality_gate.json
  • claim_spec.json com aproximadamente 8 a 12 alegações centrais para um vídeo financeiro normal de 4 a 6 minutos
  • claim_evidence_ledger.json
  • claim_evidence_gate.json
  • claim_evidence_review.html
  • spoken_revision_sheet.json e spoken_revision_sheet.html quando a narração original precisar ser cortada, substituída, dublada ou regravada
  • scene_plan.claim_bound.json
  • storyboard_template_review.html ou página de revisão equivalente
  • storyboard_review_decision.json após aprovação do usuário
  • storyboard_review_gate.json
  • director_checkpoint.json opcional
  • timeline_alignment dentro do plano de cena final
  • evidence_binding em cada cena com evidência vinculada
  • renderer_contract_gate.json antes da renderização

O plano de cena deve satisfazer configs/video/artifact_schemas/scene_plan.schema.json e passar por scripts/video_scene_plan_quality_gate.py antes da geração de materiais ou renderização. O diretor deve rotear cada cena através de scripts/video_director_tool_router.py. Cada cena deve conter tool_routing.required_capabilities, primary_stack, fallback_stack e avisos de capacidade não resolvida. Um projeto ou Skill marcado como reference_only, sem chave de API/login/modelo ou sem seu runtime, não pode se tornar uma rota principal. O livro razão de alegações deve satisfazer configs/video/artifact_schemas/claim_evidence_ledger.schema.json. Uma porta de alegação/evidência com falha bloqueia a geração de assets, não apenas a renderização final.

Ponto de entrada executável padrão:

python3 scripts/dasheng_video_director.py \
  --lane explainer_html_video \
  --article-html <article.html> \
  --output-dir ~/Desktop/自媒体创作/<run_id>/video_director

Para filmagem com orador:

python3 scripts/dasheng_video_director.py \
  --lane talking_head_video \
  --srt <agent_proofread.srt> \
  --source-video <roughcut.mp4> \
  --roughcut-gate <roughcut_gate_report.json> \
  --roughcut-edl <roughcut_edl.json> \
  --output-dir ~/Desktop/自媒体创作/<run_id>/video_director

Se as legendas foram geradas a partir do próprio corte bruto final, omita --roughcut-edl. Nunca comprima uma linha do tempo pré-cortada com um fator de escala global.

Para um apresentador humano digital ou entrevista dupla, use o mesmo ponto de entrada com --lane digital_human_video; as legendas de entrada já devem identificar turnos de orador, e o pacote do apresentador deve usar presenter_source.mode=single_presenter|dual_interview.

Para um promo comercial:

python3 scripts/dasheng_video_director.py \
  --lane commercial_promo_video \
  --commercial-brief <commercial_brief.json> \
  --output-dir ~/Desktop/自媒体创作/<run_id>/commercial_promo_director

A faixa cinematográfica permanece apenas para planejamento. Construa seu pacote de roteiro/storyboard através de dasheng-stage-transwrite / scripts/build_stage4_transwrite.py; não use o renderizador ou rota de provedor externo enquanto execution_enabled=false.

Se a produção atual tiver um project_run_manifest.json, registre cada saída com:

python3 scripts/project_run_manifest.py add-artifact <project_run_manifest.json> \
  --stage scene_plan \
  --type scene_plan \
  --path <scene_plan.json>

Execute a porta de qualidade do diretor antes de qualquer renderização:

python3 scripts/video_scene_plan_quality_gate.py <scene_plan.json> \
  --output <scene_plan_quality_gate.json>

Para 真人口播, um scene_plan_quality_gate.json com falha bloqueia a renderização. Revise o storyboard primeiro.

Após o timing das microcenas estar bloqueado, agrupe as cenas em alegações centrais e audite evidências:

python3 scripts/video_claim_evidence_ledger.py \
  --scene-plan <scene_plan.real_evidence.json> \
  --claim-spec <claim_spec.json> \
  --output-dir ~/Desktop/自媒体创作/<run_id>/claim_evidence

Não trate automaticamente cada frase falada como um fato separado. Cada microcena deve pertencer a exatamente uma alegação central. Fatos, comparações, alegações causais e alegações históricas exigem evidência direta e localizável. Rumores, previsões, opiniões e cenários exigem uma divulgação explícita na tela.

Alterar uma alegação de fact para opinion não deve ocultar uma frase original incorreta. Se o áudio contiver um número contradito, porcentagem indefinida, afirmação causal sem suporte ou certeza falsa, adicione spoken_revision_requirements. A porta permanece fechada até que a cena tenha um narration_override, decisão de corte/exclusão, dublagem aprovada ou regravação.

Modelo de Decisão do Diretor

Não mapeie cada frase para um adesivo aleatório. Conduza as cenas com:

semantic beat -> evidence need -> attention debt -> trust debt -> cognitive load -> composition -> template/material -> motion -> transition -> audio

Cada cena deve responder:

  • O que se espera que o espectador entenda agora?
  • Que evidência ou metáfora visual a suporta?
  • Por que esta composição em vez da anterior?
  • Que movimento acontece dentro da cena?
  • Como esta cena entra e sai?
  • O que pode dar errado: colisão, desordem, dados falsos, desvio de legenda, repetição?

Roteamento de Ilustração Conceitual

dasheng-lemon-illustrations é o sistema de cartoon padrão para futuras simplificações de orador quando um beat precisar de uma metáfora, fluxo de trabalho, reinicialização emocional, mecanismo abstrato ou ponte de capítulo. O personagem recorrente é 柠檬人, não o personagem upstream.

  • Leia os rascunhos illustration_intents antes de inventar novas metáforas visuais. Se a fonte disser explicitamente “比如/例如/举个例子/就像/好比/仿佛/如同” ou usar uma metáfora financeira física, preserve seu significado central e roteie através do skill lemon.
  • Use setup -> character action -> result para exemplos e metáforas. Metáforas simples normalmente precisam de 4 a 7 segundos; micro-histórias de exemplo normalmente precisam de 7 a 12 segundos.
  • Roteie números reais, gráficos, tabelas, páginas de origem, documentos, mapas e UI de produtos para renderizadores de evidências primeiro.
  • Roteie apenas beats conceituais para ilustrações lemon e marque-os como evidence_authenticity=schematic.
  • Defina illustration_system=dasheng-lemon-illustrations, illustration_mode=full_canvas|transparent_overlay e um concept_action concreto no plano de cena.
  • Não atribua um cartoon a cada frase. Evite mais de dois microplanos consecutivos de ilustração lemon sem um retorno do orador, evidência real ou uma família de materiais diferente.
  • Para cenas com orador, use assets lemon transparentes como uma camada de composição. Para cenas sem humano, use ilustrações em tela cheia apenas quando elas avançarem o argumento.
  • A imagem rasterizada gerada não é a animação final. Planeie movimento separado para o personagem, adereço, caminho, anotação, máscara ou transição PIP; zoom/pan estático falha no QC.

Regras para 真人口播

Máquina de estados padrão:

speaker_anchor -> claim_closeup -> evidence_fullscreen -> broll_with_pip -> document_zoom/chart_card -> speaker_return

Campos obrigatórios por cena:

  • speaker_state: full, half_left, half_right, circle_pip, rounded_rect_pip, vertical_strip ou hidden
  • material_state: none, transparent_overlay, evidence_fullscreen, document_fullscreen, chart_fullscreen, broll_fullscreen ou split_screen
  • pip_shape: none, circle, rounded_rect, square, phone_mockup ou nested_card
  • html_animation_behavior: comportamento concreto como line_draw_axis_then_series, table_scan_highlight_rows, document_zoom_marker_circle, pip_circle_morph_to_rect
  • collision_policy: zonas seguras para rosto, tronco, legenda e dados chave

Regras rígidas:

  • A porta de corte bruto deve ser aprovada antes do planejamento final de renderização.
  • Exclusões discretas devem usar scripts/video_timeline_edl.py ou ASR do corte bruto final. global_scale / timeScale uniforme após o corte bruto é proibido.
  • Não mantenha o orador mecanicamente no mesmo canto.
  • Não use zoom/pan de imagem estática como animação.
  • Seções pesadas em evidências podem ocultar o orador, mas devem retornar ao orador após a sequência de evidências.
  • Não mais de duas cenas consecutivas devem compartilhar o mesmo speaker_state + material_state + pip_shape.
  • O orador deve normalmente retornar dentro de 8 a 20 segundos, a menos que o segmento seja uma sequência densa de evidências.
  • Não pare em cenas de nível de capítulo/parágrafo. Um vídeo com orador de 4 a 5 minutos deve normalmente se expandir para cerca de 70 a 100 microplanos, ou pelo menos passar pelo piso rígido de 14 mudanças visuais efetivas por minuto.
  • O segmento visual mediano deve permanecer abaixo de 4,5 segundos; o alvo preferido estilo Xiaolin é de 1,4 a 4,0 segundos.
  • Qualquer cena mais longa que 8 segundos deve incluir um array micro_shots que especifique cortes internos, morfismos PIP, trocas de evidências, revelações de gráficos, inserções de B-roll ou retornos do orador.
  • Cenas de evidência devem carregar evidence_authenticity: real_data, source_screenshot, user_claim_card ou schematic. Use schematic apenas para animações conceituais claramente marcadas.
  • Cenas conceituais de cartoon devem usar dasheng-lemon-illustrations; não gere o personagem recorrente upstream nem substitua por um mascote genérico.
  • Cenas vinculadas a real_data e source_screenshot devem incluir evidence_binding.claim_id, relation=direct e um source_locator concreto. Páginas iniciais de empresas e gráficos de preços correlacionados são contexto, não prova direta.
  • evidence_binding.claim_id deve ser o ID da alegação central após aprovação do Ledger. Preserve o ID da alegação da microcena original como micro_claim_id para rastreabilidade.
  • Uma alegação composta é comprovada apenas quando todos os itens de evidência explicitamente exigidos são satisfeitos. Uma captura de tela válida não pode provar as outras partes não suportadas do mesmo bloco de frase.
  • Completude de evidências e correção da narração são portas separadas. Zero alegações com evidência faltante é insuficiente quando spoken_revision_sheet.pending_count > 0.
  • O renderizador deve passar por scripts/video_renderer_contract_gate.py; nomes de template que colapsam em um componente genérico não contam como diversidade de template.
  • Um plano de cena que depende principalmente de um sistema de cartão auto-criado não é aceitável, mesmo que os nomes de template difiram. Misture evidência real/semelhante a fonte: gráfico de mercado, página web/notícias/doc, UI de empresa/produto, tabela, B-roll, diagrama lógico e retorno do orador.

Regras para 无真人科普

Máquina de estados padrão:

hook_card -> question_setup -> chapter_card -> evidence_scene -> logic_animation -> cinematic_bridge -> evidence_scene -> recap_card -> ...

[truncado para tradução]

Habilidades Relacionadas