guizang-game-skill - 让 AI 编程助手按流程做出可玩的网页 3D 动作游戏
一个给 AI 编程助手用的 Skill:把「从零做一个浏览器 3D 动作游戏」拆成调研、素材、动作、手感、打包五个阶段,附踩坑清单与三种打包脚本。项目自述它只在一个完整项目上走通过一遍,不保证成品质量。
guizang-game-skill 是一个面向 AI 编程助手(如 Claude Code、Codex)的 Skill 包。据项目说明,装上它之后,只要对助手说一句「做一个武侠题材的俯视角 3D 动作游戏」,它就会按一套已经走通过的流程推进:先问清需求,接上使用者手头的素材生成工具,自己推进画面并截图核对,最后把游戏打包成一个网页文件。它面向的是想用 AI 做网页 3D 游戏、但缺少游戏开发经验的使用者——项目自述里,作者本人就表示自己不懂做游戏,只会说「动作很僵硬」「打击感很差」。
维护者与状态
仓库由 op7418 维护,创建于 2026-11-11,最后一次提交也在 2026-11-11。截至 2026-11-18,仓库星标数为 400。项目尚无正式 release,因此没有版本号可引用,使用者拿到的是 main 分支上的文档与脚本。
需要说明的是,项目自述明确写道:这个 Skill「目前只在一个项目上完整走过一遍」,另做过一次计划层面的对照测试。它能让方向少走弯路,但不保证成品质量。这一点应作为评估该项目成熟度的前提。
主要能力
以下能力均据项目自述整理:
- 开工前先问清楚:参考、视角、氛围、范围,以及使用者手头有哪些素材工具和多少额度。项目称它不会闷头写一个方块模型出来,而是先把使用者给的工具接上。
- 自测与核对:第一天就装好自测工具,包括逐帧推进画面、直达某一关的网址参数、F3 诊断面板;由 AI 自己截图核对,并区分「看过」与「只是没报错」。
- 战斗手感清单:出招前摇和后摇、命中顿帧、分级击退、格挡与弹反、敌人轮流进攻而非一拥而上、闪避能打断动作等,都写进了参考文档。
- 踩坑清单:方向键卡住、预设动画把角色甩离原地、泛光过曝、镜头被屋顶挡住、打包后角色缩小一半等,每条给出症状、原因和做法。
- 三种打包方式:单个 HTML 文件、先出画面再加载的静态站点、受限容器的离线包。
流程被拆成五个阶段:调研与规划 → 设定与素材 → 动作 → 手感与特效 → 声音与打包。仓库目录中,SKILL.md 记录整体流程与各阶段检查点,references/ 下按素材、角色与动画、战斗手感、特效界面与声音、踩坑、打包分文件,scripts/ 提供输入处理、本地服务器和三种打包脚本。
项目还附带一个演示游戏《雾锁山门》,用于展示这套流程的产出形态。据项目说明,该演示包含 5 个带骨骼的 3D 角色、2 把武器、12 种场景道具、5 种掉落物,战斗有三段连招、闪避、格挡、弹反、处决与 Boss 二阶段;原始素材将近 100MB,打包后是一个约 33MB 的 HTML。演示内容与 Skill 本身的许可不同,见下文。
使用入口
仓库地址:op7418/guizang-game-skill;项目主页:guizang-game-skill 官网。
据项目说明,最简单的安装方式是把仓库链接发给 AI 助手,让它自行安装;也可以手动克隆到助手的 skills 目录,例如 Claude Code:
git clone https://github.com/op7418/guizang-game-skill ~/.claude/skills/guizang-game-skill
Codex 等其它工具则克隆到各自的 skills 目录。安装后直接用自然语言描述需求即可,例如说明题材、视角、场景数量与可用的素材工具。
前置条件方面,项目列出 Node.js 18+ 为必需项,用于本地服务器和打包;Tripo 用于图片转 3D 模型与骨骼绑定,即梦或其它出图工具用于设定图、图标、题字与配音,Suno 用于配乐。后三者缺失时可改用免费模型、免费素材或程序生成的配乐,但项目自述画面会打折扣。
许可与限制
仓库许可证为 AGPL-3.0,覆盖 main 分支的文档与脚本。演示游戏《雾锁山门》的美术、模型、配音、配乐与文案位于 gh-pages 分支,据项目说明由作者保留所有权利,欢迎试玩和分享链接,但未经许可不得转载、改名再发布或商用。使用演示中的素材前需自行确认授权范围。
已知限制方面,项目自述强调它不是「一句话出成品」:作者在演示项目上试玩了 7 轮,每轮提 5 到 10 个问题,使用者仍需来回试玩并提意见。此外,Skill 只在一个完整项目上走通过一遍,成熟度有限;素材工具对最终效果影响很大,项目称早期直接用文字生成模型质量很差,改为「先出设定图,再转 3D」后效果明显提升。