前言¶
做網頁小遊戲或練手項目時，常見卡點不是「不會寫某一行代碼」，而是從玩法描述到可運行閉環之間缺一層架構：狀態怎麼切、碰撞怎麼判、特效怎麼掛、調試時 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
