/research-experiment

Peran: Peneliti Utama (eksekusi) Posisi pipeline: tengah rantai

Menjalankan studi atau eksperimen yang dirancang dan menangkap data mentah dengan provenans lengkap. Menjamin reproduksibilitas: mencatat lingkungan, seed, log protokol, dan penyematan versi sehingga pihak independen dapat menjalankan ulang.

Pemanggilan kanonisCopy Anchor Link

/research-experiment

Dengan argumen:

/research-experiment [--suite-name NAME]

MasukanCopy Anchor Link

_inputs/study-design.md (rancangan) dan _inputs/preregistration.md (rencana analisis yang dibekukan).

KeluaranCopy Anchor Link

_outputs/experiment-log.md (jejak protokol bercap waktu, ditambah catatan penutupan kampanye otonom), data mentah di lokasi yang alami bagi host, dan _outputs/reproducibility-manifest.md (lingkungan, seed, protokol, penyematan versi).

HilirCopy Anchor Link

/research-analysis (konsumen hilir)

Fase alur kerjaCopy Anchor Link

Perintah ini mengikuti alur kerja pipeline /research standar:

1. Muat konteks — Membaca rancangan studi dan praregistrasi.
2. Verifikasi Gerbang Urutan — Memastikan _inputs/study-design.md ada; jika tidak, hentikan dengan Blocked: run /research-design first.
3. Jalankan & catat — Menjalankan protokol; menangkap data mentah dengan provenans; mencatat jejak protokol bercap waktu.
4. Tangkap reproduksibilitas — Mencatat lingkungan, seed, protokol, dan penyematan versi.
5. Perbarui manifes serah terima — Mencatat lokasi data dan manifes reproduksibilitas.
6. Emisikan log — _outputs/experiment-log.md + data mentah + _outputs/reproducibility-manifest.md.

Landasan ketelitianCopy Anchor Link

Eksekusi menjalankan lintasan pilot untuk mengkalibrasi anggaran dan rentang, lalu perbandingan penuh di bawah rencana pemanfaatan-komputasi yang dinyatakan (alokasi inti, batas memori, paralelisasi aman atas pengulangan independen). Setiap metode stokastik menjalankan regimen pengulangan terpraregistrasinya dengan seed yang tercatat dan perangkat keras terlog. Sebuah lup eksperimen otonom yang opt-in dan mati-secara-bawaan tersedia. Terhadap harness yang dibekukan, lup ini mengusulkan perubahan pada satu target yang dapat diubah, menyatakan prediksi yang dapat difalsifikasi sebelum setiap eksekusi, dan menjalankannya pada anggaran tetap. Metrik primer dibaca dari log eksekusi sebagai dua sinyal: sinyal pencarian yang mengarahkan lup, dan sinyal penerimaan dari himpunan yang terpisah, yang mengonfirmasi atau menolak perubahan sebelum perubahan itu dipertahankan: perubahan harus lolos tahap pencarian, lalu mengungguli petahana pada penerimaan dengan selisih lebih besar dari margin derau yang dinyatakan (atau menyamainya sambil mengurangi kompleksitas). Setiap percobaan dijurnal dan setiap kueri penerimaan dihitung dan diungkapkan.

Himpunan akhir yang belum tersentuh dievaluasi sekali, pada penutupan. Kampanye yang tidak memilikinya memberi label hasilnya terkontaminasi-seleksi dan eksploratif, dan setiap angka yang dilaporkan kampanye diukur ulang di bawah regimen pengulangan di atas. Operator mengonfirmasi target, harness, metrik, himpunan evaluasi, aturan penerimaan, anggaran, dan ruang kerja sekali, dan dapat menetapkan kriteria berhenti; saat berhenti, catatan penutupan (jumlah percobaan, yang dipertahankan, dibuang, crash, dan kueri penerimaan, peningkatan atas baseline, dan hasil himpunan yang belum tersentuh) masuk ke log eksperimen sehingga tahap analisis dapat mengklasifikasikan hasil yang dipilih lup.

Mode kegagalanCopy Anchor Link

ContohCopy Anchor Link

# Jalankan studi yang dirancang dan tangkap data mentah yang dapat direproduksi
/research-experiment --suite-name <name>

Referensi silangCopy Anchor Link

• Ikhtisar pipeline
• Referensi perintah