前言¶
在 Godot 4 里做 2D 游戏，常见问题不是「引擎不会用」，而是流程散：项目结构怎么搭、CharacterBody2D 和 TileMap 怎么分工、像素素材导入参数、HUD 和关卡怎么挂到场景树、导出前怎么在无头环境验一下。问通用大模型时，回答往往偏片段，缺少一条能从头走到可玩、可导出的主线。
下面介绍 SkillHub 上的社区 Skill「2D 游戏开发（Godot 4）」：把脚手架、场景架构、玩法模板、UI、资产与导出串成一条工作流，并在对话里用自然语言触发。
这是什么¶
「2D 游戏开发（Godot 4）」是面向 Godot 4 + GDScript 的 Agent Skill，坐标为 @user_51ab3167/2d-game-dev，当前版本 1.0.0，来源为 community（社区），分类 dev-programming。SkillHub 页面标注作者为 joewang；发布者 ID 为 user_51ab3167。标签 requires_api_key=false，安装后不需要额外 API Key。
它解决的是：在 AI 辅助编码场景下，用统一规范完成 2D 游戏从立项到导出 的端到端指导；官方说明明确 只做 2D，3D 应使用 3d-game-dev skill。
核心功能¶
以下能力均来自 SkillHub 官方简介，可按模块理解 Agent 会引导的方向。
项目与场景¶
- 项目脚手架与场景树架构规范，减少节点层级和职责混乱。
玩法模板¶
- CharacterBody2D 角色控制器（平台跳跃、横版、俯视角等常见 2D 玩法）。
- TileMap 关卡搭建。
- Area2D 拾取与伤害区域。
- 敌人 AI 等常用 2D 玩法骨架。
UI、资产与验收¶
- UI / HUD（血条等界面元素）。
- 像素画导入设置、免费素材源指引。
- 命令行 无头验证 与截图验收，便于 CI 或本地快速回归。
- 导出发布（含导出到网页、桌面等诉求）。
触发场景（可直接对 Agent 说）¶
官方列出的典型说法包括：
- 「做一个 2D 游戏」「用 Godot 做游戏」
- 「写个平台跳跃 / 横版 / 俯视角 / 弹幕 / roguelike 游戏」
- 「加个角色控制器 / 相机 / 血条 / 关卡 / 敌人」
- 「游戏跑不起来帮我查」「导出到网页 / 桌面」
- 英文：
make a 2D game、platformer / top-down shooter in Godot
安装与启用¶
Skill 基于通用 SKILL.md 格式。在 SkillHub 上安装时，页面给出的提示是：让 AI 按官方安装文档处理，并安装坐标 @user_51ab3167/2d-game-dev。
方式一：通过 SkillHub CLI（推荐）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档 执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。不同客户端路径不同，官方文档给出的常用示例如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中可执行：
skillhub install user_51ab3167/2d-game-dev --dir ~/.cursor/skills/
装好后按所用 Agent 的要求重启或刷新技能列表（SkillHub 文档说明：未指向正确目录时往往需要重启才生效）。
方式二：对话安装¶
将 SkillHub 页面提供的提示发给 AI，例如：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_51ab3167/2d-game-dev`。
由 Agent 按文档完成 CLI 检查、--dir 选择与安装。
典型用法¶
没有单独附带的「一键 demo 仓库」说明时，用法就是：用触发语打开工作流，再按 Skill 内的 Godot 4 规范逐步落地。
- 说明游戏类型与视角（平台跳跃、俯视角射击、roguelike 等），让 Agent 按 Skill 搭脚手架与场景树。
- 指定当前卡点：控制器、TileMap 关卡、敌人、拾取伤害、HUD 等，对照 Skill 中的节点类型与分工改工程。
- 接入或替换素材时，按 Skill 中的像素导入与素材源建议配置 Godot 导入器。
- 运行异常或导出前，要求走 无头验证 / 截图验收，再执行网页或桌面导出。
全程使用 Godot 4 与 GDScript；若目标是 3D，应改用 3d-game-dev，避免与本 Skill 范围冲突。
适用场景与注意¶
适合谁
- 已选 Godot 4 做 2D，希望 AI 按固定架构推进而不是零散贴代码的独立开发者或小团队。
- 需要平台跳跃、横版、俯视角、弹幕、roguelike 等 2D 品类时，想快速对齐 CharacterBody2D、TileMap、Area2D 等标准做法的同学。
限制与注意
- 范围限定 2D；3D 不在本 Skill 内。
- 社区来源（
community），使用前可在 SkillHub 页面查看版本与说明，自行评估是否纳入工作流。 - SkillHub 抓取数据（截至编写时）：评分 100000，下载 3486；页面统计会随时间变化，以官网为准。
- 安装统计字段在抓取快照中为安装 0，仅作平台展示参考，不代表 Skill 内容不可用。
结尾¶
「2D 游戏开发（Godot 4）」把 Godot 4 做 2D 时常拆散的步骤收成一条可对话触发的工作流：从脚手架、玩法模板到 UI、资产、无头验证与导出。若你正在用 Cursor 或其他支持 Skills 的 Agent 做游戏原型，可按上文安装到对应 skills 目录，用官方列出的中英文触发语直接开工。
- SkillHub 页面：https://www.skillhub.cn/skills/user_51ab3167/2d-game-dev
- API / 元数据：https://api.skillhub.cn/user_51ab3167/2d-game-dev
- 安装说明：https://skillhub.cn/install/skillhub.md
