gdharness

gdharness

エージェントには、実行中のゲームは見えません。 スクリプトを読み、あとは推測するしかありません。ボタンが画面に表示されているか、パネルが更新されたか、そのエラーが重要だったか。

gdharnessを使えば、エンジンに答えさせることができます。画面に表示されている内容、コントロールの位置、プロパティの現在値、コンソールの出力、何がどの行で壊れたのか。

インストール

これをエージェントに渡してください。

Install gdharness here by following https://aureliolo.github.io/gdharness/agent.md,
then tell me what it asked you to recommend back to me.

または自分で設定し、ハーネスを選んでください。 aureliolo.github.io/gdharness。

このための作業ループ

editor_run      { "op": "start", "projectPath": "C:/games/hall" }
runtime_inspect { "op": "find", "says": "Buy" }              // the button, by the word on it
runtime_input   { "op": "click", "nodePath": "/root/Hall/Ledger/BuyButton" }
runtime_inspect { "op": "text", "nodePath": "/root/Hall/Ledger" }   // what the panel says now
editor_output   { "projectPath": "C:/games/hall" }           // errors and warnings, with backtraces

開いているエディターがゲームを実行するため、デバッガーがゲームを一時停止します。これにより、ブレークポイントを設定し、停止時にスコープ内の変数を読み取れます。

すべての回答は、リクエストをそのまま繰り返すのではなく、処理後にエンジンから読み取ります。回答できないツールは、空の回答を返すのではなく、現在の状態と状態を変える方法を伝えます。そのため、成功した呼び出しは、内容が正しく理解された呼び出しです。

概要

必要条件	Godot 4.7 以降、Node 22 以降。Bun 1.4 でも動作します。
提供内容	domain_verb 形式の名前を持つ30個のツール、4つの godot:// リソース、3つのプロンプト
接続先	開いているエディター、実行中のゲーム、ディスク上のプロジェクト
対応環境	35種類。ハーネスにプロジェクト設定があれば、プロジェクト内のどこにでも記述できます。
スキル	.agents/skills に記述され、主要なハーネスがすべて読み込みます。
インストール	npm、またはSBOMとSLSA Build Level 3を備えたSigstore署名済みアーカイブ
検証済み	CIでWindows、Linux、macOS上のGodot 4.7.2を使い、すべてのツールを実行して検証済みです。
状態	1.0：すべてのリリースはパッチリリースです。バージョン更新の意味

古い4.xでも動作する可能性は高いですが、テストはしていません。

ドキュメント

aureliolo.github.io/gdharness：インストール方法、各要素の連携方法、およびすべてのツール、操作、引数について説明しています。

SECURITY.mdでは、問題の報告方法を説明しています。 CONTRIBUTING.mdでは、変更を受け入れるための要件を説明しています。

プロジェクト

GoPeak v2.3.9（2026年9月、MIT）からのフォークです。元となるMCPサーバー godot-mcp はSolomon Eliasによるもので、GoPeakはHaD0Yunによるものです。その後、セキュリティ強化、簡潔化、効率化を目的に全面的に作り直しました。

Godot Foundationとは関係ありません。