Communitygithub.com

animate-slides

项目专用工作流,将有序的幻灯片帧文件夹转化为2D代码绘制的画布,并利用motion-reel技能生成帧与帧之间的动画过渡视频。当用户调用`/animate-slides`或要求为现有幻灯片帧创建运动过渡时使用。

animate-slides 是什么?

animate-slides 是一个高度专业化的AI代理技能,专为“动态演示工作室”(Motion Presentation Studio)工作流而设计。其主要功能是将用户提供的一系列有序关键帧图像(例如演示幻灯片)忠实地转化为2D代码绘制的画布,并自动为每一对连续帧(第i帧 → 第i+1帧)编排流畅、富有表现力的运动过渡视频。该技能通过紧密集成motion-reel子系统来实现,强调视觉保真度:输出的图像和视频必须与原始幻灯片布局完全对齐,同时保持过渡编排的创造性自由。与从零开始创作的`/new-motion-presentation`不同,animate-slides严格限定于用户已拥有预渲染幻灯片图像的场景,其核心是忠实的视觉再现。工作流程包括严格的帧序列验证、逐帧视觉分解、模块化2D Canvas代码构建(针对每帧),以及生成多段过渡视频,确保在运动开始和结束时视觉状态完美匹配。输出采用Motion Presentation Studio的可Drag-and-Drop格式,包括有序PNG、H.264 MP4视频和一个JSON清单文件。该技能支持各种分辨率,默认生成无音视频,仅在用户明确要求时添加音轨。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Mohamed-Sukar/Motion-Presentation/tree/main/.agents/skills/animate-slides

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

幻灯片动画 (/animate-slides)

将用户提供的一系列关键帧图像转化为忠实的2D代码绘制,并为每一对连续帧 (第i帧 -> 第i+1帧) 编排流畅、富有表现力的运动过渡视频(使用 motion-reel 技能),为Motion Presentation Studio做好准备。

适用范围 vs /new-motion-presentation:

  • 当用户已经拥有预制的演示幻灯片图像(01.png, 02.png, ...)并且希望模型在视觉上忠实于原始幻灯片布局,同时生成它们之间的动态过渡时,使用 /animate-slides。
  • 当从零开始(根据主题、大纲或产品URL)创作演示文稿,拥有高度创作自由并需要生成“静止姿态空闲运动循环”(XX_loop.mp4)时,使用 /new-motion-presentation。

创作自主权: 忠实于用户帧的视觉外观和确切的帧顺序,同时对过渡编排、节奏和时序保持完全的创作自由,除非用户指定了约束。转换默认无音频(静音),除非用户明确要求添加声音。


1. 等待并验证帧序列(强制性入口)

  1. 等待帧路径: 如果用户在调用 /animate-slides 时没有提供帧文件夹(或图像文件)的路径,请询问帧路径并停止。不要猜测路径或编造帧。

  2. 检查并验证数字排序: 一旦提供了路径,从工作区根目录运行检查辅助脚本:

    node ".agents/skills/animate-slides/scripts/inspect_frames.mjs" "<frames_path>"
    

    每个帧文件名必须包含一个明确的排序数字(例如,01_intro.png, frame_2.png, 03-architecture.png)。

  3. 澄清关卡 —— 如果 needsClarification 为 true,则停止并向用户询问: 如果出现以下任何情况,请不要猜测或回退到字母顺序:

    • 任何帧文件名没有排序数字(UNNUMBERED_FRAMES)。
    • 文件名中的多个数字导致序列顺序不明确(AMBIGUOUS_FRAME_NUMBERS)。
    • 两个或更多帧解析为相同的排序数字(DUPLICATE_ORDER_NUMBERS)。
    • 路径不存在、不包含支持的图像或包含少于2个帧(PATH_NOT_FOUND, NO_FRAMES_FOUND, FEWER_THAN_TWO_FRAMES)。

    列出检测到的文件和具体的不明确之处,然后等待用户的澄清后再继续。 (如果 warnings 提到 IRREGULAR_NUMBER_GAPS 或 MIXED_DIMENSIONS,仅在看起来非预期时才与用户确认。)


2. 读取并解构每一帧

  1. 在搭建或渲染之前阅读 motion-reel 技能说明:
    • C:\Users\Mohamed\.gemini\config\plugins\motion-reel\skills\motion-reel\SKILL.md
  2. 按顺序(1 .. N)直接检查每个有序帧图像(read_file)。
  3. 对于每帧,分解其视觉结构以便能用代码绘制:
    • 画布与调色板: 背景色调/渐变、卡片表面、边框、强调色、精确的十六进制值。
    • 排版与文案: 字体系列/权重/层级、确切文本(阿拉伯语/英语,RTL/LTR对齐)。将所需字体文件复制/打包到 fonts/,并验证非拉丁字形能干净渲染,不会出现损坏的 fallback 字体。
    • 2D几何与组件: 卡片、徽章、图表、图标、连接器、分隔线、药丸状指示器、进度指示器和几何图案。
    • 光栅元素(仅在真正需要时): 如果帧嵌入了不应以矢量路径近似的真实摄影或复杂品牌艺术作品,请将实际资源保存/引用到 assets/ 中,并将其与2D代码绘制图层干净地合成。
  4. 映射逐对关系(第1帧 -> 第2帧,第2帧 -> 第3帧,...):
    • 识别可以在剪辑过程中变形、移动、调整大小或重新锚定的持久/共享元素。
    • 识别退出和进入的图层,使移动感觉有动机而非平淡的交叉淡入淡出。

3. 通过 /motion-reel 构建2D代码绘制与运动过渡

遵循 motion-reel 的核心架构(window.seek(t) 纯时间函数,仅使用种子噪声,闭式弹簧 springU/springKeys,kf,E.*,layout/glyph,运动模糊和批评循环):

  1. 每帧的模块化2D代码绘制:

    • 将每帧(第1帧 .. 第N帧)表示为一个可重用的2D Canvas 绘图模块/函数(其中图层和元素可以参数化以控制偏移、缩放、不透明度、裁剪、变形进度、描边绘制等)。
    • 在过渡 (k-1 -> k) 的结束和过渡 (k -> k+1) 的开始之间共享完全相同的 第k帧 代码定义,确保演示文稿的无缝连续性。
  2. 连续帧之间的过渡影片(N - 1 个过渡):

    • 清晰地搭建或结构化每个过渡(例如,放在专用工作区文件夹中,如 reels/<project-slug>/t01-02/, t02-03/, ...,从而保持 app/src/ 不变)。
    • 边界连续性契约:
      • 在 t = 0 时: 渲染的画布必须忠实地匹配第 i 帧(相同的构图、颜色、排版和几何形状——无空白导入、无从黑场淡入、无突然弹出)。
      • 在 0 < t < duration 期间: 编排富有表现力、有目的性的2D运动(元素交接、形状变形、错开弹簧、定向擦拭/裁剪、对数空间中的摄像机推拉、重叠时序)。
      • 在 t = duration 时: 渲染的画布必须干净地稳定在第 i+1 帧上,零漂移。
    • 音频策略(默认静音)与节拍网格:
      • 默认——无音频(--video-only): 除非用户明确要求声音/SFX/音乐,否则生成静音过渡视频(render.mjs --film <film> --format <f> --video-only,输出无音轨的 H.264 .mp4)。不要生成 music.wav、sfx.wav 或运行 mix.mjs。
      • render.mjs 和 motion.js 仍然需要 <film>/beats.json(offset,period,beats 数组)用于节拍定时和 --contact 表;对于静音过渡,编写一个与您过渡节奏匹配的干净 beats.json 网格(例如,120 BPM -> period: 0.5)。
      • 当用户明确要求声音时: 使用 motion-reel 的音频管线(beats.py / score.py,sfx.mjs,mix.mjs)并将其混流到最终的 .mp4 中。
    • 格式与分辨率:
      • 匹配来自 inspect_frames.mjs 的 detectedFormat(宽屏1920x1080幻灯片为 16x9,竖屏为 9x16,正方形为 1x1)。如果帧使用非标准的16:9尺寸(例如1280x720),则在1920x1080的画布空间中按比例绘制。
  3. 视觉验证(交付前检查):

    • 对于每个过渡视频,检查:
      • 第一帧(--at 0)与输入的第 i 帧
      • 过渡中段截图(--strip 0:<duration>:8)以验证运动弧线、模糊、重叠和无空白帧
      • 最后一帧(--at <duration>)与输入的第 i+1 帧
    • 迭代直到每个端点干净对齐,并且每个过渡看起来有意图、清晰且充满动感。

4. 交付,为 Motion Presentation Studio 做好准备

将最终的演示资产导出到一个干净的输出文件夹(例如,out/<project-slug>/presentation/ 或用户指定的目录),使用 Motion Presentation 的 SmartPairer 能通过拖放自动配对的文件名:

  • 幻灯片(有序PNG):01_frame.png, 02_frame.png, ..., 0N_frame.png(匹配精确的开始/结束视觉状态)
  • 过渡视频(H.264 yuv420p,60 帧/秒 .mp4):01-02_transition.mp4, 02-03_transition.mp4, ..., 0(N-1)-0N_transition.mp4
  • 原生 presentation.json 清单(用于 Motion Presentation Studio 的手术式AI编辑提示构建器):
    {
      "skill": "animate-slides",
      "title": "<演示标题>",
      "aspectRatio": "16:9",
      "projectRootPath": "<reels/<project-slug> 的绝对路径>",
      "outputDirPath": "<输出文件夹的绝对路径>",
      "slides": [
        {
          "index": 1,
          "title": "幻灯片 1",
          "frameFile": "01_frame.png",
          "transitionVideoFile": "01-02_transition.mp4",
          "slideCodeFile": "scenes/slide_01.js",
          "transitionCodeFile": "t01-02/film.js"
        }
      ]
    }
    

使用 ffprobe 验证每个最终的 .mp4(持续时间,60 帧/秒,yuv420p,默认无音轨,除非明确要求声音),并向用户报告输出文件夹路径和所有生成的过渡摘要。

相关技能