安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install build-game-plus
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 build-game-plus。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Build Game Plus 是 Openclaw Skills 的游戏开发工作流，可根据自然语言请求创建并迭代开发可玩的浏览器游戏。它会根据游戏类型在 2D Canvas 和 3D Three.js 之间进行选择，然后构建一个独立的 index.html，其中包含清晰的操作说明、可实现的游戏目标，以及适合该游戏体验的系统。
它的核心特点是交付前验证机制：该技能会在无头 Chrome 中运行游戏，截取标题画面和游戏画面，检查渲染像素和控制台错误，并引导代理修复问题后重新测试。项目保存在持久化的 ~/games/ 工作区中，并通过进度记录支持后续会话。Openclaw Skills 用户可以在本地预览游戏，也可以在收到请求时将游戏发布到配置的公共域名。

应用场景

将自然语言提示转化为可玩的街机游戏、平台游戏、益智游戏、战术游戏、射击游戏或 3D 冒险游戏。
为现有游戏添加新实体、Boss、机制、视觉效果变化或游戏系统。
为创意选择合适的引擎：适合的类型使用 2D Canvas，3D 深度至关重要时使用 Three.js。
在将游戏作为可运行作品展示前，发现空白、黑屏、未渲染或报错的构建结果。
在持久化工作区中跨会话保留游戏项目和迭代记录。
按用户要求运行本地预览，或将游戏发布到永久公共 URL。

工作原理

检查现有游戏目录及其 progress.md 文件，判断请求是创建新游戏还是迭代现有游戏。
从请求中提取游戏类型、核心机制、视觉概念、范围以及提供的参考资料。
明确选择 2D Canvas 或 3D Three.js，然后参考相关引擎、图形、资源、UI、音频和游戏系统模式。
设计游戏循环、实体、系统、HUD、游戏流程以及胜负条件。
在 ~/games// 中生成单个 index.html，并包含 window.render_game_to_text() 和 window.advanceTime(ms) 调试钩子。
在无头 Chrome 中运行 verify_game.py 并模拟输入。检查截图、像素分析结果以及 .verify/report.json 中的控制台错误。
如果验证失败，修复报告指出的问题并重新运行检查，最多尝试修复三次；如仍有失败，必须如实说明。
更新 progress.md，记录游戏当前状态、迭代历史、系统、验证结果、已知问题和建议的后续步骤。
仅在收到请求时，可选择启动本地预览或将游戏发布到配置的公共 URL。

配置指南

该技能需要 python3。游戏项目默认存放在持久化的 ~/games/ 目录中。使用该技能附带的脚本验证、预览或发布游戏。将 替换为游戏的目录名称。

验证游戏并截取菜单和游戏画面

python3 "$SKILL_DIR/scripts/verify_game.py" "$GAMES_DIR//index.html" --out "$GAMES_DIR//.verify" --click

在后台启动本地预览

bash "$SKILL_DIR/scripts/serve.sh" "$GAMES_DIR/" &

仅在收到请求时发布到配置的公共域名

bash "$SKILL_DIR/scripts/publish.sh" "$GAMES_DIR/"
在报告游戏可运行之前，请检查 $GAMES_DIR//.verify/report.json 和生成的截图。成功发布后会使用配置的 https://jerithai.com/games// URL。无需单独的游戏构建步骤：Canvas2D 无需导入，而 Three.js 使用指定的 CDN import map。

数据架构

每个游戏项目都使用一个持久化目录：
路径 用途
~/games//index.html 独立的可玩游戏实现。
~/games//progress.md 供后续会话使用的项目背景和迭代记录。
~/games//.verify/report.json 自动验证结果，包括判定和报告的问题。
~/games//.verify/menu.png 标题画面或菜单画面的截图证据。
~/games//.verify/gameplay.png 游戏画面的截图证据。
progress.md 会记录游戏标题、slug、引擎（2d-canvas 或 three-160）、更新日期、原始请求、当前状态、迭代历史、实体列表、启用的系统、验证状态、已知问题和建议的后续步骤。游戏文件按常量、数据、状态、资源工厂、系统、渲染和主循环组织。验证会检查平均亮度、亮度变化、空白白色输出和控制台错误；报告和截图则为 PASS 或 FAIL 判定提供证据。

高级特性

自动视觉验证：
使用 SwiftShader 在无头 Chrome 中运行游戏，截取菜单和游戏画面，模拟点击，并检查像素统计数据和控制台错误。
基于失败的迭代：
report.json
定位问题，然后要求重新测试；尝试修复三次后，必须如实报告仍未解决的问题。
按游戏类型选择引擎：
许多街机、益智、策略和平台游戏使用 2D Canvas；对于 3D 空间和摄像机控制至关重要的体验，则使用 Three.js。
可检查的确定性状态：
要求提供
window.render_game_to_text()
window.advanceTime(ms)
钩子，以便检查游戏状态并以可预测的方式推进游戏。
持久化项目记忆：
将游戏存放在
/tmp
之外，并在
progress.md
中记录当前状态、系统、验证结果和后续步骤。
针对不同游戏类型的技术模式：
支持程序化 Canvas2D 资源和 Three.js 渲染实践，并提供可复用的图形、UI、音频和游戏系统指导。
可选托管工作流：
通过配置的 nginx 和 Cloudflare 隧道提供本地服务和永久发布功能；发布并非默认操作，只应在收到请求时进行。
如实说明能力边界：
不声称支持尚不具备的多人游戏功能，也不虚构排行榜等不存在的后端功能。

name: build-game-plus description: >- Build playable browser games (2D canvas or 3D Three.js) from natural language,
with an automated screenshot verification loop the agent runs before claiming
the game works — no unverifiable "should look fine" claims. Persists games in
a stable workspace (games//, not /tmp), iterates via targeted edits,
publishes to https://jerithai.com/games// via the existing nginx +
Cloudflare tunnel. Reuses the full 3D pattern library from the original
build-game skill and adds 2D canvas, genre-appropriate engine choice, and
verify-before-deliver as a hard gate.
argument-hint: [game description or modification]