企业官网建设流程全解析

OpenMontage Character Animation 资产总监（Asset Director）实战指南：从 Rig Plan 到 asset_manifest 的资产生成与关卡控制

【免费下载链接】OpenMontageWorld's 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.yaml）：

research → proposal → script → character_design → rig_plan → scene_plan → assets → edit → compose → publish

assets 阶段的契约定义：

• 输入（required_artifacts_in）：character_design、rig_plan、pose_library、scene_plan；可选输入为script、proposal_packet；
• 产出（produces）：asset_manifest；
• 可用工具（tools_available）：image_selector、tts_selector、music_gen、character_rig_renderer；
• 关卡策略（checkpoint_required）：true，且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_criteria："Character assets are organized under projects/ /assets/characters"（character-animation.yaml）。也就是说，目录是否符合规范不是风格偏好，而是关卡校验项之一。渲染侧同样遵守统一的产出约定：最终视频交付路径为projects/<project-name>/renders/final.mp4（见 compose-director.md）。

四、Layer 3 Gate：生成前必须预读的领域技能

Asset Director 的"Layer 3 Gate"规定：在撰写或生成动画资产之前，必须先阅读相关的 Layer 3（领域执行层）技能（asset-director.md）。

按用途分类，需要预读的技能包括：

此外，在调用图片/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）：

1. 只产出 rig_plan 要求的部件：rig_plan是资产生成的"物料清单"，只生成或采购清单上的部件，杜绝多余的素材浪费预算与时间；
2. 每个可动部件保持独立：头部、瞳孔、嘴型、手臂等必须是独立图层/独立文件，这是后续 pose 插值与时间线编译的前提——你可以回想 rig-plan-director.md 的要求：每个移动部件都要有 pivot（支点）、层序（layer order）与约束（constraints）；
3. 部件保留透明背景：透明背景（PNG/SVG 分离图层）是合成阶段自由摆位、叠加背景、做挤压拉伸（squash/stretch）的基础；
4. 记录提示词、种子、提供商与模型名：这是"资产可追溯性"的直接落地，对应契约 review_focus 中的"Asset provenance and prompts are recorded"；
5. 先构建小规模预览，再全量扩充资产：先做 sample 级验证（对应 proposal 阶段的 10-15 秒 sample 约定，见 character-animation.yaml），确认风格与装配没问题后，再投入全量资产生产。

六、Quality Bar：缺部件是合成前的硬阻塞

质量闸门的规则非常刚性（asset-director.md）：

rig_plan引用的所有部件必须在 compose 之前全部存在。缺失部件是阻塞项（blocker），除非 action timeline 明确移除了需要它们的动作。

这条"缺即阻塞、不许隐藏"的规则在流水线契约中有三重呼应：

• assets 阶段 review_focus："Missing rig assets are blocked, not hidden"；
• assets 阶段 success_criteria："All referenced asset files exist"（character-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.py：

• character_spec_generator：把批准的概念转成结构化character_design，为每个角色生成id、role、body_type、required_emotions、required_actions、required_views、props等字段（L109-L182）；
• svg_rig_builder：从character_design生成rig_plan，为每个角色生成 base parts（body/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-L280）；
• pose_library_builder：从rig_plan生成pose_library，内置 idle/blink/look_left/look_right/surprised 五个基础姿态，并为每个 required action 生成首版姿态占位，还定义了 mouth_shapes（closed/small_o/wide/smile）与 action_cycles（walk/breathe）（L283-L367）；
• character_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.json（registry 指向 HyperFrames 官方 registry，paths 指向 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）；
• 审查通过后，必须以status="awaiting_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: false（Agent 自主推进），而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 置为status="awaiting_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

【免费下载链接】OpenMontageWorld's 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