Communitygithub.com

MotionCraft — 矢量动画视频制作技能

将一句话创意转化为代码驱动的动画解说视频和Shorts,支持16种影视级视觉类别(9:16竖屏和16:9横屏,时长15秒至10分钟),生成含剧情脚本、独立HTML文件、源码包和MP4视频的完整交付物。

MotionCraft — 矢量动画视频制作技能 是什么?

MotionCraft 是一个面向开发者和AI代理的通用技能,专为将简单创意转化为高质量动画解说视频和Shorts而设计。它完全无需外部应用依赖,仅需一个文本创意即可生成完整的动画制作管线:首先从16种官方视觉类别(包括3D、等距视图、房屋拆解、3D棍棒人、天文学、动物世界、海洋、科学与自然、历史、地图、伊斯兰文化、地理、解剖学、民间传说、卡通和2D动画)中推荐最匹配的视觉方向,并自动编写从'钩子'到多个场景的分步脚本。随后,技能生成一个独立的HTML文件,支持9:16和16:9屏幕比例切换,内置WebAudio音效和自动循环播放。此外,它还打包完整的源代码ZIP档案,并可选地通过Headless浏览器渲染为H.264编码的MP4视频。该技能严格遵循'黄金标准'代码示例,确保场景中的物体密度、纹理细节、光照效果和摄像机运动与专业工作室出品保持一致。它特别适用于教育类Shorts、产品解说、历史地理动画、科学模拟或任何需要快速原型化和交付的动画视频场景。支持的开发工具包括Claude Code、Cursor、Codex等任何可通过Node.js和Chromium执行任务的AI代理。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

在你喜欢的 AI 中提问

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

文档

MotionCraft — 通用技能:解说视频与16类Shorts制作

独立技能(零应用依赖),将一句话创意故事转化为:视觉方向建议、分步剧本(开篇钩子 → 场景1 → 场景2 → ... 最长10分钟)、独立 <slug>.html 文件(双击即可在浏览器中运行,内置9:16 ↔ 16:9比例切换按钮和WebAudio音效)、源代码包 <slug>-source.zip 以及 MP4视频渲染。


必遵工作流程(5步)

第1步 — 视觉建议与剧本规划(开篇钩子 → 场景1..N)

当用户提供一个故事创意时(如果未指定比例或时长,默认使用9:16竖屏 30–45秒 用于短篇事实,或16:9横屏 60–600秒 用于深入讨论):

  1. 从16个官方类别中选择最匹配的1个: 3D · 等距视图 · 房屋拆解 · 3D棍棒人 · 天文学 · 动物世界 · 海洋 · 科学与自然 · 历史 · 地图 · 伊斯兰 · 地理 · 解剖学 · 民间传说 · 卡通 · 2D动画。
  2. 制定具体的视觉建议:
    • 物体与道具(objects):有纹理/关节的主要主体 + 至少3个用于尺度/证据比较的道具。
    • 摄像机与转场(camera):多镜头模式(远景 → 特写细节 → 环绕 / 快速摇摄 / 拉远)。
    • 氛围与光照(atmosphere):天空/空间氛围、雾气/体积光、调色板以及叙事基调。
  3. 编写分步剧本(0 到 最终时长 秒,无空白间隙):
    • 第一部分必须是 开篇钩子(3–10秒,激发好奇心的开场)。
    • 接着是 场景1、场景2 等,并以一个强有力的事实性结论收尾(约2.2字/秒)。
    • 对于长视频(>60秒至600秒/10分钟),请阅读 10分钟长视频指南。

第2步 — 阅读类别食谱与黄金标准代码示例(必须!)

不要凭猜测编写 sceneCode! 在编写动画代码之前:

  1. 阅读 16类别目录 中的类别表格和 style ID,以及 引擎v4 API参考 (MF) 中的运行时函数列表。
  2. 阅读最相关的官方源代码示例 黄金标准代码参考。
  3. 质量等同法则: 物体密度、纹理细节(CanvasTexture / 多层SVG / world-atlas 海岸线 / GLSL着色器)、光照和摄像机流畅度必须与 golden-showcases.md 中的示例等同。禁止绘制无纹理或道具的纯色方块/圆形!

第3步 — sceneCode 编写黄金规则

sceneCode 作为 (MF, stage, tl, W, H, DUR) 的函数体执行:

  • 双响应式(9:16 竖屏 & 16:9 横屏): 始终使用 W 和 H 的比例(W * 0.5、H * 0.45、size: W < H ? 50 : 56、labelX: W < H ? W * 0.08 : W * 0.54),确保动画在 1080×1920 和 1920×1080 下均完整显示且不被裁剪。
  • 不要覆盖变量 H: 切勿编写 const { H } = MF;,因为这会覆盖舞台高度 H!始终通过 MF. 前缀调用(MF.H、MF.S、MF.T)。
  • 100% 确定性: 禁止使用 Math.random()、Date.now()、setTimeout 或 setInterval。请使用 MF.rng('固定种子')、tl 上的时间线动画,以及 MF.onTick((t) => ...) 作为时间 t 的纯函数。
  • 第0帧立即活跃: 舞台元素和 开篇钩子 的开场标题必须使用 at: 0,以确保第一帧不为空或黑屏。
  • 反PPT风格: 同一时间最多显示1个标题(MF.highlightHeadline)+ 1个标注/数字(MF.leaderCallout / MF.bigStat)。故事必须由世界/物体的动态变化和摄像机运动驱动,而非一堆文字卡片!

第4步 — 构建独立文件(.html、-source.zip、-naskah.md)

创建JSON规格文件(例如 spec.json):

{
  "title": "视频标题",
  "idea": "用户原始故事创意",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objects": "...",
    "camera": "...",
    "atmosphere": "..."
  },
  "scenes": [
    { "label": "开篇钩子", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "场景1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

然后运行独立构建脚本(纯原生Node.js,零 npm 依赖!):

node "<技能路径>/scripts/build.mjs" --spec path/to/spec.json --out-dir path/to/output

该脚本会验证 sceneCode 的语法和确定性,嵌入 ./assets/motion-engine.js、./assets/sfx-synth.mjs 以及 ./assets/land-110m.json(如果使用地图),然后生成:

  1. <slug>.html — 一个独立文件,可在任何浏览器中观看(自动循环 + 进度条 + 9:16 ↔ 16:9 切换按钮 + WebAudio音效)。
  2. <slug>-source.zip — 完整源代码归档(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。
  3. <slug>-naskah.md — 包含剧本和视觉建议的文档。

无Shell/Web聊天的回退方案: 如果代理环境没有Node.js终端访问权限,请直接复制 ./assets/starter-template.html 的内容,替换其中的 /*__MOTION_ENGINE__*/、/*__SFX_SYNTH__*/ 和 /*__PROJECT_JSON__*/ null 占位符,以生成完整的 index.html 文件。

第5步 — 帧验证与MP4视频导出(可选/当Headless浏览器可用时)

如果环境中有Chrome/Edge和 puppeteer-core(或 puppeteer),可运行自动验证以确保 0 个运行时错误,并检查截图结果:

# 快速验证(检查0错误并保存开篇钩子和中间帧截图):
node "<技能路径>/scripts/export-mp4.mjs" --html path/to/output/<slug>.html --verify-only

# 完整渲染为MP4视频(H.264 + AAC音效自动生成,可选带上 --vo narration.mp3):
node "<技能路径>/scripts/export-mp4.mjs" --html path/to/output/<slug>.html --fps 30 --scale 1

如果验证截图中发现错误或文字重叠,请修正 sceneCode,使用 scripts/build.mjs 重新构建,然后将结果提交给用户。

相关技能