ZED Invaders（HTML5/JS 浏览器游戏 1.0 beta）

chongdashu/threejs-capacitor-ios-game 是一个面向移动端 3D 点击式冒险游戏的参考模板仓库，定位为 YouTube 教程《How I Vibe Code 3D Games With AI - Full Tutorial》的配套工程。它的目标不是直接交付一款可安装游玩的成品，而是把视频中使用的一套 AI 辅助开发工作流整理成可复用的目录：包括给 AI 编程代理使用的 Agent Skills、生成角色与场景素材的提示词，以及描述 GLB 角色动画元数据的 JSON 索引。README 明确说明，本仓库不包含可直接运行的 App 代码，也不包含 GLB 模型文件，这些内容需要在视频流程中借助仓库提供的技能与提示词自行生成，因此它更适合被理解为“教学配套模板”和“工作流样板”，而不是完整游戏项目。

仓库最核心的部分是两套 Agent Skills。一套面向 Claude Code，另一套面向 Codex CLI，分别放在 .claude/skills 与 .codex/skills 目录中。Three.js Builder 技能覆盖 Three.js 场景搭建、GLTF/GLB 模型加载、动画混合、着色器、后处理，以及状态机、视差滚动等常见游戏模式；Capacitor iOS 技能则覆盖 Capacitor 原生工程同步、SPM 与 CocoaPods 两种依赖管理方式的取舍、iOS 集成中的常见问题，以及基于动画索引的元数据组织模式。README 建议把这些技能文件夹复制到自己的项目中，让 AI 编程代理获得 Three.js 与 Capacitor iOS 工作流的上下文，从而在生成代码或排查问题时更贴近项目需要。

核心特性

prompts 目录提供了视频中的分步 AI 提示词，共六个文件：01-character-creation.txt 用于通过 Gemini 生成 3D 角色，示例是 T-pose 的奇趣海盗 GLB；02-level-creation.txt 用于生成 2.5D 预渲染背景图；03-character-voice.txt 定义角色语音人设；04-animate-bg.txt 给出循环背景动画的提示；05-asset-json.txt 用于从 GLB 模型的动画片段生成 assets_index.json；06-threejs-scene.txt 则指导搭建带轨道控制器与触摸输入的 Three.js 查看器场景。这些提示词把“素材生成—动画元数据整理—Three.js 场景接入”串联成一条可跟着视频复现的流水线，也展示了如何把自然语言提示词转化为工程资产。

动画索引是仓库另一个值得注意的技术点。public/assets/assets_index.json 为海盗与酒保两个角色定义了动画契约：把 idle、walk、run、talk 等友好动作名映射到 GLB 文件内部的实际动画片段名，并记录时长、循环模式、默认状态以及交叉淡入时间等信息。由于仓库不附带 GLB 文件，这个 JSON 主要展示预期结构和元数据组织方式，方便开发者接入自己的模型。这样的设计把“动画语义”与“模型文件”解耦，使 Three.js 侧可以用统一接口读取动作，而不必把片段名硬编码在场景逻辑里，对后续替换角色或扩展动作都比较友好。

技术要点

从技术栈看，项目围绕 Three.js 做 3D 渲染与角色查看，借助 Capacitor 将 Web 技术打包到 iOS，README 标题也写明面向 Desktop 与 iOS。仓库结构包含技能目录、prompts、public/assets/assets_index.json 以及 docs 下的预览 GIF，预览图展示的是海盗 3D 角色查看器效果。项目采用 MIT 许可证。需要注意的是，仓库没有给出完整的构建命令、依赖安装步骤或可下载安装包，实际运行需要自行按视频流程生成代码与模型，并准备 Three.js、Capacitor、Xcode 等环境。

适合学习本仓库的人群包括：想了解 AI 辅助 3D 游戏原型工作流的开发者、正在研究 Three.js 加载 GLTF/GLB 与动画混合的前端/游戏开发者、需要把 Web 3D 内容集成到 iOS 的 Capacitor 使用者，以及希望为自己的 AI 编程代理编写 Skills 与提示词的团队。使用时应把 README 的“参考/模板”定位放在首位：不要期待克隆后即可运行，也不要把 assets_index.json 当作完整资源包；角色、背景、语音和动画仍需按提示词生成，实际可玩效果有待核验。国内环境还需注意 YouTube 与 BuilderPack 等外链访问、npm/Capacitor/CocoaPods/SPM 依赖下载，以及 iOS 构建对 macOS 与 Xcode 的要求，相关网络与工具链情况建议自行核验。