Muse Code を触っていると出てくる用語を、実際の挙動と対応づけて整理します。ヘルプやログに現れる語をそのまま拾っています。
| 用語 | 意味 |
|---|---|
| Muse Spark 1.2 | Muse Code が使うモデル。コンテキスト長100万トークン |
| provider | 接続先。meta（本番）と echo（認証不要のテスト用）の2つ |
| session | 一連の作業のまとまり。resume で再開、export で書き出せる |
| run | セッション内の1回の実行。イベントログのストリーム種別のひとつ |
| task | 実行内の個別作業。proposed → accepted → scheduled → started → completed と遷移する |
| durability | イベントを残すか（durable）残さないか（ephemeral）の区別 |
| causation_id | そのイベントを引き起こしたコマンドのID。因果を辿るために使う |
| idempotency_key | 冪等キー。再開時に同じ処理を二度走らせないための識別子 |
| side_effect_intent | 副作用のある操作を行う意図を示すイベント。policy_decision を伴う |
| reasoning effort | 推論の深さ。none / minimal / low / medium / high / xhigh / ultra の7段階（既定 high） |
| approval mode | ツール承認の方式。untrusted / on-request / never（既定 on-request） |
| approval judge | 承認可否をLLMに判定させる仕組み。既定で有効 |
| sandbox network | サンドボックスの通信方式。restricted / enabled / proxy-only（既定 proxy-only） |
| worktree | git worktree。セッション用は既定オフ、サブエージェント隔離は明示要求時のみ |
| skill | エージェントに与える手順・知識。built-in / user / project / plugin の4スコープ |
| AGENTS.md | muse init が作るプロジェクトルールのファイル |
| contributor tier | 入力と出力を学習に提供する代わりに単価が下がる料金区分 |
| preset | 組み込みの構成。native-basic と miniswe |
| playbook | /plan /grilling /grill-with-docs /taste など、対話中に呼べる定型手順 |
| trajectory | export の出力ファイル名や内部IDに現れる語。セッションの軌跡を指す |
紛らわしい組み合わせ
session / run / task
この3つは階層です。セッションの中に複数の実行があり、実行の中に複数のタスクがあります。イベントログではそれぞれ独立したストリームとして扱われ、別々に連番が振られます。
approval mode と approval judge
前者は「承認を求めるかどうか」、後者は「求めた承認をどう判定するか」です。--approval-mode never にすれば求めなくなり、--approval-judge off にすればLLMによる判定をやめます。別の設定です。
worktree と subagent-worktree-isolation
前者はセッション自体のworktree（既定オフ）、後者はサブエージェントの隔離（機能は既定オン、ただし子が明示要求したときだけ効く）です。詳しくは記事に整理しました。