Raider を使い始める
このページでは、チェックアウトを用意し、Raider を起動し、最初の作業のしかたを選びます。タブインターフェース、Scala REPL、またはコマンドラインです。コマンドは、リポジトリのルートにいることを前提とします。
1. Java の用意とビルド
Raider の例には JDK 21 が必要です。JDK 21 のディストリビューションをインストールし、下の /path/to/jdk-21 を実際のインストールパスに置き換えてください。これは現在のシェルに Java を設定し、そのツールを PATH の先頭に置きます。
export JAVA_HOME="/path/to/jdk-21"
export PATH="$JAVA_HOME/bin:$PATH"
java -version
バージョン出力は Java 21 を示しているはずです。sbt と Python 3 もインストールしてください。プロジェクトは sbt 1.11.4 と Scala 3.9.0 を固定しています。ランタイムクラスパスと例のバンドルを、一度ビルドします。
sh scripts/build/user-examples.sh
スクリプトは、artifacts/user-examples/classpath.txt と task-summary.jar を示す成功行を出力します。ビルドログ全体は artifacts/user-examples/build.log に書き出します。このシェルを開いたまま、クラスパスを読み込みます。
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
あとで新しいターミナルを開いた場合は、リポジトリのルートに戻り、JAVA_HOME と PATH を再度設定し、そこで RAIDER_CP=... コマンドを実行してください。チェックアウトが変わらない限り、ビルド自体を繰り返す必要はありません。
2. 起動方法を選ぶ
タブインターフェース
ターミナルインターフェースを、次で起動します。
RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main --tabs
これはスクリプト化されたモックバックエンドで起動し、プロバイダへのリクエストは行いません。タブインターフェースでは、入力は下書きとして保存され、Scala は評価されません。:help、続いて :new notes、:tabs、:quit を試してください。使えるコマンドと現在の制限は、タブガイドを参照してください。
Scala REPL
Scala を評価するには、--tabs なしで REPL を起動します。
RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main
raider> プロンプトで、Scala と、スクリプト化されたエージェントリクエストを試します。
case class Check(name: String, passed: Boolean)
val checks = List(Check("compile", true), Check("tests", false))
checks.filterNot(_.passed).map(_.name)
scout.ask("Explain what a failed check means in one sentence")
最初の 3 行は Scala コンパイラを通ります。scout の返答は固定のモックテキストであり、あなたのプロジェクトに基づく回答ではありません。REPL のコマンドは :help、終了は :quit です。さらなる例は REPL ガイドにあります。
コンパイラを使う REPL は :type <expression> もサポートします。これは式を現在のバインディングに対してコンパイルし、評価せずにその型を出力します。たとえば、:type scout("Review the parser") は AgentAsk[String] を報告します。プロバイダへのリクエストは行いません。Tab 補完は、Scala コンパイラのライブなバインディングを使います。--tabs モードでは、:scrollback <tab> と入力すると、保持されているイベント行と退避件数が表示されます。コマンドの接頭辞の上で Tab を押すと、コマンドパレットが開きます。タブシェルの下書きはローカルのテキストのままで、送信されたプロンプトではありません。コマンドの面と現在の制限は、TUI ガイドに書かれています。
タブモードは、読み取り専用のプランフェーズも出します。提案されたプランは、実行の前に Plan タブへ表示されます。それを確認し、:approve で実行を一度開始するか、:reject で進行中のプランフェーズを取り消します。プランフェーズは、ツール回復の分類により読み取り専用です。承認は、実行への明示的な遷移です。決定的なプランシナリオのコーパスは、オフライン評価のフィクスチャであり、ライブのモデル品質を主張するものではありません。ADR-028とプランモードの評価ノートを参照してください。