phaserjs-oakwoods

一个结合了Phaser游戏开发与Agent Skills的实战项目模板。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:phaserjs-oakwoods。
它的用途是:一个结合了Phaser游戏开发与Agent Skills的实战项目模板。
完整的 Skill 内容见:https://321skill.com/skills/phaserjs-oakwoods/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我想给游戏角色添加一个二段跳功能,并调整跳跃手感。”,它会根据Phaser Skills中的知识,为你生成修改物理参数、监听键盘事件、管理跳跃状态的相关代码片段。或者

对AI说:“如何为这个游戏场景编写一个Playwright测试,检查主角是否正常生成?”,它会引导你使用配套的测试Skill,编写定位Canvas元素、断言精灵存在的测试用例。

介绍

这个仓库解决了一个核心问题:如何利用AI Agent(如Claude Code、Codex CLI)来辅助开发2D平台跳跃游戏。它提供了一个基于Phaser 3、TypeScript和Vite的完整游戏场景,包含视差背景、无限地面、角色移动/跳跃/攻击等基础功能,并附带了专为游戏开发定制的Agent Skills。

使用方式非常简单。首先克隆仓库并安装依赖,然后按照指引获取并放置必需的美术资源包。运行开发服务器后,即可体验游戏。更重要的是,仓库内预置了可直接使用的Agent Skills文件,你可以将它们导入到Claude Code或Codex CLI等工具中,让AI助手在游戏开发、调试、测试等环节为你提供智能化的代码生成与问题解答。

它非常适合希望学习或实践Phaser游戏开发,并想探索AI辅助编程效率的前端开发、全栈开发或智能体开发者。对于高校学生完成游戏相关的课程设计或毕业设计,这也是一个极佳的起点。

需要注意的是,项目本身不包含美术资源,你需要从指定链接单独购买并放置到正确目录。同时,AI Skills的效果高度依赖于你所使用的AI工具(如Claude Code)的上下文理解与代码生成能力。

核心特点

与通用的游戏开发教程或代码片段库不同,它直接集成了针对Phaser游戏开发和Playwright测试的、可直接导入AI工具使用的Agent Skills文件,将具体的开发工作流(如精灵动画处理、物理碰撞调试、Canvas元素测试)封装成了AI可理解和执行的指令集。

注意事项

不适合需要完整、开箱即用游戏项目的用户,因为必须自行获取并配置第三方美术资源。

常见问题

运行游戏提示找不到图片资源怎么办?

需要从itch.io购买‘Oak Woods’资源包,并严格按照README中的目录结构放置到`public/assets/oakwoods/`下。

如何让AI助手使用这个Skill?

将仓库中`.claude/skills/`或`.codex/skills/`下的`SKILL.md`文件内容,导入或配置到你使用的AI工具(如Claude Code、Codex CLI)的技能库中。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/phaserjs-oakwoods/raw/index.md 读取 phaserjs-oakwoods 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。