SuperAPI AI 工具集

animation-quality-gate

设计与创作

查看项目

更新于 10-15 15:33

技能介绍

Animation Quality Gate 是一个面向 Blender 动画流程的质量验收技能,用于在接受或导出动画之前进行系统化检查。其核心理念是:动画仅仅能够渲染并不代表质量合格,只有在生成接触表(contact sheet)并完成失败分析后,才允许验收。

用途与适用场景

该技能适用于动画 QA、接触表审查、动作点评(motion critique)、变形(morph)验证、纹理闪烁检测、分镜检查、拒绝不合格的动画批次,以及导出前的动画验收关卡。

前置准备与后端约定

在第一次调用 Blender 之前,需要阅读 ../text-to-blender/references/mcp-backends.md。共享能力优先使用官方 MCP;一旦选定后端,应在整个任务中保持不变。配方中的工具名称属于客户端或遗留示例,需要通过上述参考文档及其 agent-host 指南进行映射。

审查维度

该技能从以下七个维度评估动画:

  1. 主体主导性(Subject dominance)——主要资产保持可读性,不被 HUD 或上下文元素压制。
  2. 图层分离(Layer separation)——基础主体、纹理状态、发光、HUD 和背景之间有足够的分离度以便控制。
  3. 轮廓稳定性(Silhouette stability)——除非明确指定了有意的形变,否则轮廓应保持恒定。
  4. 纹理一致性(Texture coherence)——不出现难看的整图交叉淡入淡出、裁切跳变或未对齐的形变。
  5. 运动一致性(Motion coherence)——弧线或点位有合理原因,速度克制,缓动连贯。
  6. 导出真实性(Export truth)——最终导出能够复现该效果,或者明确说明其局限。
  7. 单帧美感(Frame aesthetics)——抽样的帧作为静帧看起来依然良好。

RALPH 触发机制

如果用户称某个动画难看或糟糕,应立即停止重建,先执行以下步骤:收集预览帧或接触表;识别失败的维度;如果技术栈缺少方法,则调用 quality-refinement-autoloop;仅在消毒(sanitization)之后添加或改进通用技能;之后才重建动画。

硬性门槛

  • 没有接触表,不得交付最终动画。
  • 对于仅通过 Blender Python 处理器实现的纹理替换,不得声称支持 GLB。
  • 除非被要求,基础虚拟形象导出中不得包含装饰性上下文元素。
  • 不得使用违反锁定几何约束的形变。

脚本

scripts/animation_contact_sheet.py 可从渲染帧构建接触表,并生成帧间差异报告。