op7418/guizang-game-skill

项目介绍

这是一个给 Claude Code、Codex 等 AI 编程助手用的 Skill 包。它不让 AI 从零瞎猜，而是按一条走通过的五阶段流程推进：调研与规划、设定与素材、动作、手感与特效、声音与打包。AI 会先问清参考、视角、氛围和范围，接上你手头的素材生成工具，用截图自行核对画面，最后把游戏打包成一个网页文件。

仓库附带可玩演示《雾锁山门》：仙侠题材俯视角 3D 动作游戏，一个场景、一波小怪、一场二阶段 Boss 战，含三段连招、闪避、格挡、弹反、处决与配音配乐。参考文档覆盖素材生成、角色骨骼与动画、战斗手感、特效界面与声音、踩坑清单和打包；脚本目录提供输入处理、本地服务器和三种打包方式的可复用代码。

适合愿意和 AI 反复试玩打磨、并且能提供或替代一部分素材工具的人。它不适合被当作一句话出成品的工具。

快速使用

前提：Node.js 18+ 用于本地服务器和打包。素材工具可选但明显影响效果：Tripo 做图转模型和骨骼绑定，即梦等工具出设定图和配音，Suno 出配乐；没有时 Skill 会退回到免费素材和程序化几何体。

1. 把 Skill 装到助手对应的 skills 目录：

git clone https://github.com/op7418/guizang-game-skill ~/.claude/skills/guizang-game-skill

Codex 等其它工具克隆到各自的 skills 目录。 2. 直接提需求，例如：「做一个武侠题材的俯视角网页 3D 动作游戏，一个场景、一波小怪、一个 Boss。我有 Tripo 和即梦可以用。」 3. 按阶段推进：调研与规划 → 设定与素材 → 动作 → 手感与特效 → 声音与打包。AI 应主动追问、接入你的素材工具，并在打包前截图核对。

想先看目标效果，可直接在电脑或手机浏览器打开在线演示，无需安装。

使用约束

这套 Skill 只在一个项目上完整跑过一遍，另做过一次计划层面的对照测试。它能减少方向性弯路，但不保证成品质量。作者描述《雾锁山门》试玩了 7 轮、每轮提 5 到 10 个问题，你需要持续反馈；说不清具体问题（比如「动作很僵硬」）时，要依赖 AI 把模糊描述翻成具体改动。

效果高度依赖素材工具链。作者的经验是直接用文字生成模型质量很差，先出设定图再转 3D 会好很多。Node.js 18+ 是本地服务和打包的硬性条件。Skill 文档与脚本采用 AGPL-3.0；演示游戏中位于 gh-pages 分支的美术、模型、配音、配乐和文案保留所有权利，欢迎试玩和分享链接，未经许可不得转载、改名再发布或商用。

HotRepo 点评

2026-11-12，项目进入 JavaScript 新项目榜，约 14 小时内新增 109 Star、14 Fork，与当日采集到的 109 Star 总数一致。对一个 Skill 包来说，这是很强的首日表现，这类项目通常靠作者影响力扩散，而不是被当作代码库复用。

它的价值在流程文档和演示本身，而不是运行时库：可以先玩在线演示判断目标效果，再对照战斗手感、踩坑清单和打包等参考文件看具体做法。作者自己说明只完整跑过一个项目加一次计划层面测试，这为 Skill 的可推广程度给出了比较实际的预期。