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
| Keperluan | Mulakan dengan | Apa yang dilakukan |
|---|---|---|
| Minta Raider mengubah projek | Tugasan pengekodan tanpa kepala | Menjalankan ejen coder terhadap ruang kerja yang anda namakan |
| Teroka permintaan ejen dalam Scala | REPL Scala | Menilai definisi Scala dan permintaan Raider dalam satu sesi |
| Kekalkan beberapa tab dan draf | Shell tab | Bertukar antara tab; teks yang ditaip dalam tab disimpan sebagai draf, bukan dinilai sebagai Scala |
| Jalankan satu aliran kerja boleh ulang dalam CI | Panduan CI tempatan | Menjalankan 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_KEYsecara peribadi atau konfigurasikanRAIDER_API_KEY_CMD; jangan sekali-kali hantar kunci sebagai argumen. - Larian enggan bermula: sertakan
--out, tepat satu bendera input, dan sama ada--agentatau kedua-dua--bundledan--workflow. - Ejen menyatakan ia lulus tetapi ujian tidak: semak status keluar dan output pengkompil/ujian sebenar. Jika salasilah tiada, periksa
run.json,summary.md, danevents.jsonl.