誤った Godot コンテキストの問題
AI は、あなたがどの Godot にいるかを知りません。
AI ツールは Godot(ゴドー)のバージョンやエンジンを混ぜ合わせます。4.x プロジェクトに紛れ込む 3.x のパターン。ハルシネーションされたノード。御社の GDScript に入り込む Unity(ユニティ)の API。Scout(スカウト)は現行の Godot ドキュメントに照らして、すべての PR をレビューします。
Godot(ゴドー)を理解したレビュー
Scout(スカウト)が Godot の PR で検出するもの。
-
ハルシネーションされた API。
Godot(ゴドー)に存在しないクラス、メソッド、ノード。
-
Godot(ゴドー)に混入した Unity(ユニティ)の概念。
御社の GDScript に紛れ込んだ、別エンジン前提のコード。
-
古い 3.x パターン。
Godot(ゴドー)4 プロジェクトに中途半端に移植された古いチュートリアル。
-
誤った物理ボディ。
CharacterBody2D、RigidBody2D、StaticBody2D、Area2D の取り違え。
-
_process と _physics_process。
用途に対して誤ったループ。
-
ライフサイクルとクリーンアップの問題。
クリーンアップ漏れ、シーンツリーの問題、ティアダウンの破綻。
-
リスクのあるシグナルパターン。
技術的には動作するものの、シーンの見通しを悪くする接続。
-
シーンとリソースのドリフト。
プロジェクトに合わない Autoload、リソース、シーンのパターン。
-
規約ドリフト。
御社の STANDARDS.MD に反するコード。
-
非推奨の GDScript。
古いバージョンでは動作したものの、今日リリースすべきではない構文やパターン。
-
AI 風の差分。
AI 生成らしく見えるパターンを、人間によるレビュー対象としてフラグ付け。
-
パフォーマンスのアンチパターン。
_process 内の重い処理、キャッシュすべき割り当て、SceneTree をかき乱すシーン。
無料の Godot ドキュメントアシスタント
まずドキュメントに訊く。
次に PR をレビューする。
GDScout(ジー・ディー・スカウト)は、公式 Godot(ゴドー)ドキュメントに向けられた Scout(スカウト)です。質問すれば、GDScript または C# の引用付きの回答が返ってきます。アカウント不要。無料。
GDScout は質問するとき用。Code Review はマージするとき用。
2クリック。あとは動くだけ。
GitHubを接続。
Scoutがセットアップ。APIキー不要。YAML不要。
スタンダードを設定。
STANDARDS.MD は御社の Godot(ゴドー)プロジェクトのルールです。Scout(スカウト)は、新しいチームメイトにコードベースをどう説明するかを尋ねながら、その作成をお手伝いします。
コードをプッシュ。
オープン PR への各プッシュが、約2分で Godot(ゴドー)を理解したレビューをトリガーします。後続のコミットは、以前の指摘を参照したコンテキスト対応の再レビューを受けます。
人間のレビューがより良くなります。
チームは止まらず進み続けます。
よい点。
優れたパターンを指摘し、チームが繰り返せるようにします。
改善が必要な点。
御社のスタンダードと Godot(ゴドー)ドキュメントに紐づいた、具体的で実行可能な指摘。
検討すべき問い。
エッジケース。前提。誤バージョンのリスク。
人間レビュアー向けのブリーフ。
何が変わったか。何に注意すべきか。Godot(ゴドー)固有の判断がどこにあるか。
データコントラクトのチェック。
PR がスキーマのパス、フィールド、読み書きパターンに触れた際にフラグを立てます。
改善の提案。
問題の指摘だけでなく、具体的な次の一手。
なぜ作ったのか
ゲーム開発者による、ゲーム開発者のためのプロダクト。
Godot(ゴドー)コミュニティは、Surmado(スルマド)チームのメンバーがゲームのコーディングを始めた場所です。私たちは GDScout(ジー・ディー・スカウト)と Code Review を、自分たち自身のプロジェクトのために必要だったから作りました。試したどの AI ツールもバージョンを取り違え、存在しないクラスをハルシネーションし、別のエンジンのパターンを提案してきました。
これはさらなる AI の粗製コードではありません。すでに AI を使ってゲームを作っているチームのためのレビュー層です。
よくあるご質問
Surmado Code Review for Godot とは?
Surmado(スルマド) Code Review for Godot は、GitHub(ギットハブ)向けの AI プルリクエストレビュアーで、Godot(ゴドー)プロジェクトを公式 Godot ドキュメント、PR の差分、リポジトリのコンテキスト、チーム独自の STANDARDS.MD に照らしてレビューします。古い GDScript のパターン、ハルシネーションされた API、Unity(ユニティ)の概念、物理ボディの取り違え、ライフサイクルの問題、チームスタンダードからのドリフトを、プルリクエストがマージされる前に検出します。
GDScout とは?
GDScout(ジー・ディー・スカウト)は、games.surmado.com で提供されている Surmado(スルマド)の無料 Godot(ゴドー)ドキュメントアシスタントです。Surmado の AI エージェントである Scout(スカウト)を用いて、Godot に関する質問にプレーンな英語で答え、公式ドキュメントからの GDScript または C# の引用付きで回答します。
Surmado Code Review はどのような Godot のミスを検出できますか?
ハルシネーションされた API、非推奨パターン、誤バージョンの GDScript、Godot(ゴドー)コードに紛れ込んだ Unity(ユニティ)の概念、物理ボディの取り違え、_process と _physics_process の誤用、シーンとリソース構造の問題、ライフサイクルの問題、シグナルの問題、チームスタンダードからのドリフトです。
Surmado Code Review は GDScript と C# に対応していますか?
はい。Surmado(スルマド) Code Review は、Godot(ゴドー)ドキュメント、シーンとノードのコンテキスト、チームスタンダードを踏まえて、GDScript と C# の両方のプルリクエストをレビューします。
なぜ AI ツールは Godot のコードを間違えるのですか?
AI ツールは、異なる Godot(ゴドー)バージョンやエンジンのドキュメント、チュートリアル、サンプルを混ぜ合わせます。提案は一見正しく見えても、Godot 3.x の挙動、古い 4.x のサンプル、Unity(ユニティ)の概念、あるいは現行エンジンには存在しない API に依存していることがあります。
Surmado Code Review の料金はいくらですか?
月10 PRs まではクレジットカード不要で無料です。有料プランは月額 $15 で100 PRs、シートとリポジトリは無制限です。
コードを読んだり保存したりしますか?
いいえ。レビュー時にPRの差分とSTANDARDS.mdをLLM APIに送信してレビューを生成します。差分はレビュー投稿後に保持されません。お客様のコードを保存・記録したり、AIモデルの学習に使用したりすることはありません。当社のモデルでも、第三者のモデルでも同様です。残るのはPRに投稿されたレビューコメントのみで、お客様のGitHubリポジトリ上でお客様の管理下に置かれます。Code ReviewではAnthropicとOpenAIのみをAIプロバイダーとして使用しています。
Scoutは人間のコードレビュアーを置き換えますか?
いいえ。Scoutが最初のパスを担当するため、チームメンバーは判断が必要な部分に集中できます。Scoutは細かい点を拾い上げ、注目すべき箇所を指摘し、本当に重要なポイントをチームメンバーに示す人間レビュアー向けのブリーフを作成します。 当社のチームでは、Scoutの導入によりクローズまでの時間が約3分の1に短縮されました。人間レビュアーが誤字や規約違反を探す必要がなくなり、アーキテクチャ、意図、トレードオフのレビューに集中できるからです。レビューによる学びは失われません。ただ、より速くなるだけです。
他の質問を見る
Scout とは?
Scout(スカウト)は Surmado(スルマド)の AI エージェントです。ひとつのエージェントが AI 可視性テスト、サイト監査、コードレビュー、そして GDScout(ジー・ディー・スカウト)のようなドキュメントアシスタントを支えています。GDScout は Godot(ゴドー)ドキュメント向けの Scout です。Surmado Code Review は GitHub(ギットハブ)プルリクエスト向けの Scout です。
GDScout と Surmado Code Review はどのように連携していますか?
両者は同じ Godot(ゴドー)ドキュメントインデックスを共有しております。GDScout(ジー・ディー・スカウト)はそれを質問応答に用います。Surmado(スルマド) Code Review は PR レビューの中で、差分、リポジトリのコンテキスト、チームスタンダード、Surmado のレビューアーキテクチャと並べて利用します。
これは単にドキュメント検索をコードレビューに付けただけですか?
いいえ。Godot(ゴドー)ドキュメントはひとつの入力に過ぎません。Surmado(スルマド) Code Review は、人間レビュアー向けのブリーフを作成する前に、プルリクエストの差分、リポジトリのコンテキスト、チームスタンダード、レビュー特有のチェックも評価します。
AI ツールは Unity と Godot の概念を混同してしまうことがありますか?
はい。AI コーディングツールは、ゲームエンジン関連に見えても Godot(ゴドー)プロジェクトには属さない提案を生み出すことがあります。Surmado(スルマド) Code Review は、Unity(ユニティ)の概念、別エンジン前提のコード、ハルシネーションされた API を、マージ前にフラグ付けします。
Surmado Code Review は Godot 向け初の AI コードレビューですか?
Surmado(スルマド)は、これが Godot(ゴドー)開発者、Godot ドキュメント、GDScript のレビューパターンに特化して構築された最初の AI プルリクエストレビュアーだと考えております。
Godot 向けの無料 AI コードレビュアーはありますか?
はい。Surmado(スルマド) Code Review には、クレジットカード不要で月10 PRs の無料レビューが含まれております。
GDScout は無料ですか?
はい。GDScout(ジー・ディー・スカウト)は games.surmado.com でアカウント登録不要、無料でご利用いただけます。
Surmado Code Review は GitHub で動作しますか?
はい。Surmado(スルマド) Code Review は GitHub(ギットハブ)に接続し、プルリクエスト上に直接レビューを投稿します。
Surmado はどの Godot バージョンに対応していますか?
Surmado(スルマド) Code Review と GDScout(ジー・ディー・スカウト)は、現行の公式 Godot(ゴドー)ドキュメントに基づいております。Surmado は、Godot が新しいリリースを出すたびに、ドキュメントのグラウンディングを最新に保つことをお約束します。
動作をカスタマイズしたいですか?設定ガイドをご覧ください。