关于 godot
godot 是面向 Godot 项目开发与验证的技能，要求依据项目实际版本、设置和现有约定开展工作。它涵盖测试选择、构建导出、部署核验，并强调区分静态检查与实际运行验证。
主要功能
- 01检查项目版本与配置
- 02选择 GdUnit4 或 PlayGodot 测试
- 03运行项目测试并解析结果
- 04导出并检查构建产物
- 05验证 Web 构建的浏览器行为
- 06部署后核验实际目标
适用场景
- 01为现有 Godot 项目规划测试
- 02自动化场景输入与端到端检查
- 03验证平台或浏览器导出构建
- 04检查 CI 变更及部署后的运行状态
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/godot确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
.claude-plugin/plugin.jsonagents/openai.yamlreferences/assertions.mdci-integration.mddeployment.mdgdunit4-quickstart.mdplaygodot.mdscene-runner.mdscripts/export_build.pyparse_results.pyrun_tests.pyvalidate_project.py详细介绍
Godot
根据目标项目实际使用的 Godot 版本、项目设置、插件和导出预设开展工作。遵循项目约定，不要强行套用通用场景架构。
前置检查
- 阅读仓库说明，并检查
project.godot、export_presets.cfg、已安装的插件和现有测试布局。 - 确认 Godot 可执行文件的位置，并在选择命令或 API 之前核实其版本。
- 确定所需的验证级别：
- 使用 GdUnit4 进行单元测试、组件测试和引擎内场景测试；
- 使用 PlayGodot 进行外部端到端自动化、截图或输入模拟；
- 如果行为取决于平台或浏览器打包，则使用实际导出的构建。
- 仅凭静态检查时，不要声称已通过真实渲染、输入、导出或部署验证。
测试与实现
- 如需了解 GdUnit4 的设置、测试布局和运行器命令，请阅读 references/gdunit4-quickstart.md。
- 如需了解场景输入模拟，请阅读 references/scene-runner.md。
- 仅在编写或修复断言时，阅读 references/assertions.md 了解断言语法。
- 如需了解 PlayGodot 的安装和外部自动化，请阅读 references/playgodot.md。选择此方案前，请确认所需的自定义 Godot 构建已存在。
优先使用项目现有的运行器。常见的 GdUnit4 命令如下：
godot --headless --path . -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd --run-tests
通过相对于此技能目录的路径解析并使用随附的辅助工具：
scripts/validate_project.py用于项目前置检查；scripts/run_tests.py用于可重复的测试执行；scripts/export_build.py用于导出；scripts/parse_results.py用于生成机器可读的测试结果。
运行辅助工具前，请先检查其选项；如果项目自身的脚本具有权威性，请勿覆盖项目既定命令。
导出与部署
- 创建或更改导出预设或部署行为时，请阅读 references/deployment.md。
- 导出到项目指定的构建目录，并检查生成的构件。
- 对于 Web 构建，请托管导出内容并在浏览器中进行测试；验证资源加载、输入、视口行为、控制台错误以及任何所需的跨源隔离。
- 更改 CI 时，请阅读 references/ci-integration.md，不要照搬未经验证的工作流示例。
- 将生产部署视为需要单独授权的操作边界。获得授权并完成部署后，请验证线上目标，而不要止步于 CLI 成功退出。
最后说明 Godot 版本、执行过的测试或运行时检查、生成的构件或部署状态，以及仍未验证的行为。
评论
支持 Markdown