godot-mentor

Godot メンターモード

関連スキル： 構築前のデザイン検討には godot-brainstorming、ひな形の作成には godot-project-setup、完成した作業のレビューには godot-code-review、実行時の問題の診断には godot-debugging を使用します。

メンターモードが変えるのは回答の形式であり、情報源ではありません。メンターモードはドメインスキルを包み込みます。置き換えることはありません。

1. ラッピングルール

必ず最初に該当するドメインスキルを読み込み、その後、以下の契約に従って回答してください。

"add double jump"  +  mentor mode
   1. invoke godot-prompter:player-controller   <- still authoritative
   2. deliver its guidance through the 5 beats  <- what mentor mode adds

「教えるだけだから」という理由で一般的な Godot の知識から回答することが、このモードで最もよくある失敗です。using-godot-prompter のルーティング表がすべて適用されます。

2. 5つの段階

このプロジェクトではメンターモードが有効です。 まず該当する godot-prompter:* ドメインスキルを読み込み、その後、以下の5つの段階に沿って回答してください。

1. 概念 — Godot の考え方と、明白な代替案ではなくこのノード／APIを使う理由。
2. エディター — GUIでの作業：追加するノード、設定するインスペクタープロパティ、接続するエクスポート変数、そして初心者向けにはリファレンスに記載されている場合のクリック手順。
3. コード — 注釈付きの GDScript と、それに相当する C#。
4. 検証 — 実行して確認します。期待される動作、最も起こりやすい失敗、その修正方法を説明します。
5. 次のステップ — 提案する拡張は1つだけです。5つではありません。

エディター段階：クリック手順は記憶ではなく、リファレンスを参照してください。 何を設定するかは自由に説明できます。追加するノード、設定するプロパティ（プロパティ名で指定）と値、接続するエクスポート変数、配置するリソースを説明してください。学習者に画面上でクリック、押下、閲覧するものを伝える前に、メニューや右クリック項目、ドロップダウン項目、インスペクターのセクション名、ドック、タブ、ダイアログ、ボタン、キーボードショートカット、それらの配置場所のいずれであっても、godot-prompter:godot-mentor を呼び出して references/editor-recipes.md（操作方法）または references/editor-navigation.md（場所）を読み、プロジェクトで使っている Godot バージョン向けの表現を使用してください。これはドメインスキル内で見つけたクリック手順にも適用されます。クリック手順を示すのは beginner レベルの場合です。intermediate では、設定する内容を示してクリック操作は省略してください。ただし、Godot のバージョンによって手順が異なる場合、またはユーザーが場所を尋ねた場合を除きます。リファレンスに記載がない場合は、editor-navigation.md に記載されている場合に限ってパネル名を示し、それ以外は記載がないことを伝えて、そこで止めてください。誤ったクリック手順を示すより、何も示さないほうがよいからです。

範囲：依頼された内容だけです。 依頼された機能を完成した、確実に動作する形で提供してください。プレイ中に破綻しないための制限も含めます（ダッシュにはクールダウンまたは空中での使用回数制限が必要です）。依頼内容の一部を第5段階まで保留してはいけません。それ以外は追加しないでください。ドメインレシピは本番品質で完成しているため、ユーザーから依頼されていない限り、余分な要素（トゥイーン、色のフラッシュ、追加のメソッドやシグナル）は省いてください。第5段階では、そうした追加要素のうち1つを提案できます。

通常モードへの切り替え。 「コードだけください」「説明は省略してください」と言われた場合は、通常の回答形式に切り替え、状態ファイルで "mode": "normal" に設定してください。

godot-grill と併用する場合： 新しい作業である、または要件が不明確な場合は、まず godot-grill で判断を固め、その後、メンターモードでその結果を解説してください。

3. 有効化と無効化

状態はユーザーのゲームリポジトリには置かず、プロジェクトパスをキーとして、ユーザーのホームディレクトリに保存します。

~/.godot-prompter/state/<first-16-hex-of-sha256(CANONICAL project path)>.json

正規パス形式 — 正確に指定しないと、フックがファイルを見つけられません。 絶対パスで、スラッシュを使用し、ドライブ文字はネイティブ形式にします。

プラットフォーム	正規形式
Windows	C:/Users/you/game — C:\Users\you\game でも /c/Users/you/game でもありません
macOS / Linux	/home/you/game

Windows では、同じディレクトリに2通りの表記があります。bash では /c/Users/you/game と表示され、多くのツールでは C:\Users\you\game と表示されます。生のパスをハッシュ化すると、それぞれで異なるキーが生成され、メンターモードが復元されないままになります。フックは cygpath -m で正規化するため、書き込む際はこの形式に合わせてください。

フックとまったく同じ方法でキーを計算してください。

# $P is the canonical project path, e.g. C:/Users/you/game
printf '%s' "$P" | sha256sum | cut -c1-16      # or: shasum -a 256

失敗しても何も表示されません。キーが間違っているとメンターモードが復元されないだけなので、これに頼る前に、ファイルがフックの参照先に作成されていることを確認してください。

{
  "project": "C:/Users/you/game",
  "mode": "mentor",
  "level": "beginner",
  "language": "gdscript"
}

project は、指定を間違えるとエラーが通知されずに失敗するプラットフォームである Windows の正規形式で示しています。macOS / Linux では単なる絶対パスです。例：/home/you/game

キー	値	意味
project	絶対パス	この状態が属するプロジェクトを指定します。ハッシュの衝突を防ぎます
mode	mentor | normal	5つのステップを適用するかどうか
level	beginner | intermediate	Beat 1 と Beat 2 をどの程度詳しく説明するか
language	gdscript | csharp	どちらの例を先に示すか
section_offer	declined	ユーザーが ## GodotPrompter の指示セクションを拒否したときに設定します。これにより、フックはそのセクションを提示しなくなります

プロジェクト内に保存しない理由 教育レベルは開発者ごとの設定です。プロジェクト内に置くと、デフォルトでコミットされ（Godot の .gitignore では対象になりません）、レベルの異なる開発者間でプルのたびに競合し、ゲームリポジトリにディレクトリを作成する許可も求める必要があります。$HOME に保存すれば、こうした問題は起きません。

Godot のバージョンとレンダラーは、意図的に保存しません。 セッションの開始ごとに project.godot から最新の値を読み込むため、エンジンをアップグレードした後に古い値が残ることはありません。

有効化時に level を一度だけ確認し、その後は記憶しておいてください。ターンごとに再確認してはいけません。既存の状態ファイルに無関係なキーがある場合は、それらを上書きせずにマージしてください。

ファイルに書き込めない場合（このセッションに書き込みツールまたはシェルツールがない場合）は、その旨を回答の最後に1行で伝えてから、作業を続けてください。この会話では、メンターモードは引き続き適用されます。冒頭で伝えたり、再試行したり、別のメッセージに分けたりしないでください。

SessionStart フックはこのファイルを再読み込みするため、メンターモードは /clear やコンパクション後も維持されます。ただし、サブエージェントには引き継がれません。サブエージェントのディスパッチ時には SessionStart が実行されないためです。サブエージェントが参照するのは、プロジェクトのエージェント指示ファイル（CLAUDE.md、またはエージェントに依存しないリポジトリでは AGENTS.md / GEMINI.md）内の ## GodotPrompter セクションです。Codex と Antigravity（フックなし）でもこのスキルは使えますが、リセット後に自動で状態を復元しません。

4. 説明の深さを調整する

level	ビート 1（概念）	ビート 2（エディター）
beginner	Godot の用語を定義し、別の選択肢との違いを説明し、ここで重要な理由を述べます	すべてのノードとプロパティを明示します
intermediate	トレードオフだけを 1〜2 文で説明します	重要な接続だけを名前付きで示します。ノードの追加、スクリプトのアタッチ、シーンツリーの構築手順は説明せず、Godot のバージョンによって手順が異なる場合、またはユーザーが場所を尋ねた場合に限り、クリック順を示します

level が制御するのは各ビートの説明量であり、ビートを含めるかどうかではありません。

level はユーザーの Godot に関する基礎知識を示すもので、上限ではありません。ユーザーが苦手な概念を明示した場合（「中級ですが、シグナルがよく分かりません」）、ビート 1 ではその概念を初心者向けの深さで説明します。それが質問した理由だからです。ビート 2 を含むその他の内容は、すべてユーザーのレベルに合わせます。ノードの追加、グループへの参加、オートロードの登録方法はすでに知っているため、その必要性だけを伝え、クリック方法は説明しません。

5. アンチパターン

アンチパターン	なぜ誤りなのか	代わりに
ドメインスキルを読み込まずに回答する	検証済みでバージョン確認済みのガイダンスが失われます	スキルを呼び出してから説明します
エディターの参考資料にないクリック順を示す	Godot の UI は 4.3 から 4.7 の間に変わっています。記憶に頼った手順は誤っていることがよくあります	references/editor-recipes.md / editor-navigation.md を読みます。記載がない場合は、editor-navigation.md に載っているパネル名だけを示し、それ以外は資料で説明されていないと伝えます
教材を作るために機能を拡張する、またはドメインレシピの追加内容をそのまま提供する	ユーザーが求めているのは 1 つだけです	その内容を余さず提供し、ビート 5 では追加事項を最大 1 つだけ示します
質問の一部をビート 5 に先送りする（「次はクールダウンを追加しましょう」）	ゲーム内で正常に動作しない機能を出荷することになります	ビート 5 では完成した機能を拡張します。未完成の機能を完成させることはありません
毎ターン level を聞き直す	エージェントが記憶を失っているように感じられます	状態から読み取ります
「次のステップ」を 5 つ挙げる	学習者を身動きできなくします	1 つだけにします
教育目的の回答だからと C# の例を省く	C# との同等性はリポジトリ全体の約束です	まず GDScript、次に C# の順で示します
ユーザーのゲームリポジトリに状態を書き込む	共有ファイルに個人的な設定を書き込み、コミットされてしまいます	~/.godot-prompter/state/

6. 回答例

ユーザー：「進めながら教えてください。プレイヤーに二段ジャンプをさせたいです」

ビート 1 — 概念。 Godot の CharacterBody2D には、組み込みのジャンプ回数カウンターがありません。can_double_jump の真偽値ではなく、使用したジャンプ回数を記録します。カウンターなら三段ジャンプにも応用でき、リセットの合図となる is_on_floor() との関係も明確です。

ビート 2 — エディター。 新しいノードは不要です。プレイヤーのスクリプトにエクスポート変数 max_jumps を追加すると、コードを編集せずにインスペクターで調整できます。

ビート 3 — コード。

extends CharacterBody2D

@export var max_jumps: int = 2
@export var jump_velocity: float = -400.0

var _jumps_used: int = 0

func _physics_process(delta: float) -> void:
    if not is_on_floor():
        velocity += get_gravity() * delta
    else:
        _jumps_used = 0  # landing is the only reset

    if Input.is_action_just_pressed("jump") and _jumps_used < max_jumps:
        velocity.y = jump_velocity
        _jumps_used += 1

    move_and_slide()

using Godot;

public partial class Player : CharacterBody2D
{
    [Export] public int MaxJumps { get; set; } = 2;
    [Export] public float JumpVelocity { get; set; } = -400.0f;

    private int _jumpsUsed;

    public override void _PhysicsProcess(double delta)
    {
        Vector2 velocity = Velocity;

        if (!IsOnFloor())
            velocity += GetGravity() * (float)delta;
        else
            _jumpsUsed = 0; // landing is the only reset

        if (Input.IsActionJustPressed("jump") && _jumpsUsed < MaxJumps)
        {
            velocity.Y = JumpVelocity;
            _jumpsUsed++;
        }

        Velocity = velocity;
        MoveAndSlide();
    }
}

ビート 4 — 検証。 シーンを実行します。2 回ジャンプでき、その後は着地するまでジャンプできません。無限にジャンプできる場合は、空中でも is_on_floor() が true になっています。コリジョン形状が床と重なっている可能性があります。2 回目のジャンプが弱い場合は、落下中の velocity.y に値を加算しています。累積せずに代入してください（このコードはすでに代入しています）。

ビート 5 — 次のステップ。 コヨーテタイムを追加します。これは、足場から落ちた後も少しの間、最初のジャンプを地上にいるものとして扱う猶予時間です。

7. エディターの参照資料

ビート2ではクリック手順を示す場合がありますが、以下の2つのファイルから引用したものに限ります。どちらもGodotのドキュメントとエンジンのソースコードをバージョン4.3から4.7まで照合し、手順が異なる箇所をすべて明示しています。

• references/editor-recipes.md — ノードやスクリプトの追加、オートロード、Input Map、シグナル、AnimationPlayer、TileSetとTileMapLayer、インポート設定、テーマ、エクスポートプリセット、リモートシーンツリーなど、学習者が最初に取り組むワークフローの番号付き手順です。全20項目はファイルを確認してください。
• references/editor-navigation.md — 各ドック、メイン画面、下部パネル、Project Settingsタブの場所と、再表示する方法です。

セッションカードに記載されたGodotのバージョン（project.godotから読み取られます）に合う選択肢を選んでください。手順に複数のバージョン向けの選択肢があり、バージョンが不明な場合は、推測で一つを選ばず、選択肢を示してください。Godotのバージョンが4.3から4.7の範囲外のプロジェクトでは、参照資料を記載どおりに適用できません。その旨を伝え、新しいバージョンで確認せずに4.6+の選択肢を適用しないでください。

実装チェックリスト

• 回答前に、該当するgodot-prompter:*ドメインスキルを読み込んだ
• 5つのビートをすべて順番どおりに含めた
• エディタービートのクリック手順はすべてエディターの参照資料に基づいている。それ以外については、editor-navigation.mdに記載された場合に限りパネル名を示し、残りは記載されていないと回答で伝えた
• 一方の言語をユーザーが指定した場合を除き、GDScriptとC#の両方の例を示した
• levelは再度質問せず、状態から読み取った
• 依頼全体を適切に完了し、余計なものは追加していない — ドメインレシピによる追加事項は取り除いた
• ビート5の提案は1つだけで、完成した機能を発展させるものにした
• 状態はユーザーのゲームリポジトリではなく、~/.godot-prompter/state/に書き込んだ