SuperAPI AI 工具集

gameforge

编程与开发

查看项目

更新于 10-26 05:49

技能介绍

Gameforge 是一个游戏生成编排器(Orchestrator),负责驱动完整的游戏创建流水线。宿主智能体调用各个包含 LLM 的子技能,本技能则定义流水线形态、共享状态文件、验证关口与暂停条件。所有图像生成默认通过 GPT Image 2(gpt-image-2)以 quality: low 执行。

用途

适用于以下请求:

  • “帮我做一个……的游戏”
  • “生成一个叫……的 Phaser 游戏”
  • “修复上次运行中的 QA 失败”
  • 任何使用自然语言描述的 8-bit / 像素艺术 / 2D HTML5 游戏需求。

主要能力与流水线

流水线依次经过以下阶段:

  1. game-designer:将提示词转为 GDD JSON(含按类型自动选择的 style.palette)。
  2. world-architect:将 GDD 转为 levels.json(基于瓦片的关卡布局)。
  3. sprite-artist:将 GDD 实体转为精灵表与清单,默认使用 GPT Image 2 低质量。
  4. tile-artist:将 GDD 瓦片调色板转为 tiles.png 与瓦片元数据。
  5. bg-artist:生成视差背景图,对 top-down-adventure 和抽象解谜类型可跳过。
  6. audio-composer:根据类型预设生成 sfx.json、music.json 和 AudioManager.js,与美术阶段 3–5 并行运行。
  7. palette-enforcer:将所有生成的 PNG 量化为指定的 8-bit 调色板(如 pico8、sweetie-16、endesga-32)以保证视觉一致性。
  8. codesmith:将 GDD、关卡与清单转为 src/scenes/Game.js;当 state.audio 存在时导入 AudioManager 并在 create() 中调用 AudioManager.init(this)。
  9. manifest-auditor:在打开浏览器前,对照 manifest.json 交叉检查 Game.js 中每个动画/纹理键,将不匹配项交给 refiner。
  10. mobile-compat-checker --fix:自动修补 roundPixels: true 和 image-rendering: pixelated CSS,并标记触摸输入与音频解锁缺口。
  11. parallel-qa-orchestra:并发运行 4 个 worker(静态可达性、黄金路径、模糊测试、物理调试),合并为一份失败列表交给 refiner。
  12. VLM 意图门:宿主智能体将截图与原始描述对比审查,通过则交付,失败则进入 refiner(最多 3 次循环)。

阶段 3、4、5、6 可并行运行,阶段 7 为汇聚点(所有美术必须先完成),阶段 9 和 10 为快速 lint 检查(无需浏览器)。

使用方式

路径 A — 从描述创建新项目

  1. 询问项目名(或接受参数),运行 scripts/init_project.mjs <name> 脚手架。
  2. 调用 game-designer,将 GDD 保存到 game-state.json 并验证。
  3. 调用 world-architect,保存关卡并验证。
  4. 并行调用 sprite-artist(默认 GPT Image 2 低质量;--placeholder 可免费迭代)、tile-artist(通过 src/lib/sprites.js 的 generateTilesetGPT(),每个瓦片类型一次 GPT Image 2 调用,512×512 → 32×32;无 FAL_KEY 时自动回退为纯色)、bg-artist(generate_bg.mjs --theme <theme>,对 top-down-adventure 或抽象解谜跳过)。
  5. 从状态写入 public/assets/manifest.json 和 public/data/levels.json。
  6. 调用 codesmith,写入 src/scenes/Game.js(及可选辅助文件)。
  7. 调用 playtester;若失败则调用 refiner,最多循环 3 次。
  8. 报告最终状态:passed / failed / partial。通过后提示用户执行 cd <project> && npm run dev。

路径 B — 精修既有项目

  1. 读取 game-state.json 和最新 QA 报告(qa/qa-report.json)。
  2. 若 passed === true 则停止。
  3. 调用 refiner,应用编辑。
  4. 调用 playtester,循环至通过或 3 次迭代。

可选:多人联机

游戏生成并运行后,可通过 multiplayer 技能添加联机:

node skills/multiplayer/scripts/init_server.mjs <project-dir>   # Colyseus WebSocket 服务器
node skills/multiplayer/scripts/patch_game.mjs <project-dir>    # 修补 Game.js 以支持网络同步

# 可选附加:
node skills/multiplayer/scripts/init_server.mjs <project-dir> --voice   # PeerJS 语音/视频
node skills/multiplayer/scripts/init_server.mjs <project-dir> --lobby   # React 大厅前端

支持最多 4 名玩家,20 Hz tick 速率,TypeScript 共享 schema。详见 skills/multiplayer/SKILL.md。

共享状态 game-state.json

项目根目录下的唯一事实来源,每个子技能读写。Schema 包含 version、name、prompt、genre、createdAt、gdd、levels、assets(sprites 与 tiles)、code(entryPoint 与 scenes)、qa(最近 5 份报告)。每次变更后使用 scripts/validate_state.mjs <project-dir> 验证,拒绝破坏 schema 的修改。

项目布局(每个生成的游戏)

<project>/
├── game-state.json           # 共享状态
├── package.json              # phaser + vite
├── vite.config.mjs
├── index.html
├── public/
│   ├── assets/
│   │   ├── entities.png      # 来自 sprite-artist
│   │   ├── tiles.png         # 来自 tile-artist
│   │   └── manifest.json     # 每张表的行/列标签
│   └── data/
│       └── levels.json       # 来自 world-architect
└── src/
    ├── main.js               # Phaser 引导(模板,永不编辑)
    ├── config.js             # 游戏配置:pixelArt、FIT、RND 种子
    └── scenes/
        ├── Boot.js           # 模板,永不编辑
        ├── Preload.js        # 从清单构建动画,永不编辑
        └── Game.js           # codesmith 编写

Boot.js 和 Preload.js 在所有游戏中固定不变——它们读取 manifest.json,按 <ENTITY_ID>-<state>(状态小写)构建动画,并将关卡与清单存入 this.registry。codesmith 的 Game.js 仅按名称使用。

动画键约定

每个动画命名为 <ENTITY_ID>-<state-lowercase>,如 KNIGHT-walk、SLIME-hurt、BULLET-idle。帧索引 = row * cols + col,其中 row 是实体在表 rows[] 中的索引,col 是状态在表 cols[] 中的索引。codesmith 必须通过清单查找,不得硬编码。

暂停条件

  • 任一阶段 schema 验证失败 → 暂停并向用户展示验证错误,不循环。
  • 3 次 refiner 迭代未通过 → 暂停并展示失败,不静默标记完成。
  • 资产技能需要 GPT Image 2 但 FAL_KEY 和 OPENAI_API_KEY 均缺失 → 回退为程序化精灵/瓦片并跳过 bg-artist。
  • 用户取消(SIGINT)→ 以 130 退出。

参考与脚本

  • references/pipeline.md — 详细阶段接口与数据流
  • references/state-schema.md — 完整 JSON schema 与示例
  • references/phaser-cookbook.md — codesmith 必须遵循的 Phaser 3 模式
  • scripts/init_project.mjs <name> [--dir path] — 从 templates/phaser-game/ 脚手架
  • scripts/validate_state.mjs <project-dir> — schema 检查 + 不变量验证
  • scripts/run_pipeline.mjs <project-dir> — 调用完整流水线(宿主智能体驱动所有 LLM 子技能;无需单独 API 密钥)

限制

暂未提供关于收费、价格、平台支持范围或效果保证的明确信息。使用 GPT Image 2 生成资产需要相应 API 密钥,否则回退为程序化资源。