OpenMontage Character Animation 资产总监Asset Director实战指南从 Rig Plan 到 asset_manifest 的资产生成与关卡控制【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读在 OpenMontage 的 character-animation 流水线中assets资产生成是连接设计好的角色与动作和可渲染的动画的关键关卡它把rig_plan、pose_library、scene_plan落地为一套完整、可校验、可追溯的asset_manifest。本文以 skills/pipelines/character-animation/asset-director.md 为骨架结合 pipeline_defs/character-animation.yaml 的阶段契约与 tools/character/character_animation.py 的底层实现讲解资产目录组织、Layer 3 技能预读、资产生成流程、质量闸门与绑定式人工审批Gate Reminder机制。读完你将掌握如何在 OpenMontage 中正确地产出素材而不是堆砌素材并理解为什么缺部件会阻塞合成compose。一、assets 阶段在流水线中的位置与契约character-animation 流水线共 10 个阶段assets是第 7 个前后衔接关系如下依据 pipeline_defs/character-animation.yamlresearch → proposal → script → character_design → rig_plan → scene_plan → assets → edit → compose → publishassets 阶段的契约定义输入required_artifacts_incharacter_design、rig_plan、pose_library、scene_plan可选输入为script、proposal_packet产出producesasset_manifest可用工具tools_availableimage_selector、tts_selector、music_gen、character_rig_renderer关卡策略checkpoint_requiredtrue且human_approval_default: true人工审批默认开启review_focus评审焦点角色部件/背景/道具/音频/特效是否与场景一一挂钩、每次生成或使用动画运行时工具前是否读取 Layer 3 技能、资产溯源与提示词是否记录、缺失的 rig 资产是否被显式阻塞而非隐藏。从依赖关系可以看到assets 是设计侧rig_plan、pose_library、scene_plan与执行侧edit、compose之间的分水岭上游只产生结构化描述下游要真正消耗文件。因此asset_manifest是合成前最后一次物料盘点。二、Asset Director 的目标Asset Director 的核心目标一句话概括产出包含角色部件、背景、道具、音频、音乐与预览产物preview artifacts的asset_manifest见 asset-director.md。这背后体现的是 OpenMontage 一以贯之的职责分离哲学导演角色只做编排与审批不直接调像素级工具结构化产物JSON manifest是各阶段之间唯一的契约载体。这一点在 tools/character/character_animation.py 的模块 docstring 中写得非常明确Python only creates structured artifacts and lightweight preview/review outputs——创意编排留在技能与 manifest 层代码层只负责生成结构化工件和轻量预览/评审产物。三、目录规范资产放在哪里资产目录是后续所有阶段尤其是 compose查找文件的依据必须严格遵循projects/project-name/assets/characters/character-id/字符资产必须使用三个子目录parts/ # 角色可动部件四肢、头部、嘴型、尾巴、翅膀等 poses/ # 命名姿态/动作循环所需的素材 previews/ # 预览产物HTML 预览、预览 MP4 等生成式背景generated backgrounds单独存放projects/project-name/assets/backgrounds/这条规范的检验逻辑也写进了流水线契约的 success_criteriaCharacter assets are organized under projects/ /assets/characterscharacter-animation.yaml。也就是说目录是否符合规范不是风格偏好而是关卡校验项之一。渲染侧同样遵守统一的产出约定最终视频交付路径为projects/project-name/renders/final.mp4见 compose-director.md。四、Layer 3 Gate生成前必须预读的领域技能Asset Director 的Layer 3 Gate规定在撰写或生成动画资产之前必须先阅读相关的 Layer 3领域执行层技能asset-director.md。按用途分类需要预读的技能包括用途必须预读的技能骨架/装配character-rigging、svg-character-animation、pose-library-designCanvas 特效canvas-procedural-animation仅当使用 p5/canvas 效果时质量评审character-animation-qareview 之前读GSAP/Remotion 动效gsap-core、gsap-timeline、gsap-reactRemotion 渲染remotion、remotion-best-practicesHyperFrames 渲染hyperframes、hyperframes-cli此外在调用图片/TTS/音乐生成工具之前必须从工具注册表registry读取该工具的agent_skills。这条规则是强制的流水线 review_focus 中专门有一项Layer 3 skills are read for every generation or animation-runtime tool且成功标准要求Asset provenance and prompts are recorded。事实上每个工具在自己的定义里就声明了agent_skills——例如svg_rig_builder声明[character-rigging, svg-character-animation, gsap-core, gsap-timeline]character_rig_renderer声明了 7 项技能见 character_animation.py 与 L476-L484。预读技能的本质是让 Agent 在动手前获得与工具能力匹配的领域知识避免拿着锤子找钉子式的盲目生成。对应到仓库Layer 3 技能正文位于 skills/creative/ 与 skills/meta/ 目录如character-rigging、remotion、hyperframes等均可在 skills 目录树下找到对应技能文档而动画运行时选择策略可参考 skills/meta/animation-runtime-selector.md。五、核心流程五步产出高质量资产Asset Director 定义了五步流程asset-director.md只产出 rig_plan 要求的部件rig_plan是资产生成的物料清单只生成或采购清单上的部件杜绝多余的素材浪费预算与时间每个可动部件保持独立头部、瞳孔、嘴型、手臂等必须是独立图层/独立文件这是后续 pose 插值与时间线编译的前提——你可以回想 rig-plan-director.md 的要求每个移动部件都要有 pivot支点、层序layer order与约束constraints部件保留透明背景透明背景PNG/SVG 分离图层是合成阶段自由摆位、叠加背景、做挤压拉伸squash/stretch的基础记录提示词、种子、提供商与模型名这是资产可追溯性的直接落地对应契约 review_focus 中的Asset provenance and prompts are recorded先构建小规模预览再全量扩充资产先做 sample 级验证对应 proposal 阶段的 10-15 秒 sample 约定见 character-animation.yaml确认风格与装配没问题后再投入全量资产生产。六、Quality Bar缺部件是合成前的硬阻塞质量闸门的规则非常刚性asset-director.mdrig_plan引用的所有部件必须在 compose 之前全部存在。缺失部件是阻塞项blocker除非 action timeline 明确移除了需要它们的动作。这条缺即阻塞、不许隐藏的规则在流水线契约中有三重呼应assets 阶段 review_focusMissing rig assets are blocked, not hiddenassets 阶段 success_criteriaAll referenced asset files existcharacter-animation.yaml评审工具character_animation_reviewer会在character_qa_report中检查assets_exist预览路径是否存在、pivots_defined、poses_defined、actions_timed等维度任一缺失都会产出revise状态见 character_animation.py。同时要记住 assets 是产出 or 采购produce or source的不一定要从零生成只要部件满足需求即可。这与 character-design-director.md 中MVP 一到两个角色最合适不要发明超过已批准时长能用到的姿态数量的约束一脉相承——资产规模必须与批准的项目范围匹配而不是越大越好。七、工具的配合从 rig 到 asset 的底层证据虽然 assets 阶段本身只列了image_selector、tts_selector、music_gen、character_rig_renderer四个工具但整个 character-animation 工具族的实现可以帮你理解部件独立 数据驱动到底如何在代码里落地。所有工具都位于 tools/character/character_animation.pycharacter_spec_generator把批准的概念转成结构化character_design为每个角色生成id、role、body_type、required_emotions、required_actions、required_views、props等字段L109-L182svg_rig_builder从character_design生成rig_plan为每个角色生成 base partsbody/head/eye/pupil/mouth/arm/leg并根据body_type或id智能追加tail、wing_left/right等部位同时为每个部件定义 pivot、rotation 范围与 scale 范围还会标注风险项Generated pivots are first-pass estimates; review with preview frames.L185-L280pose_library_builder从rig_plan生成pose_library内置 idle/blink/look_left/look_right/surprised 五个基础姿态并为每个 required action 生成首版姿态占位还定义了 mouth_shapesclosed/small_o/wide/smile与 action_cycleswalk/breatheL283-L367character_rig_renderer生成 HTML 预览与 HyperFrames 渲染包同时产出asset_manifest和edit_decisions两个结构化工件L466-L785。其中character_rig_renderer对本文主题尤其重要——它直接演示了asset_manifest的形态assets数组里的每个条目包含id、type、path、source_tool、scene_id、duration_seconds、format、generation_summary等字段并带total_cost_usd与metadata含workspace_path。它还把动画工作区写入hyperframes.jsonregistry 指向 HyperFrames 官方 registrypaths 指向 compositions/components/assets 三个子目录并生成DESIGN.md记录背景色、前景墨线色、强调色与动效方案——这恰好是记录提示词与资产溯源的代码级示范。另一条值得注意的底层事实角色差异是数据不是代码路径。svg_rig_builder中一只鸟有wing_left/wing_right一只老鼠有tail但两者都落到同一个 parts/joints/layers 数据结构里喂给同一套 pose 插值与时间线编译逻辑rig-plan-director.md 称之为 Runtime Pattern。这意味着 assets 阶段产出的一切部件都必须能映射回这套统一的数据模型而不是为某个角色写一次性代码。八、Gate Reminder绑定式人工审批assets 阶段是绑定式Binding人工审批关卡asset-director.md该关卡默认开启人工审批human_approval_default: true审查通过后必须以statusawaiting_human记录 checkpoint通过 Backlot board 呈现资产摘要Backlot 会渲染 artifact然后 END YOUR TURN结束当前回合不得在同一轮回复中开始下一阶段审批按关卡独立生效——之前任何一个关卡的go ahead都不覆盖本关卡。这套机制在流水线契约里同样有据可查checkpoint_required: true、human_approval_default: true都定义在 character-animation.yaml。与其他阶段对比可以更清楚地看出 assets 的特殊性rig_plan、edit、compose阶段均为human_approval_default: falseAgent 自主推进而assets与proposal、script、character_design、scene_plan、publish一样需要人工把关。原因很直观资产生成直接花钱图片/TTS/音乐生成且决定下游能否顺利合成所以必须在物料敲定前让人确认。对于熟悉 Backlot 的读者这里顺带说明Backlot 是一个面向人工评审的工作台负责渲染各阶段的 artifact 供审阅其界面包括 board看板与 library素材库等视图具体可参考 backlot/README.md。资产摘要通过它呈现是awaiting_human checkpoint 落地的展示层。九、前后阶段衔接编辑与合成如何消费 asset_manifest为了理解资产清单的价值值得快速看一眼下游两个阶段如何消费它edit 阶段edit-director.md输入scene_plan、asset_manifest、pose_library产出edit_decisions与action_timeline。它把场景节拍转为定时角色动作遵循anticipation → action → hold/reaction → settle的时序模式并用action_timeline_compiler做首版编译compose 阶段compose-director.md首先校验edit_decisions.render_runtime与 proposal 锁定的运行时一致remotion→ 将资产 staging 进remotion-composer/public后用video_compose渲染hyperframes→ 物化 HyperFrames 工作区并委托hyperframes_compose且hyperframes lint/validate必须通过ffmpeg→ 仅限后期处理与简单合成不足以支撑角色表演。compose 阶段还会用character_animation_reviewer对 rig、poses、timeline、preview 做评审最终交付projects/project-name/renders/final.mp4。可以看到asset_manifest 是整个链条的物料结算单——edit 依据它编排动作compose 依据它核对 runtime 与资源QA 依据它检查assets_exist。资产缺一就会在下游以 blocker 的形式显式浮出水面。十、实战检查清单把全文浓缩成 Asset Director 上岗自查清单已按 Layer 3 Gate 预读 rigging / svg / pose / gsap / remotion / hyperframes 等技能已从工具注册表读取将调用的 image/TTS/music 工具的agent_skills只产出rig_plan要求的部件每个可动部件独立且透明背景字符资产位于projects/project-name/assets/characters/character-id/的 parts/poses/previews 子目录背景位于assets/backgrounds/已记录每个资产的提示词、种子、提供商与模型名provenance已先产出小规模预览验证风格与装配再全量扩充已确认rig_plan引用的全部部件存在或对应动作已从 action timeline 移除产出 schema 合法的asset_manifest且所有引用文件真实存在checkpoint 置为statusawaiting_human在 Backlot 呈现摘要并 END YOUR TURN 等待本关卡独立审批。相关文档导航本阶段技能skills/pipelines/character-animation/asset-director.md流水线契约pipeline_defs/character-animation.yaml角色设计上游character-design-director.md装配计划上游rig-plan-director.md场景计划上游scene-director.md编辑/合成下游edit-director.md、compose-director.md流水线总控executive-producer.md工具实现tools/character/character_animation.py测试参考tests/contracts/test_character_animation_pipeline.py【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考