用途：将动画需求转化为确定性、可测试的事件-时间线契约，适用于游戏与交互 UI 的事件驱动动画系统设计、排序与校验。
主要能力：定义事件-动画契约（事件源、动画目标、状态、允许的过渡）；按动画组指定可中断性与取消规则；构建时间线映射，为每个事件定义有序步骤及明确的 startMs、durationMs 与 easing，并在不允许重叠时保证步骤窗口不重叠；定义过渡与守卫逻辑，枚举合法的 fromState -> toState 过渡，并为触发抑制、链式调用与回退动画设置守卫；校验流程一致性，检查必填字段、时长、缓动值、过渡引用与步骤顺序，将缺失过渡或负时长视为阻塞项；准备实现交接，交付时间线契约、状态映射与验证输出，并包含运行时动画引擎与 UI 桥接文件的补丁计划。
使用方式：运行校验命令 python3 scripts/validate_animation_timeline.py --input <path/to/animation_timeline.json>，非零退出码视为阻塞性发现。输出契约包含：时间线映射（事件、状态、过渡与有序步骤）、验证发现（通过/失败检查及具体失败原因）、补丁计划（需调整的文件与动画处理器）、验证（命令输出与成功门槛）、残余风险（未解决的边界情况，如中断、链式、回退）。参考资料包括 references/workflow.md（事件到动画的设计流程）、references/contracts.md（必需的时间线与过渡契约）、references/signoff-template.md（发布交接模板）。
执行规则：保持动画排序确定且由状态驱动；每个步骤的时长与缓动必须显式；阻塞模糊过渡与孤立事件；在允许中断处确保取消路径显式。
限制：资料未提供具体平台、引擎版本、收费或价格信息；实际可用性取决于所依赖的脚本与参考文件是否存在。