Skip to content
Back to search

guizang-game-skill

SkillWorks with Claude CodeGitHub

用 AI 生成素材(Tripo 等 3D 模型、即梦等图片与配音、Suno 等配乐)加 three.js,做一个能在浏览器里跑、最后打包成单个 HTML 的 3D 动作游戏的完整流程和踩坑清单。只要用户想做网页 3D 游戏、WebGL 游戏、three.js 游戏、俯视角或魂类动作游戏、带 Boss 战的 demo,或者提到"打击感""技能特效""掉落物""单文件分发""用 AI 生成模型做游戏",哪怕没说"用这个 skill",都应该先读它再动手。Build a polished browser 3D action game (three.js / WebGL, isometric soulslike, boss fight) with AI-generated assets and ship it as one HTML file.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/op7418--guizang-game-skill/badge.svg)](/listings/op7418--guizang-game-skill)

HTML

<a href="/listings/op7418--guizang-game-skill"><img src="/api/listings/op7418--guizang-game-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

把这个仓库的链接发给你的 AI,让它安装即可。或者手动:

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

Codex 等其它工具,克隆到它们各自的 skills 目录。

然后直接说需求,比如:

做一个武侠题材的俯视角网页 3D 动作游戏,一个场景、一波小怪、一个 Boss。
我有 Tripo 和即梦可以用。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 99 lines
  1. ---
  2. name: guizang-game-skill
  3. license: AGPL-3.0
  4. description: 用 AI 生成素材(Tripo 等 3D 模型、即梦等图片与配音、Suno 等配乐)加 three.js,做一个能在浏览器里跑、最后打包成单个 HTML 的 3D 动作游戏的完整流程和踩坑清单。只要用户想做网页 3D 游戏、WebGL 游戏、three.js 游戏、俯视角或魂类动作游戏、带 Boss 战的 demo,或者提到"打击感""技能特效""掉落物""单文件分发""用 AI 生成模型做游戏",哪怕没说"用这个 skill",都应该先读它再动手。Build a polished browser 3D action game (three.js / WebGL, isometric soulslike, boss fight) with AI-generated assets and ship it as one HTML file.
  5. ---
  6. # 网页 3D 动作游戏:从零到单文件
  7. 这份流程来自一次完整的实战:一个仙侠题材、斜俯视角、有小怪战和 Boss 战的网页动作游戏,最后打包成约 30MB 的单个 HTML。中间走了很多弯路,下面的每一条都对应一次真实的返工。
  8. 核心判断只有一个:**这类项目失败的原因几乎从来不是代码写不出来,而是没人看过画面、没人听过声音、没人真的按过键。** 所以整份流程的重心是"怎么让每一步都被验证"和"哪些东西不要自己从零写"。
  9. ## 开工前必须和用户对齐的四件事
  10. 1. **参考物**。让用户给参考视频或游戏,并且自己认真看、逐条拆解(镜头、技能节奏、界面风格)。没有参考就做出来的第一版,用户的评价通常是"和参考有半毛钱关系吗"。
  11. 2. **视角和玩法范围**。斜俯视角比第三人称省非常多的工作量,画面也更容易显得精致。范围建议:一个场景、一段小怪战、一个 Boss。
  12. 3. **可用的生成工具和积分**。问清楚有哪些命令行工具可用(3D 模型、图片、配音、配乐),每次花费多少。**用户主动提供工具时立刻接上**,不要坚持自己用几何体拼。
  13. 4. **先调研再动手**。用户说"先调研"是认真的。把调研结论和分阶段计划写成文档,让用户确认后再开工。
  14. ## 阶段顺序(每阶段结束都要让用户看到东西)
  15. | 阶段 | 产出 | 验收方式 |
  16. |---|---|---|
  17. | 0 调研与设定 | 调研文档、设定、分阶段计划 | 用户确认 |
  18. | 1 渲染底座 | 能看的空场景:HDR、雾、泛光、调色 | 截图给用户 |
  19. | 2 场景 | 地面、植被、道具摆放 | 截图,先过静态图再做动态 |
  20. | 3 角色与动作 | 模型、骨骼、招式 | 单独的展示页,近景截图 |
  21. | 4 战斗 | 可玩的战斗 | 用户试玩 |
  22. | 5 演出与 Boss | 过场、Boss 招式 | 用户试玩 |
  23. | 6 界面、音乐、语音 | 完整包装 | 用户试玩并听 |
  24. | 7 打磨与打包 | 单文件 | 用户双击打开 |
  25. 每个阶段结束把没解决的问题写进一个待办清单文件,并且**如实区分"验证过"和"只是不报错"**。
  26. 按需读这些参考文件:
  27. - `references/assets.md` — 生成 3D 模型、图片、配音、配乐的具体做法和省钱办法。开始做任何素材前读。
  28. - `references/characters-animation.md` — 生成的角色模型怎么接、动作怎么做才不僵。做角色前读。
  29. - `references/combat-feel.md` — 打击感、格挡弹反、怪物设计、镜头。做战斗前读。
  30. - `references/vfx-ui-audio.md` — 技能特效、掉落物、界面、音量。做特效和界面前读。
  31. - `references/pitfalls.md` — 按症状查的踩坑清单。遇到怪问题时先查这里。
  32. - `references/packaging.md` — 压缩资源并打包成单个 HTML。配套 `scripts/build_single_html.mjs`。
  33. 可以直接拿去用的脚本:
  34. - `scripts/input.js` — 不怕丢失松键事件的键鼠输入,带 F3 调试面板。项目一开始就用它,别自己重写输入。
  35. - `scripts/serve.mjs` — 本地静态服务器。
  36. - `scripts/build_single_html.mjs` — 压缩资源并内嵌成单个 HTML 的打包脚本(按 `references/packaging.md` 改路径)。
  37. ## 贯穿始终的工作方式
  38. **能用现成的就不要自己写。** 模型用生成工具或免费素材库,贴图用 CC0 材质库,音效用 CC0 音效包,配乐让用户用音乐模型出。自己写的合成音效和几何体模型,用户一眼(一耳)就能认出来是凑合的。
  39. **素材先出图再出模型。** 文字直接生成 3D 的质量明显差。稳定的做法是:图片模型出一张"单个物体、纯色背景、无特效"的设定图,再用图生 3D。图片便宜,可以多出几张挑。
  40. **每一步都要真的看。** 写完着色器、动作、特效之后,在浏览器里载入、截图、放大看。不要因为"语法检查过了"就汇报完成。具体方法见下一节。
  41. **花钱前报价,花完报数。** 生成工具通常有报价命令。视频类模型比图片、配音贵一到两个数量级,同一个目标优先找便宜的专用模型(例如配音不要走视频模型)。
  42. **用户的反馈要按原话逐条落实,然后再查资料。** 用户说"特效很僵""打击感差"时,不要凭感觉调参数,去查这个领域的常规做法,把结论写进调研文档再改。
  43. ## 怎么自己验证(没有人盯着屏幕的时候)
  44. 浏览器标签页隐藏时不会跑动画帧,所以需要一套不依赖实时渲染的调试钩子。项目一开始就加上:
  45. ```js
  46. G.step = (n = 60, dt = 1/60) => { for (let i = 0; i < n; i++) frame(0, dt); }; // 手动推进 n 帧(含渲染)
  47. G.upd = (n = 30, dt = 1/60) => { for (let i = 0; i < n; i++) updatePlayer(dt); }; // 只跑移动逻辑,快
  48. G.press = (...codes) => codes.forEach(c => pressed.add(c)); // 模拟一次按键
  49. G.keys, G.mouse, G.pl(), G.fx, G.spawn(kind, pos) // 暴露状态和生成器
  50. ```
  51. 再配几个网址参数:`?stage=court` 直接进某一关,`?auto` 跳过标题,`?god` 无敌,`?show=char` 打开单独的角色展示页。
  52. 用法:推进若干帧 → 读状态数值 → 截图 → 放大局部。几条经验:
  53. - **结论靠数值,截图只做辅助。** 截图偶尔是旧画面;状态数值不会骗人。
  54. - **带渲染的 `G.step` 很慢**,一次调用别超过一千帧,大规模扫描(例如全图找卡点)用只跑逻辑的 `G.upd`。
  55. - **自动测试默认静音**,否则用户会听到后台一直在响。测完把页面切回标题画面。
  56. - **改完代码必须在浏览器里实际载入一次并看控制台**,语法检查不够(见 `references/pitfalls.md` 的"游戏打不开")。
  57. ## 汇报的规矩
  58. 用户不看代码,只看你怎么说。每次汇报:
  59. - 先说结论:改了什么、现在是什么状态。
  60. - 明确分开三类:实际看到或听到验证过的、只确认不报错的、没法验证需要用户试的。
  61. - 找不到原因就直说找不到,并给用户一个抓现场的办法(例如按 F3 显示调试面板再截图)。一次有效的截图比十轮猜测有用。
  62. - 报出这一轮花掉的积分。
  63. ## 这类项目最常见的七个翻车点
  64. 1. 第一版自己用几何体和合成音拼,被整体推翻重做。
  65. 2. 角色动作靠猜关节角度,姿势扭曲。应该指定手脚目标位置,用两段骨骼解算。
  66. 3. 特效是"一张贴图盖在面片上"。应该用贴合运动轨迹的网格、滚动噪声、随时间侵蚀。
  67. 4. 玩家和怪"各打各的"。缺攻击吸附、双方顿帧、受击分级、身体碰撞。
  68. 5. 泛光下特效过曝成白块。高动态颜色峰值控制在 2 到 3。
  69. 6. 为了修一个按键问题加的"保险"反而造成新的按键问题。输入处理只做最少的事。
  70. 7. 交付前才发现依赖外网、体积上百兆。打包脚本要在中期就建好。
README.md · README · 145 lines
  1. <div align="center">
  2. <img src="media/icon.png" width="96" alt="雾锁山门">
  3. # 歸藏 Game Skill
  4. **让 AI 从零做出一个能在浏览器里玩的 3D 动作游戏**
  5. [English](README.en.md) · 简体中文
  6. [![试玩演示](https://img.shields.io/badge/试玩演示-雾锁山门-c9a45c?style=for-the-badge)](https://op7418.github.io/guizang-game-skill/)
  7. [![License](https://img.shields.io/badge/License-AGPL--3.0-blue?style=for-the-badge)](LICENSE)
  8. [![Stars](https://img.shields.io/github/stars/op7418/guizang-game-skill?style=for-the-badge&color=e9dcae)](https://github.com/op7418/guizang-game-skill/stargazers)
  9. <a href="https://op7418.github.io/guizang-game-skill/"><img src="media/demo.gif" width="720" alt="雾锁山门战斗演示"></a>
  10. *上面这段是演示游戏《雾锁山门》里的实机画面。[点这里直接玩](https://op7418.github.io/guizang-game-skill/),电脑和手机都能打开,不用安装。*
  11. </div>
  12. ---
  13. ## 这是什么
  14. 一个给 AI 编程助手(Claude Code、Codex 等)用的 Skill。装上之后,对它说"做一个武侠题材的俯视角 3D 动作游戏",它会按一套走通过的流程去做:先问清楚你要什么,接上你手头的素材生成工具,自己推进画面、自己截图核对,最后把游戏打包成一个网页文件。
  15. Skill 里写的不是理论,是我用 Fable 5.2 花一个下午做出《雾锁山门》的过程中踩过的坑,和最后留下来的做法。那次大约 6 小时、4.5 亿 Token(其中一部分是 Opus 5.5 跑的测试),很多都花在了返工和试错上。这个 Skill 的目的就是让你和你的 AI 少走这些弯路。
  16. ## 演示游戏:雾锁山门
  17. <table>
  18. <tr>
  19. <td width="38%"><img src="media/cover.jpg" alt="标题画面"></td>
  20. <td>
  21. 一个仙侠题材的俯视角 3D 动作游戏:一个场景、一段小怪遭遇战、一场 Boss 战,有剧情和配音。**所有创意都是 AI 自己定的**,我只说了要做国风仙侠。
  22. - **画面**:大片随风起伏的草,分层的雾、雪和远山,覆水石台上的反光。渲染流程是在 three.js 上自己搭的,只用兼容性最好的 WebGL,所以手机、电脑、小程序类容器里都能跑
  23. - **角色与场景**:5 个带骨骼的 3D 角色、2 把武器、12 种场景道具、5 种掉落物。先用即梦出设定图,再用 Tripo 转成模型,提示词都是 AI 自己写的
  24. - **战斗**:三段连招、闪避、格挡、弹反、处决,还有饮药、御剑和大招"万剑归宗"。Boss 有二阶段、起身过场和台词
  25. - **声音**:8 条配音、配乐、环境音和音效
  26. - **体积**:原始素材将近 100MB,打包后是一个约 33MB 的 HTML,里面包含全部模型、贴图、音乐和配音
  27. </td>
  28. </tr>
  29. </table>
  30. <table>
  31. <tr>
  32. <td><img src="media/shot_combo.jpg" alt="连招"></td>
  33. <td><img src="media/shot_skill.jpg" alt="剑诀"></td>
  34. <td><img src="media/shot_ult.jpg" alt="万剑归宗"></td>
  35. </tr>
  36. <tr>
  37. <td align="center">三段连招</td>
  38. <td align="center">剑诀</td>
  39. <td align="center">万剑归宗</td>
  40. </tr>
  41. </table>
  42. 演示的三种形态,都是同一份源码打出来的:
  43. | 形态 | 说明 |
  44. |---|---|
  45. | [在线版](https://op7418.github.io/guizang-game-skill/) | 先渲染出场景再边跑边加载;手机有触屏摇杆和按钮;设置里可以调画质、换高清材质、改按键 |
  46. | 单文件版 | 一个约 33MB 的 HTML,没有任何网络请求 |
  47. | 小程序容器版 | 按小红书小工具的限制(不能联网、不能用 WASM、包体 10MiB)单独构建,约 8MiB |
  48. ## 这个 Skill 帮你做什么
  49. 直接让 AI"做个 3D 游戏",通常会得到一个方块灰模、手感发飘、要自己搭环境才能跑的东西。装上这个 Skill 之后:
  50. 1. **开工前先问清楚**。参考、视角、氛围、范围,以及你手头有哪些素材工具和多少额度。它不会闷头写一个方块模型出来,上来就把你给的工具接上
  51. 2. **自己验证,不用你反复试**。第一天就装好自测工具:逐帧推进画面、直达某一关的网址参数、F3 诊断面板。它自己截图核对,再告诉你哪些看过、哪些只是没报错
  52. 3. **战斗手感有章可循**。出招前摇和后摇、命中顿帧、分级击退、格挡与弹反、敌人轮流进攻而不是一拥而上、闪避能打断动作。打击感从哪来,都写进去了
  53. 4. **一份踩坑清单**。方向键卡住、预设动画把角色甩离原地、泛光过曝、镜头被屋顶挡住、打包后角色缩小一半……每条都有症状、原因和做法
  54. 5. **三种打包方式**。把很大的模型和素材压到很小:单个 HTML、先出画面再加载的静态站点、受限容器的离线包
  55. ## 安装
  56. 把这个仓库的链接发给你的 AI,让它安装即可。或者手动:
  57. ```bash
  58. git clone https://github.com/op7418/guizang-game-skill ~/.claude/skills/guizang-game-skill
  59. ```
  60. Codex 等其它工具,克隆到它们各自的 skills 目录。
  61. 然后直接说需求,比如:
  62. ```
  63. 做一个武侠题材的俯视角网页 3D 动作游戏,一个场景、一波小怪、一个 Boss。
  64. 我有 Tripo 和即梦可以用。
  65. ```
  66. ## 需要准备
  67. | 东西 | 用途 | 没有的话 |
  68. |---|---|---|
  69. | Node.js 18+ | 本地服务器和打包 | 必需 |
  70. | [Tripo](https://www.tripo3d.ai/) | 图片转 3D 模型、骨骼绑定 | 改用免费模型和程序化几何体,画面会打折扣 |
  71. | [即梦](https://jimeng.jianying.com/) 或其它出图工具 | 角色设定图、图标、题字、配音 | 改用免费素材 |
  72. | [Suno](https://suno.com/) | 配乐 | Skill 会写好提示词给你,或用程序生成的配乐 |
  73. 素材工具对最终效果影响很大。我一开始让它直接用文字生成模型,质量很差;改成"先出设定图,再转 3D"之后上了一个大档次。
  74. ## 流程
  75. ```
  76. 调研与规划 → 设定与素材 → 动作 → 手感与特效 → 声音与打包
  77. ```
  78. 1. **调研与规划**:读参考、查这类游戏的做法,写调研文档和分阶段计划
  79. 2. **设定与素材**:世界观、角色设定图、图转 3D、骨骼绑定
  80. 3. **动作**:平台给的预设动作不多,其余用程序算出每个姿势里手脚的位置
  81. 4. **手感与特效**:按战斗手感清单逐项做,特效走"网格 + 着色器"而不是堆粒子
  82. 5. **声音与打包**:音效、配音、配乐,然后压缩并打成单文件
  83. ## 目录
  84. | 路径 | 内容 |
  85. |---|---|
  86. | [`SKILL.md`](SKILL.md) | 整体流程和每个阶段的检查点 |
  87. | [`references/assets.md`](references/assets.md) | 素材生成与免费素材来源 |
  88. | [`references/characters-animation.md`](references/characters-animation.md) | 角色、骨骼与动画 |
  89. | [`references/combat-feel.md`](references/combat-feel.md) | 战斗手感 |
  90. | [`references/vfx-ui-audio.md`](references/vfx-ui-audio.md) | 特效、界面与声音 |
  91. | [`references/pitfalls.md`](references/pitfalls.md) | 踩坑清单 |
  92. | [`references/packaging.md`](references/packaging.md) | 体积优化、单文件打包、在线托管、手机与受限容器 |
  93. | [`scripts/`](scripts) | 可直接复用的输入处理、本地服务器、三种打包脚本 |
  94. ## 先说清楚的事
  95. - **它不是一句话出成品**。《雾锁山门》我试玩了 7 轮,每轮提 5 到 10 个问题。我不懂做游戏,只会说"动作很僵硬""打击感很差",AI 会把这些话翻译成专业做法去查、去改。你仍然需要来回试玩提意见
  96. - **几件事我会坚持让 AI 做**:给它参考视频;要求"先调研再动手";别让它自己造轮子,把现成的素材工具接上
  97. - **Skill 目前只在一个项目上完整走过一遍**,另做过一次计划层面的对照测试。它能让方向少走弯路,不保证成品质量
  98. ## 许可
  99. - **Skill 本身**(本仓库 `main` 分支的文档与脚本):[AGPL-3.0](LICENSE)
  100. - **演示游戏《雾锁山门》的内容**(美术、模型、配音、配乐、文案,位于 `gh-pages` 分支):© 2026 歸藏,保留所有权利。欢迎试玩和分享链接,未经许可请勿转载、改名再发布或商用
  101. ## 作者
  102. [歸藏](https://x.com/op7418)。觉得有用的话点个 Star,也欢迎把你做出来的游戏发给我看。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.