Kiro CrewのサブエージェントをHaiku 5.5で最小のコンテキストで起動できるか確認してみた

Kiro CrewのサブエージェントをHaiku 5.5で最小のコンテキストで起動できるか確認してみた

Kiro Crewのサブエージェントがコンテキストウィンドウにどの情報を読み込んでるか気になりますよね。ということで調べてみました
2026.11.18

はじめに

最近Kiro CrewでCIのような単純な作業を実行する時に、サブエージェントで安価なモデルを立てて任せることがよくあります。
私はサブエージェントにHaiku 5.5を使うことが多いのですが、作業量に対して思ったよりサブエージェントがクレジットを消費してるなーと思うことがあります。

そこでふと疑問に思ったのですが、サブエージェントを起動した時点でコンテキストウィンドウには何が入っているのでしょうか?
また、コンテキストウィンドウをほぼ空の状態で作業を始めることはできるのでしょうか?
特にHaiku 5.5の場合だと、クレジットの倍率は0.06xで、100Kトークンを超えるリクエストは0.3xになります。

何がなんでも100Kトークン以内で安く使いたいですよね?
そんなサブエージェント事情が気になったので、Kiroと会話しながら確かめてみました。
それでは、サブエージェントのコンテキストを覗いてみましょう!

サブエージェントの起動オプション

Kiro Crewのサブエージェントは、親の会話とは別のセッションで起動します。
親の会話の途中経過は見えませんが、ユーザーの好みやlesson、プロジェクトの情報は引き継いだ状態で起動します。

サブエージェントの起動には、spawn_runというツールを使います。

このツールには、サブエージェントに引き継ぐコンテキストを選ぶオプションが3つあります。
include_memory、include_lessons、include_projectの3つで、どれも既定値はtrueです。
falseにすると、そのグループを引き継がずにサブエージェントを起動できます。

このほかにサブエージェントを起動するディレクトリを指定するcwdというオプションもあります。
指定しない場合はサブエージェントごとに作られる専用のディレクトリで起動します。

3つともfalseにしてHaiku 5.5を起動する場合は、次の引数でspawn_runを呼び出します。

{
  "task": "依頼文",
  "model": "claude-haiku-5.5",
  "include_memory": false,
  "include_lessons": false,
  "include_project": false
}

ただ、ドキュメントにはそれぞれのグループに何が入っているかは書かれていませんでした。
これだとどれを除外すれば実際に何が減るのかいまいち分からないですね。
ということで、サブエージェントのログから実際に読み込まれているものを確認してみます。

セッションログから確認する

Kiro Crewはサブエージェントのセッションのログをファイルに残しています。
このログにはモデルに送られた内容がそのまま入っているので、読めば何が読み込まれているかを確認できます。

ログの場所と読み方

今回見るファイルは次の3か所にあります。

~/.kiro/
├── crew/
│   ├── subagents/
│   │   └── <実行ID>/
│   │       └── state.json        # session_id が入っている
│   └── usage/
│       └── tokens/
│           └── <日付>.jsonl      # 1回の依頼ごとに1行。context_used がトークン数
└── sessions/
    └── <ディレクトリ>/
        └── <session_id>/
            └── messages.jsonl    # モデルに送られた内容。1行に1つずつデータが並ぶ

ログはJSON形式で1件ずつ読むのは大変なので、ここからの集計はKiroに頼んで抜き出してもらいました。

例えば何も指定せずに起動したサブエージェントのコンテキストウィンドウには、こんな感じで入っていました。

既定構成のコンテキストウィンドウの中身

左の4つがモデルに送られた最初のメッセージの中身です。
残りはツールの定義やsteeringなど、最初のメッセージとは別に渡されたものでした。

state.jsonのsession_idと同じ名前のフォルダに、messages.jsonlがあります。
messages.jsonlは、1行に1つずつJSONのデータが入ったファイルです。
それぞれのデータには何のデータかを表すtypeという項目があります。
typeはたくさんありますが、起動時に何が渡されたかが分かるのは次の4つです。
残りは、サブエージェントの返答やツールの呼び出しなど、起動したあとの動きです。

type 入っているもの
user モデルに送られた最初のメッセージそのもの
session_start 起動時の指示とsteeringファイルの中身
steering_inclusion steeringファイルの一覧
usage_summary contextBreakdown(ツール定義やsteeringなど、区分ごとの文字数)

トークン数は~/.kiro/crew/usage/tokens/<日付>.jsonlにありました。
該当するサブエージェントの行を抜粋してみます。

{"slot": "subagent:4a42fe0485e587eb", "model": "claude-haiku-5.5", "credits": 0.07803083383084576, "context_used": 43648, "context_window": 1000000, "harness": "kas", "acp_session_id": "sess_275f3f1f-02a2-4187-98e0-5b4dfa014d5e"}

context_usedがその時点でコンテキストウィンドウに入っていたトークン数だと思われます。
この行はサブエージェントに1回依頼するごとに1行ずつ追加されます。
追加で質問すると行が増えて、会話の履歴の分だけcontext_usedも増えていました。

読み込まれたものと読み込まれなかったもの

では、最小構成と既定構成のHaiku 5.5を1回ずつ起動してログを比べてみます。
最小構成はinclude_memory、include_lessons、include_projectの3つをfalseにしたもので、既定構成は何も指定せずに起動したものです。
どちらも同じ依頼文で、cwdは指定していません。

最小構成と既定構成で、最初のメッセージに何がどれだけ入っていたかを図にしてみました。
両方に同じように入っていた項目は、灰色にして左に寄せています。

最初のメッセージの中身

メッセージは、最小構成が33,811文字、既定構成が98,123文字でした。
かなり差がありますねー
灰色の同じ項目には、システムプロンプト(AGENT SYSTEM PROMPT)の24,806文字や、依頼文などが入っています。

既定構成にだけ入っていたのは、memory(ユーザーの好み)、lesson(過去の訂正の記録)、USER PROFILE(ユーザーの職種や技術レベル)、DOCUMENTATION(Kiro Crewのドキュメントの場所)です。
include_*で除外される項目の中身はこれでした。
memoryは合計で約25,000文字、lessonは約38,600文字ありました。
私の環境ではlessonがかなり溜まっていたので、ここが一番大きかったみたいです。
不要なものも多かったので定期的にお掃除しないといけないですね。

反対に、最小構成にだけ入っていたのはCONTEXT SCOPEです。
中身はこんな感じでした。

[CONTEXT SCOPE]
Your parent withheld: memory (user preferences, projects, prior sessions); lessons (learned corrections, user profile); project (docs pointer, steering files, project directory).
If the task needs any of it, say it was not provided and ask the parent -- do not guess.
[End of context scope]

親が除外したグループと、必要なら推測せずに親に聞くように、という内容が書かれていました。
この文章は、include_*のどれかをfalseにすると自動で追加されるようです。
除外した情報を適当に推測しないように指示が書かれているのはいいですね。
ちなみに、projectにはsteering filesも含まれると書かれていますが、後で確かめるとプロジェクトのsteeringは除外されていませんでした。

steeringは、最初のメッセージとは別のsteering_inclusionの行で渡されています。
こちらはどちらの構成でも、~/.kiro/steering/の同じ7ファイルが入っていました。

最後に、トークン数とクレジットです。
最小構成はcontext_usedが42,415トークンで、クレジットは約0.06でした。
既定構成はcontext_usedが92,386トークンで、クレジットは約0.12でした。
最小構成にすると、トークン数もクレジットもおよそ半分になっています。
既定構成だと、最初のリクエストの時点で、0.06xの対象となる100Kトークンまで残り約7,600トークンしかありませんでした。

include_projectで除外されるもの

あれ?memoryとlessonは除外されたのが分かりましたが、include_projectは何を除外してるんだろう..?
もうちょっと調べてみましょう。

include_projectはspawn_runの3つのオプションのうち、プロジェクトの情報をサブエージェントに引き継ぐかを決めるものです。

先ほどの比較ではinclude_project=falseでも~/.kiro/steering/のsteeringは除外されていませんでした。
ただ、このときはcwdを指定していないので、サブエージェントの作業ディレクトリにはプロジェクトのsteeringもAGENTS.mdもありません。
そこでcwdにテスト用のディレクトリを指定して、include_projectだけを変えて比べてみます。

テスト用のディレクトリを用意する

cwdに指定できるのはsubagent_cwd_allowed_rootsに設定されたディレクトリの配下だけです。

今回は~/workplaceの配下にctx-probeというディレクトリを作り、合言葉を書いたファイルを2つ置きました。
1つ目は~/workplace/ctx-probe/AGENTS.mdです。

# 実測テスト用のAGENTS.md(テスト後に削除する)

合言葉: CANARY-AGENTS-4402

2つ目はプロジェクトのsteeringとして、~/workplace/ctx-probe/.kiro/steering/probe.mdを置きました。

# 実測テスト用のプロジェクトsteering

合言葉: CANARY-STEER-7731

合言葉がログに出てくれば、そのファイルがサブエージェントに渡ったと分かります。
このディレクトリをcwdにして、include_memoryとinclude_lessonsはfalseのまま、include_projectだけをfalseとtrueに変えてHaiku 5.5を起動しました。

除外されたのはプロジェクトの案内文だけ

最小構成と既定構成のときと同じように、最初のメッセージの中身を図にしてみました。

include_project で比べた最初のメッセージ

include_project=trueの方にだけDOCUMENTATION(292文字)とPROJECT(275文字)が入っていました。
DOCUMENTATIONにはKiro Crewと一緒にインストールされる、Kiro Crew自体の使い方を書いたドキュメントのフォルダの場所、PROJECTにはcwdに指定したディレクトリのパスが書かれています。
CONTEXT SCOPEもtrueの方は除外したグループからprojectが消えて、284文字から225文字に減っていました。
最初のメッセージはfalseが32,468文字、trueが33,047文字で、差は約580文字です。

一方で合言葉はどちらのログにも出てきました。
出てきた場所は最初のメッセージではなく、session_startの行にあるsteeringDocumentsです。
渡されたsteeringの一覧を出してもらいました。

workspace ~/workplace/ctx-probe/AGENTS.md
workspace ~/workplace/ctx-probe/.kiro/steering/probe.md
global ~/.kiro/steering/aws-agent-toolkit.md
global ~/.kiro/steering/claude-backend-search.md
global ~/.kiro/steering/github-pr-approval.md
global ~/.kiro/steering/instructions.md
global ~/.kiro/steering/natural-japanese.md
global ~/.kiro/steering/svg-output.md
global ~/.kiro/steering/task-intake.md

これはinclude_project=falseの方のログです。
trueの方もまったく同じ9ファイルでした。
scopeがworkspaceの2つがcwdに置いたAGENTS.mdとprobe.mdです。
include_projectをfalseにしても、プロジェクトのsteeringとAGENTS.mdは除外されていませんでした。
トークン数も、falseが39,498トークン、trueが39,844トークンで、ほとんど変わっていません。

逆に言うと、cwdを指定しなければプロジェクトのsteeringとAGENTS.mdは読み込まれません。
最小構成と既定構成の比較で渡されていたのが、~/.kiro/steering/の7ファイルだけだったのはこのためです。

include_* を false にすると除外されるもの

include_projectをfalseにしても削減できたのは約580文字だけでした。
steeringはinclude_projectに関係なく読み込まれるので、プロジェクトのsteeringが多い場合でもfalseにして減る量はあまり変わらないと思います。
trueにしておけば、サブエージェントは作業するディレクトリのパスを把握した状態で起動できます。
そのため、基本的にはinclude_projectはtrueのままでいいかなと思いました。

最小構成でも残るもの

では、3つともfalseにした最小構成では、何が残っているのでしょうか?

最小構成のコンテキストウィンドウの中身

最小構成でも、全体で約92,000文字が読み込まれていました。
システムプロンプト、ツール定義、steeringの3つで約78,600文字あり、これはinclude_*をどう組み合わせても残ります。
steeringは、~/.kiro/steering/のうちinclusion: alwaysの7ファイルだけで、autoやfileMatchのファイルは入っていませんでした。

エージェントを変えて起動してみる

最後にちょっとおまけです。
include_*を全部falseにしても、約78,600文字が残ってしまいました。
せっかくなので、他にも削れるところがないか探してみることにしました。

最小構成でも残っていたシステムプロンプトとツール定義は、Kiro Crewの標準のエージェント(kirocrew)のものです。
spawn_runには、サブエージェントを起動するエージェントを選ぶagentというオプションもあります。
agentを指定しない場合は、親と同じエージェントで起動していました。
ということは、軽いエージェントを指定すれば、システムプロンプトとツール定義も減らせるかもしれません。

Kiro Crewには、最初からkirocrew-liteというエージェントが入っています。
タイトルの自動生成など、裏方の作業に使われる軽いエージェントで、定義ファイルの~/.kiro/agents/kirocrew-lite.jsonを見ると、ツールもプロンプトも空になっていました。

{
  "name": "kirocrew-lite",
  "model": "auto",
  "tools": [],
  "mcpServers": {},
  "prompt": "",
  "includeMcpJson": false
}

それでは、agentにkirocrew-liteを指定して、Haiku 5.5で起動してみます。
include_memoryとinclude_lessonsはfalse、include_projectはtrueです。

サブエージェントが起動時に読み込むコンテキスト

kirocrew-liteにすると、全体が19,902文字、トークン数は12,169トークンまで減りました。
ツール定義とスキルの一覧が無くなり、最初のメッセージにはシステムプロンプトも入っていませんでした。
steeringだけは、エージェントを変えても除外されませんでした。
最小構成と比べても、トークン数は3分の1以下です。
これはかなり軽いですね。

ただし、kirocrew-liteはツールを1つも持っていないので、ファイルを読んだりコマンドを実行したりはできません。
テストを実行するような作業をさせるなら、必要なツールだけを持たせたエージェントを~/.kiro/agents/に自分で作る必要があります。

まとめ

今回はKiro Crewのサブエージェントを、Haiku 5.5で最小のコンテキストで起動できるか確認してみました。
include_memoryとinclude_lessonsをfalseにすると、memoryとlessonが除外されて、最初のリクエストのトークン数もクレジットもおよそ半分になりました。
これでHaikuに安く早くたくさん働いてもらえそうです。
根本的にglobalに置く必要のないsteering等も多いな〜と棚卸しの機会にもなりました。

この記事をシェアする

関連記事