SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场oil-motion

oil-motion

设计与创作

查看项目

更新于 10-16 15:22

技能介绍

用途

Oil Motion 用于把用户的交互意图转换为可验收的动画素材、时间轴清单和网页运行时。它适合需要将视频或序列帧编译为滚动、指针、拖动与状态驱动网页动效的场景。

主要能力

  • 将交互意图整理为 Concept Contract（概念合同），记录对象、视觉、交互和连续性要求。
  • 由合同派生 Motion Brief（动效简报），规划关键帧、片段和生产计划。
  • 自动选择交付格式与运行时控制器，输出 delivery.selected（baked-video、chroma-video、alpha-atlas）和 runtime.controller（frame-scrub、segment-playback、autonomous-playback）。
  • 支持多种驱动方式：scroll、pointer、drag、touch、orientation、audio、data、state、time。
  • 支持输入语义 continuous、step、event；时间控制 scrub、segment-play、autonomous；导航 continuous、paged、none。
  • 支持关键帧生成、逐段验收、帧准备与清理、编译时间轴、接入运行时和最终验收。
  • 包含本地媒体处理脚本和网页控制器，纯本地处理不需要 API Key。

使用方式

  1. 锁定用户意图：用户目标模糊时先读 references/concepts.md，给出最多三个真正不同的方向；明确时直接写 Concept Contract。需要外部案例启发时选读 references/motion-patterns.md。
  2. 建立生产计划：Motion Brief 只保存派生计划，不复制合同字段。
  3. 自动选择交付与运行时：在宿主允许运行工具的阶段，用 Brief 中的计划帧数、显示尺寸和参数空间运行 motion_budget.py --strict，显式传入合同中的 background_owner 和 time_control，保存 build/motion-budget.json。
  4. 制作关键帧：有角色或需要身份一致时先写 Identity Bible；生成并验收 K0…Kn。
  5. 先做 Pilot：批量生成前只完成第一组关键帧、第一段视频，并挂载到真实页面。
  6. 生成并逐段验收。
  7. 帧准备、清理与编译时间轴，编译后生成 build/timeline.json。
  8. 接入运行时：从 assets/interactive-motion.ts 的对应控制器开始实现；分步手势使用 assets/step-gesture.ts。
  9. 最终验收：按 references/qa.md 在目标 CSS 尺寸、DPR、冷缓存、快速反向、移动端和资源失败条件下验收。

运行参考命令前，将 OIL_MOTION 设为本次实际加载的技能目录：

OIL_MOTION="<本次 SKILL.md 所在绝对目录>"

适用场景

  • 网页滚动驱动动效。
  • 指针、拖动、触摸交互动效。
  • 状态或数据驱动动效。
  • 序列帧与视频编译为网页运行时。
  • 需要色键、Alpha 通道或透明输出的动效交付。
  • 需要时间轴清单和可复现处理命令的交付。

限制

  • 图片／视频生成交给宿主已有工具。此包不包含上游的生成服务、Keychain 或凭据配置页面，不要尝试调用它们。
  • 缺少生成、测量或导出能力时需说明具体缺口，交付可验证部分，不声称完成未执行的步骤。
  • 运行 Python 脚本前需检查 Python 3.10+、支持 -fps_mode 的 FFmpeg / ffprobe、Pillow、NumPy、PyYAML；缺少依赖时仅在任务隔离环境中按 scripts/requirements.txt 安装，不修改全局环境。
  • 检查、渲染和导出仅在宿主当前阶段允许且工具真实可用时执行；技能不能额外开启独立 Agent、强制审批或绕过宿主交付边界。
  • 规划阶段只规划，实现阶段才写代码。
  • 四个事实源每项信息只保存在一个位置，其他文件引用它，不复制。
  • 所有裁剪和拼接都要检查新产生的相邻帧；不得用一次远距离跳帧替代缓慢尾部变化。
  • 时间值必须由最终编译结果生成，不手工抄写。
  • 用户已说清的内容直接记录，不改写、不扩写。缺项会改变可生成性、可验收结果或生产路线时，必须先补齐。

随包运行文件

随会话冻结的文件包括：assets/chroma-video-renderer.ts、assets/interactive-motion.ts、assets/motion-explainer-template.html、assets/motion-manifest.example.json、assets/step-gesture.ts、references/alpha-atlas.md、references/baked-video.md、references/chroma-video.md、references/concepts.md、references/delivery-selection.md、references/explainer.md、references/motion-patterns.md、references/optimization.md、references/prompting.md、references/qa.md、references/runtime.md、scripts/chroma_key.py、scripts/compile_scroll_video.py、scripts/compose_travel_frames.py、scripts/composite_alpha_keyframe.py、scripts/create_explainer.py、scripts/loop_cleanup.py、scripts/media_edges.py、scripts/motion_budget.py、scripts/motion_pipeline.py、scripts/optimize_motion.py、scripts/production_gate.py、scripts/requirements.txt。

许可随包保留：references/license.md 随会话包保留来源许可。复制参考代码到交付工程时保留上游署名及许可文本。