コンテキストウィンドウを管理する

ラボを準備する

1. Galaxium Travels repository を clone します。

   git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

2. File をクリックし、次に Open Folder をクリックします。

3. clone した galaxium-travels ディレクトリに移動して開きます。

4. ナビゲーションバー横の Bob アイコンをクリックして Bob のチャットインターフェースを開きます。 または、Option + Command + B（macOS）または Ctrl + Alt + B（Windows）のショートカットを使います。

5. チャット入力欄で /init を実行します。Bob が repository をスキャンし、 プロジェクトルールを含む AGENTS.md ファイルを作成します。求められたら Approve todo tools for task をクリックします。

   Bob が完了を報告するまで待ちます。この AGENTS.md は後で コンテキストウィンドウの内訳に Rules として表示されるため、ベースラインを測定する前に repository に存在している必要があります。

コンテキストウィンドウの内訳を確認する

新しいベースラインを取得してから、内訳を確認します。

1. チャットパネル上部の + をクリックして、新しい task を開始します。

2. 少ないトークンで済む最小限の prompt を送信します。

   ひとことだけ、こんにちはと返して。

   Bob の返信を待ちます。

3. チャットパネル右上の token usage indicator をクリックして、使用量の内訳を確認します。

Galaxium Travels でこのやり取りをした後、数値は多少変わりますが、次のような値に近くなるはずです。

Total used が 8.5k から大きく外れている場合は、新しい task を開始し、その 1 つの prompt だけを送ったか確認してください。

Tool definitions は通常、最大の固定カテゴリです。MCP サーバーや組み込みツールのスキーマは、実際に呼び出さなくても読み込まれます。Rules は AGENTS.md のようなプロジェクトファイルから来ます。Skills は、task 中に Bob が skill を読み込むと後で増えることがあります。

1. 各カテゴリを確認します。内訳は、トークンがどこに使われているかを示します。

   カテゴリ	内容
   System prompt	このセッションにおける Bob の中核指示
   Tool definitions	Bob の組み込みツールと接続された MCP tools のスキーマ
   Rules	プロジェクトやモードからのカスタム指示（custom rules、たとえば AGENTS.md）
   Skills	Bob が読み込んだ skills の指示（UI には Skills (1 loaded) のように表示されることがあります）
   Messages	task 内のあなたの prompts、Bob の返信、ツールアクティビティ。これはトークンとして数えられる transcript です。

   Estimated breakdown の下には次があります。

   • Reserved for model response: Bob がすぐに上限に達せず返信できるように予約されるトークン。
   • Available space: Bob が圧縮を始めるまでにまだ使える推定トークン数。

   Galaxium では、固定カテゴリ（System prompt、Tool definitions、Rules、Skills）だけで、実際の作業前におよそ 8k になります。これは自分で入力していなくても、毎ターン支払うコストです。

prompt で Messages を増やす

同じ task にとどまったまま、transcript を増やす prompt を送ります。

1. ファイル一覧を依頼します。

   このディレクトリ内のすべてのファイルを一覧表示して。

   求められたら読み取り操作を承認します。Bob が repository 内のファイルを一覧表示します。

2. 何が変わったかを比較します。もう一度内訳を開きます。Galaxium Travels では、次のような値に近くなるはずです。

   Category	Fresh task	After list-files	Sustained work (reference)
   System prompt	1.5k	1.5k	1.5k
   Tool definitions	5.1k	5.1k	5.1k
   Rules	830	830	830
   Skills	454	454	1.2k（1 loaded）
   Messages	590	4.2k	19.4k
   Total used	8.5k（約 3%）	12.1k（約 4%）	28.0k（約 10%）
   Available space	241.5k	237.9k	222.0k

   Messages はこの時点で約 4.2k になるはずです。かなり大きい場合は、Bob がこの例より多くのファイルを読んだということですが、それでも問題ありません。重要なのは、固定カテゴリが変わらないまま Messages が増えたことです。

   一覧出力とツールアクティビティは transcript に残ります。System prompt、Tool definitions、Rules、Skills は、1 回の list-files prompt の後では変わりません。

   右端の列は、より多くの読み取りや follow-up prompts を含む長めの Galaxium セッションの例です。Bob が skill を読み込むと Skills が増えることがあります（この例では 454 から 1.2k）。時間がたつと、通常もっとも速く増えるのは Messages です。

   1 回の list-files prompt で、Galaxium では Messages に約 3.6k が追加されます。固定 overhead は約 8k のままです。repository の探索は、overhead が変わらなくてもコンテキストをすばやく消費します。

新しいコンテキストウィンドウを作る

同じプロジェクト内で新しい task を開始します。古い task（会話）は履歴に残ります。

1. チャットパネル上部の +（New task）をクリックします。

   インジケーターがリセットされます。Messages は小さな値に戻ります。System prompt、Tool definitions、Rules、Skills は、おおよそベースラインまで再読み込みされます。

2. 離れた task は task リストに残り、いつでも戻れます。その task は独自の transcript と token count を保持します。新しい task で作業している間、Bob はそれを使いません。

   次のような場合は新しい task を開始してください。

   • 話題や作業目標を切り替えるとき。
   • Messages が品質やコストに影響するほど大きくなったとき。Galaxium では、Messages が 19.4k ならリセットの目安として妥当です。
   • 計画が終わり、実装用にクリーンな task が欲しいとき。複雑な機能を計画して実装する を参照してください。

   振り返り: 新しい task で内訳を開いてください。どのカテゴリがベースラインに戻りましたか。古い task にとどまっていたら、どのカテゴリが増え続けていたでしょうか。