Oil Motion
把 AI...
Install
npx skills add oil-oil/oil-motion --skill oil-motion -g -a claude-code -y- Repository
- oil-oil/oil-motion2.8k
- Category
- Design
- Updated
- 1mo ago
- License
- MIT
- Context cost
- Mediumabout 1,530 tokens
- Runs scripts
- No, instructions only
What it does
把 AI 生成或已有的视频、序列帧变成随滚动、指针、拖动、触摸、设备方向、音频、数据或状态变化的网页动画：设计动作方向，生成关键帧与视频，整理成图集或视频，编译时间轴并接入运行时。用户需要角色转向、产品拆解、镜头穿越、一镜到底转场，或要清理、抠色、补帧、压缩绿幕视频与雪碧图时使用。不用于纯 CSS、JS、SVG、Lottie 或实时 3D 就能完成的界面过渡与微交互（交给普通前端实现），也不用于独立成片剪辑、单张配图或静态页面。
Oil Motion
把用户的交互意图转换为可验收的动画素材、时间轴清单和网页运行时。AI 生成负责肢体、结构、材质、遮挡等语义变化；程序负责输入映射、播放控制、媒体处理和性能。
确定性流水线需要 Python 3.10+、Pillow、ffmpeg 和 ffprobe：
OIL_MOTION="<当前 SKILL.md 所在的绝对目录>"
python3 -m pip install -r "$OIL_MOTION/scripts/requirements.txt"
关键帧与视频默认通过 ZenMux 生成，模型写在 image_job.py 与 video_job.py 中；只有模型无法完成目标或用户明确指定时才更换。已有视频或序列帧时从分析开始，不调用生成服务。
首次配置
第一次调用生成服务前检查凭据；纯本地处理不需要 Key：
node "$OIL_MOTION/scripts/credential-ui/src/profile.ts" status default
node "$OIL_MOTION/scripts/credential-ui/src/profile.ts" setup default
退出码 0 直接继续；2 表示缺失，此时运行 setup 并把返回的本机链接交给用户亲自填写。所有生成命令都通过 profile.ts run default -- 执行。依赖安装、退出码含义和安全边界见 references/api-key-setup.md。
四个唯一事实源
每项信息只保存在一个位置，其他文件引用它，不复制：
source/concept-contract.yaml：用户明确要求的对象、视觉、交互和连续性。source/motion-brief.yaml：由合同派生的关键帧、片段和生产计划。build/timeline.json：成片的实际帧率、段落边界、停帧和播放曲线。build/motion-budget.json：交付格式与运行时控制器的自动选择结果。
主流程
1. 锁定用户意图
用户只有模糊目标时，先读 references/concepts.md，给出最多三个真正不同的方向；要求已经明确时直接写 Concept Contract。
需要外部案例启发时，按表达目的选读 references/motion-patterns.md。先分清哪些变化属于素材本身、哪些只是容器编排或 UI 状态，只有前者进入生成流程。
subject_count: <number>
subjects:
- identity: <可验证的身份或外观锚点>
style: <用户原词>
motion_intent: <动作及视觉结果>
background_owner: video | page
scene: <背景属于视频时的场景、镜头和光线要求>
driver: scroll | pointer | drag | touch | orientation | audio | data | state | time
input_semantics: continuous | step | event
time_control: scrub | segment-play | autonomous
navigation: continuous | paged | none
clip_continuity: chain | independent
continuity: [<必须保持不变或连续的内容>]
aspect_ratio: 16:9 | 9:16 | 1:1 | 21:9 | custom
destination: <页面位置、最大显示尺寸和目标设备>
判断规则：
