是什么

这个仓库提供一个技能,教编程智能体把一段 10 到 15 秒的玩法视频重建成能在浏览器里玩的游戏,支持 Claude Code、Codex、Cursor、Gemini 等智能体。视频模型先定下画面、镜头和一个让人记住的机制,智能体逐帧研究片段,用 fal 生成图片、3D 模型与音效音乐,再用 Three.js 写出游戏。每款成品都是单个只含 Three.js 的 index.html,智能体用键盘试玩并录下最精彩的几秒作为证明。[1]

能做游戏开发的哪一步

  • 脚本 study_video.py 把视频转成帧图、拼图、色板和剪辑时间点,智能体再照着具名帧写出镜头、主角、机制、关键瞬间和画面规格。[1]
  • 脚本 fal_asset.py 从视频自身的帧生成概念图、干净抠图、3D 模型、绑定与动画、音效和音乐,并记录每次调用。[1]
  • 脚本 side_by_side.py 在每次改动后,把视频和游戏在同样三个位置做成左右对比图。[1]
  • 脚本 record_play.mjs 以真实帧率录制键盘试玩,best_window.py 找出最有活力的几秒。[1]

怎么装、怎么跑(按 README 原文)

  1. 在 Claude Code 里添加插件市场。
    claude plugin marketplace add lovisdotio/video-to-game
    [1]
  2. 从该市场安装 video-to-game 插件。
    claude plugin install video-to-game@video-to-game
    [1]
  3. 或者直接复制技能目录到 Claude 的技能文件夹。
    cp -R skills/video-to-game ~/.claude/skills/
    [1]
  4. Codex、Cursor、Gemini CLI、Copilot 等智能体通过 skills 添加这个技能。
    npx skills add lovisdotio/video-to-game
    [1]
  5. 或者把 skills/video-to-game 复制到所用智能体的技能文件夹,Codex 为 ~/.agents/skills/,Cursor 为 ~/.cursor/skills/。[1]

需要什么环境

  • 脚本需要 Python 3.9+ 和 ffmpeg。[1]
  • 录制需要 Node 18+,并装有 playwright-core。[1]
  • 生成素材需要执行 pip install fal-client,并准备 FAL_KEY(fal.ai/dashboard/keys)。[1]

限制和要注意的

  • 每款游戏是一个只含 Three.js 的 index.html,不使用引擎、模板或其他库。[1]
  • 素材全部由 fal 从视频自身的帧生成,不手绘,也不下载现成素材。[1]
  • 游戏画面上不出现文字。[1]

许可证

MIT。具体允许做什么以许可证原文为准。

来源

  1. lovisdotio/video-to-game/README.md收录于 2026-11-14