前言¶
做网页小游戏或练手项目时，常见卡点不是「不会写某一行代码」，而是从玩法描述到可运行闭环之间缺一层架构：状态怎么切、碰撞怎么判、特效怎么挂、调试时 bug 从哪查。自己从零搭框架往往耗在循环与模块边界上，而通用编程助手又未必按游戏开发的惯例组织代码。
下面介绍 SkillHub 上的 小游戏开发专家（@user_f52ec6c7/gamemaker）。它面向「需求偏抽象、希望产出完整可玩 2D/3D 小游戏」的场景，把架构与实现步骤写进 Skill 指令，供 Cursor 等支持 Skills 的 Agent 在安装后按同一套约定协作。
这是什么¶
小游戏开发专家 是社区来源（community）的 Agent Skill，坐标 @user_f52ec6c7/gamemaker，当前版本 1.0.0，分类为 dev-programming。SkillHub 页面标注作者为孙天愉；发布者 ID 为 user_f52ec6c7。
官方简介将其定位为「专业游戏架构师」：将用户的抽象需求转化为完整可玩的 2D/3D 小游戏；并写明支持游戏闭环设计、状态管理、碰撞检测、粒子特效。标签 requires_api_key=false，表示按 SkillHub 元数据无需额外 API Key 即可使用 Skill 本身。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_f52ec6c7/gamemaker
- API 资源地址（页面引用）：https://api.skillhub.cn/user_f52ec6c7/gamemaker
截至 SkillHub 抓取数据：评分 100000，下载 6525 次，安装计数 0（以商店页统计为准，会随时间变化）。
核心功能¶
以下能力均来自官方简介与 SkillHub 元数据，不展开未在资料中出现的引擎绑定或框架版本。
- 需求到可玩成品：把自然语言描述的玩法、规则、胜负条件，组织为可运行的小游戏工程思路与实现。
- 2D / 3D：简介同时覆盖二维与三维小游戏场景（具体技术栈由对话中与 Agent 共同选定，Skill 未在资料中锁定单一引擎）。
- 游戏闭环设计：从开局、进行、结束到重开等完整流程，而非孤立代码片段。
- 状态管理：菜单、进行中、暂停、结算等状态的划分与切换。
- 碰撞检测：角色、障碍、拾取物等交互所需的碰撞逻辑。
- 粒子特效：常见视觉反馈（如爆炸、轨迹）的实现指引。
- 调试与修复：简介明确适用于「需要代码调试修复」——在已有游戏代码上定位与修补问题。
安装与启用¶
Skill 基于通用 SKILL.md 格式。SkillHub 官方安装提示为：先阅读安装说明，再安装本坐标。
向 Agent 发送（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f52ec6c7/gamemaker`。
若本机已安装 SkillHub CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 小游戏开发专家 时，必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 可能不会被识别。官方文档给出的常用路径示例：
| 环境 | Skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例（将目录替换为你的实际路径）：
skillhub install @user_f52ec6c7/gamemaker --dir ~/.cursor/skills/
安装后按你所用 Client 的要求刷新或重启 Agent，使新 Skill 被加载。资料中未区分 Cursor / Codex CLI / Claude Code 的安装包差异，除 skills 目录路径外，均以 SkillHub 统一 CLI 为准。
典型用法¶
官方资料未附带固定代码仓库或逐步教程，典型用法是在已启用该 Skill 的对话中，用任务描述触发其架构师角色。下列表述与官方「何时使用」说明一致，可直接作为首轮提示（需自行补充技术偏好，例如「用 Canvas 2D」「用 Three.js」）：
-
从零做网页小游戏
「帮我做一个可在浏览器里玩的 2D 躲避障碍小游戏：有开始界面、游戏中、游戏结束和重新开始；需要碰撞检测和简单粒子爆炸特效。」 -
学习游戏编程结构
「用一个小游戏示例讲清楚状态机怎么设计：菜单、Playing、Paused、GameOver，并给出可运行代码。」 -
修补现有项目
「这是我的游戏代码，角色穿墙了，请按碰撞检测逻辑排查并修复。」
经过上面的步骤，Agent 会按 Skill 内约定组织闭环、状态、碰撞与特效等相关实现；具体文件名与依赖以对话输出为准。
适用场景与注意¶
适合谁
- 需要快速从玩法想法得到可玩 demo 的开发者或学习者。
- 做网页游戏、练手游戏编程，或维护小型 2D/3D 原型的人。
- 已有半成品代码、需要系统化调试与补全模块的场景。
限制与注意
- 简介承诺的是架构与实现能力范围，不保证特定帧率、平台商店上架或商用授权；上线前仍需自行测试与合规审查。
requires_api_key=false仅指 Skill 元数据；若选用需要密钥的云服务或素材 API，需自行配置。- 下载量、评分等以 SkillHub 页面为准，与第三方摘录可能不一致，以 https://www.skillhub.cn/skills/user_f52ec6c7/gamemaker 为准。
- 安装统计为 0 仅表示抓取时的商店字段，不代表 Skill 不可用；以本地
skillhub install是否成功为准。
结尾¶
小游戏开发专家 把「抽象玩法 → 可玩小游戏」拆成 Agent 可执行的架构与实现约定，覆盖闭环、状态、碰撞与粒子等常见模块，并适用于调试修复。若你正在 SkillHub 上找游戏向的编程 Skill，可先安装 @user_f52ec6c7/gamemaker，再从一条完整的玩法描述开始迭代。
官方地址：https://www.skillhub.cn/skills/user_f52ec6c7/gamemaker
