Skip to main content

Panduan pengguna Raider

Gunakan Raider daripada REPL Scala, shell tab, atau CLI tanpa kepala. Panduan ini bermula dengan tugasan pengekodan disokong model, kemudian menunjukkan demo berskrip, audit, dan aliran kerja semakan bertip. Ia menerangkan checkout sumber ini; Raider masih dalam pembangunan.

Pilih cara bekerja​

KeperluanMulakan denganApa yang dilakukan
Minta Raider mengubah projekTugasan pengekodan tanpa kepalaMenjalankan ejen coder terhadap ruang kerja yang anda namakan
Teroka permintaan ejen dalam ScalaREPL ScalaMenilai definisi Scala dan permintaan Raider dalam satu sesi
Kekalkan beberapa tab dan drafShell tabBertukar antara tab; teks yang ditaip dalam tab disimpan sebagai draf, bukan dinilai sebagai Scala
Jalankan satu aliran kerja boleh ulang dalam CIPanduan CI tempatanMenjalankan semakan, ulasan, dan keputusan bertip

Sediakan checkout​

Pasang JDK 21, sbt 1.11.4, dan Python 3. Dari akar repositori, bina classpath contoh dan bundle:

sh scripts/build/user-examples.sh
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)

Binaan menggunakan kebergantungan Scala 3.9.0 dan ZIO 2.1.26 yang disemat. Classpath membolehkan anda memulakan CLI dan REPL terus daripada checkout ini. Untuk persediaan penyedia dan penyelesaian masalah, lihat pengenalan.

Baiki pepijat Scala dengan model​

Contoh ini menyalin projek pengebilan Scala yang kecil ke dalam direktori sementara. Dasarnya ialah “diskaun 1,000 sen apabila subjumlah sekurang-kurangnya 10,000 sen”; fixture mempunyai perbandingan > yang ketat, jadi sempadan tepat gagal.

Ikuti persediaan model dahulu. Kes ini menggunakan endpoint serasi OpenAI. Pembantu mencipta ruang kerja pakai buang, memberi coder arahan kompil/ujian, dan menyemak sumber serta ujian yang terhasil.

: "${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

Ini membuat panggilan model langsung menggunakan kelayakan yang anda konfigurasikan. Perubahan yang dijangka ialah s > 10000 kepada s >= 10000, dengan hasil ujian ini:

Before the edit: FAIL exact-threshold
After the edit: DiscountSpec: PASS 3 boundaries

Arahan mencetak direktori artifak larian. Projek yang disalin berada di bawah artifacts/user-examples/verification-<id>/workspace/, dan laporan hasilnya ialah artifacts/user-examples/verification-<id>/report.json. Semak sumber akhir dan hasil ujian di sana. Fixture asal kekal tidak berubah.

Bekerja pada projek anda sendiri​

Gunakan coder untuk memberi model akses kepada projek yang anda pilih. Bekerja pada cabang atau salinan pakai buang, dan gantikan laluan serta tugasan di bawah dengan milik anda. Sertakan arahan yang menyemak perubahan supaya ejen tahu cara menyelesaikannya.

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

Gantikan sbt test jika projek anda menggunakan arahan semakan yang berbeza. CLI menggunakan bendera penyedia di atas; tetapkan melalui persediaan model. Tidak seperti pembantu fixture, arahan ini bekerja terus dalam WORKSPACE. Ia boleh mengubah file dan menjalankan proses dengan kebenaran anda.

Raider mencetak laluan work-<id> di bawah artifacts/project-task. Baca summary.md untuk hasil dan transcript.json untuk output alat. Dalam salinan projek anda, semak git diff dan jalankan semakan yang berkaitan sendiri sebelum menerima perubahan. Lihat membaca larian.

Lihat kes pepijat yang sama tanpa model langsung​

Jalankan demo respons tetap dengan stand berskrip tempatan:

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

Ia memacu alat Scala sebenar melalui urutan pembaikan pengebilan, tetapi responsnya mengikut skrip tetap; suntingan file dan semakan Scala tetap berjalan.

Cipta laporan audit​

Fixture audit mempunyai allow_plaintext_fallback = true dalam config/payments.conf. Jalankan contoh laporan luar talian:

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

AUDIT.json yang dijangka mengenal pasti file dan baris, memetik tetapan, dan memberi impak serta pemulihan. Contoh ini bekerja dalam salinan pakai buang; konfigurasi sumber kekal tidak berubah. Kandungan laporan datang daripada demo berskrip.

[]

Semak kesediaan keluaran daripada input bertip ​

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

Bundle task-summary yang dikompil mengesahkan tiga status yang dibekalkan. Ia melaporkan semakan yang belum selesai; ia tidak mengompil kod, menjalankan migrasi, atau memutuskan sama ada status itu benar.

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

Output aliran kerja yang dijangka, disertakan dalam summary.md:

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

Tetapkan rollback=pass untuk mendapat READY. BLOCKED ialah hasil aliran kerja yang sah dan arahan keluar dengan berjaya; semakan yang tiada, pendua, tidak diketahui, atau tidak sah ditolak. Kodnya ialah TaskSummary.scala. Lihat tutorial Scala untuk Program, Task, andThen, dan permintaan bertip selari.

Jalankan aliran kerja CI tempatan​

Contoh CI Pengebilan membaiki fixture pengebilan, menyemaknya secara bebas, menjalankan ulasan selari, dan menulis keputusan bertip serta indeks artifak larian. Ia membuat panggilan penyedia langsung. Baca keperluan penyedia dan bajet sebelum menjalankannya.

Panduan langkah demi langkah merangkumi larian yang berjaya dan pautan kepada unjuran Scala yang lengkap, supaya anda boleh membandingkan hasil dengan aliran kerja yang menghasilkannya.

Baca jejak larian​

Bagi tugasan pengekodan di atas, mulakan dengan summary.md dan run.json dalam direktori kerja yang dijana. Kemudian gunakan lineage.scala untuk mencari susunan panggilan dan ikuti setiap rujukan data: ke dalam lineage-data.json. transcript.json dan events.jsonl mengandungi pertukaran model/alat dan hasil proses. File ini menerangkan apa yang dijalankan; bandingkan dengan sumber yang benar-benar berubah dan output semakan sebelum anda memutuskan tugasan selesai. Untuk contoh berpandu, lihat panduan salasilah.

Masalah persediaan biasa​

  • File classpath tiada atau Java ditolak: bina semula dengan JDK 21 dan periksa artifacts/user-examples/build.log.
  • Panggilan langsung melaporkan kelayakan tiada: bekalkan RAIDER_API_KEY secara peribadi atau konfigurasikan RAIDER_API_KEY_CMD; jangan sekali-kali hantar kunci sebagai argumen.
  • Larian enggan bermula: sertakan --out, tepat satu bendera input, dan sama ada --agent atau kedua-dua --bundle dan --workflow.
  • Ejen menyatakan ia lulus tetapi ujian tidak: semak status keluar dan output pengkompil/ujian sebenar. Jika salasilah tiada, periksa run.json, summary.md, dan events.jsonl.