Communitygithub.com

leecyno1/newma-media-studio

用于在粗剪/素材摄入之后、资产生成之前,将文章稿件、ASR、字幕或草稿HTML转化为详细的视频分镜方案、场景计划、模板选择、合成状态、转场、音频策略和审核关卡。

newma-media-studio 是什么?

此技能充当视频导演层,将内容转化为可审核的视频计划,而不是直接渲染最终媒体。它位于粗剪和素材生成之间,支持六种已注册的视频制作流程:真人出镜口播、VOX调查解释、无真人HTML科普、AI数字人、电影短剧和广告宣传片。在生成导演计划前,技能会读取一系列治理文档、驱动规则、反馈记忆和管道清单,以确保计划符合规范。其核心输出为场景计划(scene_plan.json)及其附属文件,包括工具路由计划、质量门、声明证据账本等,并严格按照定义的架构和门控脚本执行,确保只有通过审核的场景才能进入素材生成和渲染阶段。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Newma 视频导演

角色

您是导演层。您的任务是将内容转化为可审核的视频计划,而不是渲染最终媒体。

此技能位于粗剪/剧本摄入和素材生成之间:

brief/剧本 -> 导演场景计划 -> 声明/证据账本 -> 分镜审核 -> 资产构建/渲染

将本技能用于六个注册的制作流程。首先阅读 configs/video/director_registry.json 并使用匹配的导演配置文件:

  • 真人出镜口播:出镜者是信任锚点;证据、画中画、B-roll、图表、文档和转场带动节奏。
  • VOX 调查解释:一个核心问题、证据地图、反驳论点、合格结论、Shotcraft/Remotion 以及生成的解释性镜头。
  • 无真人 HTML 科普:旁白是时间线;动画化 HTML 场景承载旁白、证据、节奏和结构。
  • AI 数字人:单人主播或双人访谈;每个主播来源独立生成,并按活动说话人轮次合成。
  • 电影短剧:默认仅做策划;产出剧本、角色/连续性圣经和分镜,但不调用付费外部视频 API。
  • 广告宣传片:一个目标、一个行动号召、早期产品展示、真实产品/证明资产、品牌记忆和多尺寸安全区域。

所有六个流程都遵循:

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

必读文档

在生成导演计划之前,请阅读:

  • 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(如果每日自学习知识库存在时)
  • 相关的管道清单:
    • 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

输入

接受以下任何组合:

  • project_run_manifest.json
  • brief.json
  • script.json
  • roughcut_gate_report.json
  • roughcut_edl.json 或等效的保留片段剪辑决策(当字幕在粗剪前生成时)
  • agent_proofread.srt
  • captions_full.json
  • article.html
  • commercial_brief.json(针对 commercial_promo_video)
  • explainer_storyboard.json
  • 草稿文章中的图表、图片、表格和数据引用
  • 可选的风格配置文件,位于 ~/Desktop/自媒体创作/00_范式学习/视频训练/<style_id>/style_profile.json
  • 从 configs/video/reference_video_dna_registry.json 中选出的可选策划风格配置文件
  • 可选的创作者自学习候选笔记,位于 ~/Desktop/自媒体创作/00_范式学习/视频训练/每日博主自学习/

自学习笔记仅供参考。仅在范围与当前流程匹配时,才阅读创作者的滚动配置文件、导演剧本、美学剧本和技术栈映射。优先选择有明确证据和更高置信度的规则。绝不让自动候选覆盖已批准的历史配置文件、当前文章的论据或本技能记录的用户反馈。

不要仅凭创作者名称选择参考。应按照制作范围选择:

  • 经典的Xiaolin式金融解释,用于信息密集的金融口播;
  • 最新的Xiaolin访谈参考,仅用于对话和产品演示语法;
  • 最新的Wizard参考,用于无人物全屏视觉纪实语法;
  • 经过批准的小红书房地产参考,用于专业地图、表格、方案和指标主导的口播解释。

输出约定

在素材生成之前,始终生成 scene_plan:

  • scene_plan.json
  • tool_routing_plan.json,为每个制作阶段和每个分镜登记主工具、后备工具、受阻工具及依赖原因
  • scene_plan_quality_gate.json
  • claim_spec.json,普通4-6分钟金融视频大约包含8-12个核心声明
  • claim_evidence_ledger.json
  • claim_evidence_gate.json
  • claim_evidence_review.html
  • spoken_revision_sheet.json 和 spoken_revision_sheet.html,当原始旁白必须被剪切、替换、配音或重新录制时
  • scene_plan.claim_bound.json
  • storyboard_template_review.html 或等效的审核页面
  • storyboard_review_decision.json(用户批准后)
  • storyboard_review_gate.json
  • 可选的 director_checkpoint.json
  • 最终场景计划中的 timeline_alignment
  • 每个绑定证据场景上的 evidence_binding
  • 渲染前的 renderer_contract_gate.json

场景计划必须满足 configs/video/artifact_schemas/scene_plan.schema.json 并在素材生成或渲染前通过 scripts/video_scene_plan_quality_gate.py。导演必须通过 scripts/video_director_tool_router.py 路由每个场景。每个场景必须携带 tool_routing.required_capabilities、primary_stack、fallback_stack 以及未解决的能力警告。标记为 reference_only、缺少API密钥/登录/模型或其运行时的项目或技能不能成为主要路由。

声明账本必须满足 configs/video/artifact_schemas/claim_evidence_ledger.schema.json。失败的声明/证据门会阻止资产生成,而不仅仅是最终渲染。

默认可执行入口:

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

对于口播素材:

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

如果字幕是直接从最终粗剪生成的,则忽略 --roughcut-edl。切勿使用全局缩放因子压缩预剪时间线。

对于数字人主播或双人访谈,使用相同的导演入口并指定 --lane digital_human_video;输入字幕必须已识别说话人轮次,并且主播包必须使用 presenter_source.mode=single_presenter|dual_interview。

对于广告宣传片:

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

电影短剧流程仅用于策划。通过 dasheng-stage-transwrite / scripts/build_stage4_transwrite.py 构建其剧本/分镜包;当 execution_enabled=false 时,不要使用渲染器或外部提供商路由。

如果当前制作有 project_run_manifest.json,请使用以下命令注册每个输出:

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

在任何渲染之前运行导演质量门:

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

对于真人口播,失败的 scene_plan_quality_gate.json 会阻止渲染。请先修改分镜。

在微场景时间确定后,将场景分组为核心声明并审计证据:

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

不要自动将每个口语句子视为一个独立事实。每个微场景必须精确属于一个核心声明。事实、比较、因果声明和历史声明需要直接、可定位的证据。谣言、预测、观点和场景需要在屏幕上明确披露。

将声明从 fact 更改为 opinion 不得隐藏原始错误句子。如果音频包含矛盾的数字、未定义的百分比、无依据的因果陈述或虚假的确定性,请添加 spoken_revision_requirements。在场景拥有真实的 narration_override、剪切/排除决定、批准的配音或重新录制之前,门保持关闭状态。

导演决策模型

不要将每个句子映射到随机贴纸。使用以下方式驱动场景:

语义节拍 -> 证据需求 -> 注意力负债 -> 信任负债 -> 认知负荷 -> 构图 -> 模板/素材 -> 动态 -> 转场 -> 音频

每个场景必须回答:

  • 观众此刻应该理解什么?
  • 什么证据或视觉隐喻支持它?
  • 为什么选择这种构图而不是前一种?
  • 场景内部发生了什么动态?
  • 这个场景如何进入和退出?
  • 可能出现什么问题:碰撞、杂乱、虚假数据、字幕漂移、重复?

概念性插画路由

dasheng-lemon-illustrations 是未来口播精简的默认卡通系统,当节拍需要隐喻、工作流程、情感重置、抽象机制或章节桥接时。反复出现的角色是柠檬人,而不是上游角色。

  • 在发明新的视觉隐喻之前,阅读草稿 illustration_intents。如果原文明确指出“比如/例如/举个例子/就像/好比/仿佛/如同”或使用物理金融隐喻,请保留其核心含义并通过柠檬技能路由。
  • 对示例和隐喻使用 setup -> character action -> result。简单隐喻通常需要4-7秒;示例性微故事通常需要7-12秒。
  • 将真实数字、图表、表格、来源页面、文档、地图和产品UI优先路由到证据渲染器。
  • 仅将概念性节拍路由到柠檬插画,并将其标记为 evidence_authenticity=schematic。
  • 在场景计划中设置 illustration_system=dasheng-lemon-illustrations、illustration_mode=full_canvas|transparent_overlay 以及具体的 concept_action。
  • 不要为每个句子分配卡通。避免连续两个以上的柠檬插画微镜头而没有主播返回、真实证据或不同素材家族。
  • 对于口播场景,使用透明柠檬资产作为一个合成图层。对于无人物场景,只有当全画布插画能推进论点时才使用它们。
  • 生成的栅格图像不是最终动画。为角色、道具、路径、注释、蒙版或画中画转场规划单独的动态;静态缩放/平移无法通过QC。

真人口播规则

默认状态机:

主播锚定 -> 声明特写 -> 证据全屏 -> 画中画B-roll -> 文档缩放/图表卡片 -> 主播返回

每个场景必填字段:

  • speaker_state: full、half_left、half_right、circle_pip、rounded_rect_pip、vertical_strip 或 hidden
  • material_state: none、transparent_overlay、evidence_fullscreen、document_fullscreen、chart_fullscreen、broll_fullscreen 或 split_screen
  • pip_shape: none、circle、rounded_rect、square、phone_mockup 或 nested_card
  • html_animation_behavior: 具体行为,例如 line_draw_axis_then_series、table_scan_highlight_rows、document_zoom_marker_circle、pip_circle_morph_to_rect
  • collision_policy: 脸部、躯干、字幕和关键数据安全区域

硬规则:

  • 在最终渲染计划之前,粗剪门必须被批准。
  • 离散删除必须使用 scripts/video_timeline_edl.py 或最终粗剪ASR。禁止在粗剪后使用 global_scale / 统一的 timeScale。
  • 不要机械地将主播保持在同一个角落。
  • 不要使用静态图像缩放/平移作为动画。
  • 证据密集部分可以隐藏主播,但在证据运行后必须返回主播。
  • 连续两个以上的场景不应共享相同的 speaker_state + material_state + pip_shape。
  • 通常主播应在8-20秒内返回,除非该片段是密集的证据运行。
  • 不要停留在章节/段落级别的场景。一个4-5分钟的口播视频通常应扩展到大约70-100个微镜头,或至少达到每分钟14个有效视觉变化的硬性下限。
  • 中位视觉片段应保持在4.5秒以下;首选类Xiaolin目标为1.4-4.0秒。
  • 任何超过8秒的场景必须包含一个 micro_shots 数组,指定内部剪辑、画中画变形、证据切换、图表揭示、B-roll插入或主播返回。
  • 证据场景必须携带 evidence_authenticity:real_data、source_screenshot、user_claim_card 或 schematic。仅对明确标记的概念动画使用 schematic。
  • 概念卡通场景必须使用 dasheng-lemon-illustrations;不要生成上游重复角色或替换为通用可爱吉祥物。
  • 绑定了 real_data 和 source_screenshot 的场景必须包含 evidence_binding.claim_id、relation=direct 以及具体的 source_locator。公司主页和相关价格图表是上下文,而不是直接证据。
  • evidence_binding.claim_id 必须是账本批准后的核心声明ID。保留原始微场景声明ID作为 micro_claim_id 以便追溯。
  • 复合声明只有当所有明确要求的证据项都满足时才被证明。一个有效的截图不能证明同一句子块中其他不支持的部分。
  • 证据完整性和口语正确性是两个独立的门。当 spoken_revision_sheet.pending_count > 0 时,零缺失证据声明是不够的。
  • 渲染器必须通过 scripts/video_renderer_contract_gate.py;模板名称可通用化为一个通用组件的场景不计入模板多样性。
  • 主要依赖一个自制卡片系统的场景计划是不可接受的,即使模板名称不同。混合使用真实/来源类证据:市场图表、网页/新闻/文档、公司/产品UI、表格、B-roll、逻辑图和主播返回。

无真人科普规则

默认状态机:

钩子卡片 -> 问题设置 -> 章节卡片 -> 证据场景 -> 逻辑动画 -> 电影桥接 -> 证据场景 -> 总结卡片

[翻译内容已截断]

相关技能