メインコンテンツまでスキップ

Raider ユーザーガイド

Scala REPL、タブシェル、またはヘッドレス CLI から Raider を使います。このガイドは、モデルを使うコーディングタスクから始め、次にスクリプト化されたデモ、監査、型付きチェックのワークフローを示します。説明対象はこのソースチェックアウトです。Raider はまだ開発中です。

作業の仕方を選ぶ​

必要なこと最初に見るもの動作
プロジェクトの変更を Raider に依頼するヘッドレスのコーディングタスク指定したワークスペースに対して coder エージェントを実行します
Scala でエージェントのリクエストを調べるScala REPL1 つのセッションで、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 のチェックは実行されます。

監査レポートを作る​

監査フィクスチャでは、config/payments.conf に allow_plaintext_fallback = true があります。オフラインレポートの例を実行します。

python3 scripts/quality/user_examples.py --only audit

期待される AUDIT.json は、ファイルと行を特定し、設定を引用し、影響と是正策を示します。例は使い捨てコピーで動作します。ソースの設定は変更されません。レポートの内容は、スクリプト化されたデモから来ます。

[]

型付き入力からリリース準備を確認する ​

{#check-release-readiness-from-typed-input}

コンパイル済みの task-summary バンドルは、渡された 3 つのステータスを検証します。保留中のチェックを報告します。コードのコンパイル、マイグレーションの実行、ステータスが真かどうかの判断は行いません。

java -cp "$RAIDER_CP" raider.cli.Main run \
--bundle artifacts/user-examples/task-summary.jar \
--workflow task-summary \
--input 'tests=pass,migration=pass,rollback=pending' \
--out artifacts/user-examples/readiness --mock

summary.md に含まれる、期待されるワークフロー出力は次のとおりです。

{"decision":"BLOCKED","passed":["migration","tests"],"pending":["rollback"],"action":"Complete: rollback."}

READY を得るには rollback=pass を設定します。BLOCKED は有効なワークフロー結果であり、コマンドは正常に終了します。欠落、重複、未知、または無効なチェックは拒否されます。実装は TaskSummary.scala です。Program、Task、andThen、および並列の型付きリクエストについては、Scala チュートリアル を参照してください。

ローカル CI ワークフローを実行する​

請求 CI の例 は、請求フィクスチャを修復し、独立に確認し、並列レビューを実行し、型付きの判断と実行アーティファクトの索引を書き出します。ライブのプロバイダ呼び出しを行います。実行する前に、プロバイダと予算の要件を読んでください。

ウォークスルーには、成功した実行と、完全な Scala 投影へのリンクが含まれます。結果を、それを生み出したワークフローと比較できます。

実行のトレースを読む​

上のコーディングタスクでは、生成された作業ディレクトリの summary.md と run.json から始めてください。次に lineage.scala を使って呼び出し順を見つけ、各 data: 参照を lineage-data.json まで追ってください。transcript.json と events.jsonl には、モデルとツールのやり取り、およびプロセス結果が含まれます。これらのファイルは、何が実行されたかを説明します。タスクが完了したと判断する前に、実際に変更されたソースとチェック出力と比較してください。手順付きの例は、リネージのウォークスルー を参照してください。

よくあるセットアップの問題​

  • クラスパスファイルがない、または Java が拒否される: JDK 21 で再ビルドし、artifacts/user-examples/build.log を調べてください。
  • ライブ呼び出しが資格情報の不足を報告する: RAIDER_API_KEY を非公開で渡すか、RAIDER_API_KEY_CMD を設定してください。キーを引数として渡さないでください。
  • 実行の開始が拒否される: --out、入力フラグをちょうど 1 つ、そして --agent か、--bundle と --workflow の両方を含めてください。
  • エージェントは成功したと言うがテストは成功しない: 実際のコンパイラ/テストの終了コードと出力を確認してください。リネージがない場合は、run.json、summary.md、events.jsonl を調べてください。