godot

Godot

対象プロジェクトで実際に使用されている Godot のバージョン、プロジェクト設定、アドオン、エクスポートプリセットに基づいて作業してください。汎用的なシーン構成を押し付けず、プロジェクトの規約を維持してください。

事前確認

1. リポジトリの指示を読み、project.godot、export_presets.cfg、インストール済みのアドオン、既存のテスト構成を確認します。
2. Godot 実行ファイルを特定し、コマンドや API を選ぶ前にバージョンを確認します。
3. 必要な検証レベルを判断します。
   • ユニットテスト、コンポーネントテスト、エンジン内シーンテストには GdUnit4。
   • 外部からのエンドツーエンド自動化、スクリーンショット、入力シミュレーションには PlayGodot。
   • プラットフォームやブラウザー向けのパッケージングに動作が依存する場合は、実際にエクスポートしたビルド。
4. 静的チェックだけで、実際のレンダリング、入力、エクスポート、デプロイが成功したと主張しないでください。

テストと実装

• 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。

実行する前にヘルパーのオプションを確認してください。プロジェクト独自のスクリプトが正式な手順である場合は、既存のコマンドを上書きしないでください。

エクスポートとデプロイ

1. エクスポートプリセットやデプロイの動作を作成または変更する場合は、references/deployment.md を読んでください。
2. プロジェクトで指定されているビルドディレクトリにエクスポートし、生成された成果物を確認してください。
3. Web ビルドの場合は、エクスポートしたものを配信してブラウザーで動作させ、アセットの読み込み、入力、ビューポートの動作、コンソールエラー、必要なクロスオリジン分離を確認してください。
4. CI を変更する場合は、未検証のワークフロー例をコピーせず、references/ci-integration.md を読んでください。
5. 本番環境へのデプロイは、別途認可が必要な境界として扱ってください。認可を得てデプロイした後は、CLI の正常終了だけで終わらせず、稼働中のデプロイ先を確認してください。

最後に、Godot のバージョン、実施したテストまたは実行時チェック、生成した成果物またはデプロイの状態、未検証の動作を報告してください。