Raider ユーザーガイド
Scala REPL、タブシェル、またはヘッドレス CLI から Raider を使います。このガイドは、モデルを使うコーディングタスクから始め、次にスクリプト化されたデモ、監査、型付きチェックのワークフローを示します。説明対象はこのソースチェックアウトです。Raider はまだ開発中です。
作業の仕方を選ぶ
| 必要なこと | 最初に見るもの | 動作 |
|---|---|---|
| プロジェクトの変更を Raider に依頼する | ヘッドレスのコーディングタスク | 指定したワークスペースに対して coder エージェントを実行します |
| Scala でエージェントのリクエストを調べる | Scala REPL | 1 つのセッションで、Scala の定義と Raider のリクエストを評価します |
| 複数のタブと下書きを保つ | タブシェル | タブを切り替えます。タブに入力したテキストは下書きとして保存され、Scala としては評価されません |
| CI で繰り返し可能なワークフローを 1 つ実行する | ローカル CI ガイド | チェック、レビュー、型付きの判断を実行します |
チェックアウトを準備する
JDK 21、sbt 1.11.4、Python 3 をイ ンストールします。リポジトリルートから、例のクラスパスとバンドルをビルドします。
sh scripts/build/user-examples.sh
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
ビルドは、固定された Scala 3.9.0 と ZIO 2.1.26 の依存関係を使います。クラスパスにより、このチェックアウトから CLI と REPL を直接起動できます。プロバイダのセットアップとトラブルシューティングは、オンボーディング を参照してください。
モデルで Scala のバグを直す
この例は、小さな Scala の請求プロジェクトを一時ディレクトリにコピーします。方針は「小計が 10,000 セ ント以上のとき、1,000 セントを割り引く」です。フィクスチャは厳密な > 比較になっているため、ちょうど境界で失敗します。
先に モデルのセットアップ に従ってください。このケースは OpenAI 互換のエンドポイントを使います。ヘルパーは使い捨てワークスペースを作り、coder にコンパイル/テストのコマンドを渡し、結果のソースとテストを確認します。
: "${RAIDER_BASE_URL:?Set your OpenAI-compatible endpoint URL}"
: "${RAIDER_MODEL:?Set the model name for that endpoint}"
RAIDER_PROVIDER=openai RAIDER_LIVE_APPROVED=1 \
python3 scripts/quality/user_examples.py --only coding --live
これは、設定した資格情報を使って、ライブのモデル呼び出しを行います。期待される変更は s > 10000 から s >= 10000 であり、テスト結果は次のとおりです。
Before the edit: FAIL exact-threshold
After the edit: DiscountSpec: PASS 3 boundaries
コマンドは、実行アーティファクトのディレクトリを表示します。コピーされたプロジェクトは artifacts/user-examples/verification-<id>/workspace/ の下にあり、結 果レポートは artifacts/user-examples/verification-<id>/report.json です。最終的なソースとテスト結果をそこで確認してください。元のフィクスチャは変更されません。
自分のプロジェクトで作業する
coder を使い、選んだプロジェクトへのアクセスをモデルに与えます。ブランチか使い捨てコピーで作業し、下のパスとタスクを自分のものに置き換えてください。変更を確認するコマンドを含めると、エージェントは完了の仕方を把握できます。
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
WORKSPACE='/absolute/path/to/your/project-copy'
java -cp "$RAIDER_CP" raider.cli.Main run \
--agent coder --provider "$RAIDER_PROVIDER" \
--base-url "$RAIDER_BASE_URL" --model "$RAIDER_MODEL" \
--workspace "$WORKSPACE" \
--input "Fix the discount boundary bug. Keep public signatures unchanged. Run sbt test and report the changed files and test result." \
--out artifacts/project-task
プロジェクトが別の確認コマンドを使う場合は、sbt test を置き換えてください。CLI は上のプロバイダフラグを使います。モデルのセットアップ を通して設定してください。フィクスチャヘルパーと異なり、このコマンドは WORKSPACE で直接動作します。あなたの権限でファイルを変更し、プロセスを実行できます。
Raider は、artifacts/project-task の下に work-<id> パスを表示 します。結果は summary.md、ツール出力は transcript.json を読んでください。プロジェクトのコピーで git diff を確認し、変更を受け入れる前に、関連するチェックを自分で実行してください。実行の読み方 を参照してください。
ライブモデルなしで同じバグのケースを見る
ローカルのスクリプト化されたスタンドで、固定応答のデモを実行します。
python3 scripts/quality/user_examples.py --only coding
これは、請求の修復シーケンスを通じて実際の Scala ツールを駆動しますが、応答は固定スクリプトに従います。ファイルの編集と Scala のチェックは実行されます。