mcpField
R
record-promo

record-promo

github.com/playableintelligence营销与增长350847 次安装22 周前更新
代码仓库

关于 record-promo

record-promo 是一项技能，可自动录制并转换 Phaser 游戏画面，生成宣传视频。它指导环境检查、编写适配游戏的录制脚本及预览验证。

主要功能

  1. 01检查开发服务器和录制依赖
  2. 02生成适配游戏的 Playwright 录制脚本
  3. 03屏蔽失败路径并模拟游戏操作
  4. 04使用 FFmpeg 将录制转换为 MP4
  5. 05生成并预览缩略图

适用场景

  1. 01录制用于社交媒体的游戏片段
  2. 02无需手动操作即可重复采集游戏画面

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/playableintelligence/game-creator --skill record-promo

安装后在 Claude Code 中输入/record-promo确认已加载。

详细介绍

录制宣传视频

自动录制流畅、高帧率的 Phaser 游戏画面，适用于 TikTok、Reels、Moltbook 或 X。录制期间无需人工输入。

说明

为 $ARGUMENTS 指定的游戏录制宣传视频（若未指定路径，则使用当前目录）。

1. 前置检查

确认以下项目均可用：

  • 开发服务器：检查是否已有服务器在运行（curl -s http://localhost:3000/）。如果没有，则在后台运行 npm run dev。记下端口。
  • Playwright：运行 npx playwright --version。如果未安装：npm install -D @playwright/test && npx playwright install chromium
  • FFmpeg：运行 ffmpeg -version | head -1。如果找不到，请告知用户安装（macOS 上运行 brew install ffmpeg），然后停止。
2. 生成录制脚本

加载 promo-video 技能，查看完整的技术参考。

阅读游戏源文件以了解：

  • src/scenes/GameScene.js — 找到死亡／失败方法，以便屏蔽
  • src/core/EventBus.js — 事件流
  • src/core/Constants.js — 输入按键、游戏尺寸
  • src/main.js — 确认已暴露 __GAME__ 和 __GAME_STATE__ 全局变量

创建适用于此游戏的 scripts/capture-promo.mjs：

  • 屏蔽所有死亡／失败代码路径
  • 根据游戏实际操作生成输入序列
  • 包含入场动画暂停（1-2s）
  • 默认视口：1080 × 1920（9:16 手机竖屏）
  • 默认时长：13s 游戏时间
3. 复制转换脚本
cp <plugin-root>/skills/promo-video/scripts/convert-highfps.sh <project-dir>/scripts/
chmod +x <project-dir>/scripts/convert-highfps.sh
4. 运行录制
mkdir -p output
node scripts/capture-promo.mjs --port <port>
bash scripts/convert-highfps.sh output/promo-raw.webm output/promo.mp4 0.5
5. 验证并预览

截取 5 秒处的缩略图并展示给用户：

ffmpeg -y -ss 5 -i output/promo.mp4 -frames:v 1 -update 1 output/promo-thumbnail.jpg

读取缩略图并显示。报告时长、帧率和文件大小。

使用示例

/record-promo examples/flappy-bird

结果：屏蔽死亡逻辑 → 根据游戏操作生成输入序列 → 以 1080x1920（9:16）录制 13s 的自动游戏画面 → 转换为 50 FPS MP4 → 生成可直接发布到 TikTok/Reels 的 output/promo.mp4。

告知用户：

宣传视频已录制！50 FPS，手机竖屏（1080×1920）。

文件：output/promo.mp4

将视频发布到 TikTok、Reels 或 X，为你的游戏引流。

评论

支持 Markdown