Godot Headless Testing
/godot-gdscript-headless-testing
Run GDScript test suites from the command line with `godot --headless`, using a SceneTree/MainLoop runner script that exits non-zero on failure so CI can gate merges.
- GitHub 星数
- 2,085 (所在仓库星数，统计于 2026-10-21)
- 许可证
- Apache-2.0
- 最近提交
- 2026/10/09
- 作者
- gamedev-skills
所属合集
Awesome Gamedev Agent Skills
74 portable SKILL.md skills for Godot, Unity, Unreal, Phaser, PixiJS, three.js, Bevy, pygame, LÖVE and Roblox, with a router.
信息来自作者的 README。 GameSkill 还没完整跑过。支持的 Agent 和安装步骤以作者文档为准。
安装
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill godot-gdscript-headless-testingInstalls only this skill. Add -a claude-code (puts it in .claude/skills/), -a codex or -a cursor (.agents/skills/) to choose the agent, and -g to install it for your user instead of the project.
命令照搬项目 README。在本机运行前，请先看一眼仓库。
为指定 Agent 安装
| Agent | -a | 文件夹 |
|---|---|---|
| Claude Code | claude-code | .claude/skills/ |
| Codex | codex | .agents/skills/ |
| Cursor | cursor | .agents/skills/ |
| Gemini CLI | gemini-cli | .agents/skills/ |
| GitHub Copilot | github-copilot | .agents/skills/ |
| OpenCode | opencode | .agents/skills/ |
| Windsurf | windsurf | .windsurf/skills/ |
在命令后加 -a <参数>。以上是项目级文件夹；加 -g 则安装到你的用户目录。
包含内容
- Worked steps: Minimal SceneTree test runner with a real exit code; Testing something that needs a frame, a timer, or a signal; CI step (GitHub Actions) that gates on the exit code
- A pitfalls section with the mistakes to avoid
适合
- When a Godot project needs unit tests without opening the editor, when wiring a CI job (GitHub Actions or similar) that must fail the build on a failing `.gd` test
- When a `godot --headless` invocation hangs, opens a window, or exits 0 despite failed assertions
试试这条提示词
Run my GDScript tests headless in GitHub Actions and fail the build when one fails.关于这个 Skill
Run GDScript test suites from the command line with godot --headless, using a SceneTree/MainLoop runner script that exits non-zero on failure so CI can gate merges. Use when a Godot project needs unit tests without opening the editor, when wiring a CI job (GitHub Actions or similar) that must fail the build on a failing .gd test, or when a godot --headless invocation hangs, opens a window, or exits 0 despite failed assertions.
From the godot-gdscript-headless-testing SKILL.md in gamedev-skills/awesome-gamedev-agent-skills.
What's inside
- Minimal SceneTree test runner with a real exit code
- Testing something that needs a frame, a timer, or a signal
- CI step (GitHub Actions) that gates on the exit code
常见问题
搭配使用
作者标注的相关 Skills，或更适合相邻任务的 Skills。
GDScript for Godot 4
Write idiomatic GDScript for Godot 4.7: static typing, the node lifecycle (_ready/_process/_physics_process), @export/@onready/@tool annotations, signals, and await for asynchronous flow.
Godot Export
Export Godot 4.7 games for desktop, web and mobile: export presets, headless CLI builds for CI, web COOP/COEP and server builds.
Awesome Gamedev Agent Skills 中的更多 Skills
查看全部 43 个2D Platformer
Build a 2D platformer: run/jump control with coyote time, jump buffering, and variable jump height, plus tiled levels and hazards.
Behavior Trees & Utility AI
Build a behavior-tree runtime and a Utility AI system with response curves, plus hybrid agents where the behavior tree drives utility scoring.
Bevy ECS
Structure a Bevy app around ECS: plugins, components and resources, systems with Query and Commands, system ordering and Time.
Card Game
Build a card game: card data, deck/hand/discard zones, draw/shuffle/reshuffle, a turn structure, costs, and effect resolution.
相似 skills
Claude Code Game Studios
Turns Claude Code into a full game studio: 49 agents and 72 workflow skills arranged like a real studio hierarchy.
Balance Check (Claude Code Game Studios)
Find balance outliers, broken progressions, degenerate strategies, economy imbalances in formulas and data.
Launch Checklist (Claude Code Game Studios)
Launch readiness across every department: code, content, store, marketing, community, infrastructure, legal, go/no-go sign-offs.
Godot MCP (Coding-Solo)
MCP server for Godot: launch the editor, run projects, capture debug output and edit scenes.