Pustaka detektorLoop tersangkut

Loop tersangkut

Masih berjalan. Tidak ke mana-mana.

Tangkap tindakan berulang yang tersembunyi di balik sesi yang sibuk.

Lihat masalahnya. Pahami temuannya.

Narasi bahasa Inggris dengan teks.

Bagaimana ini bisa terlewat

Agen Anda masih berjalan. Terminal terus bergerak. Tapi baru saja meminta hal yang sama untuk kelima kalinya. Aktivitas bisa terlihat meyakinkan, bahkan ketika sesi terjebak dalam loop.

Bayangkan tugas pengodean di mana agen terus memeriksa status Git. Sekali itu berguna. Lima panggilan identik berturut-turut mungkin berarti agen kehilangan langkah berikutnya. Di beberapa sesi, pola itu mudah terlewat sampai Anda kembali ke tugas yang sama yang belum selesai.

Apa yang dideteksi ClawMetry

ClawMetry mencari panggilan alat berulang dengan argumen yang sama, dan siklus pendek berulang dari nama alat. Ketika pengulangan melewati ambang batas yang berlaku, peringatan loop tersangkut dimunculkan. Temuan ini memberi tahu Anda pola, alat, dan jumlah pengulangan.

Perbedaan yang mengubah temuan

Contoh pemicu

5 panggilan identik

Temuan peringatan

Perbandingan tenang

8 argumen berbeda

Tidak ada temuan untuk detektor ini.

Dalam contoh yang diperiksa, lima panggilan status Git identik menghasilkan peringatan. Delapan panggilan dengan argumen file berbeda tetap tenang untuk detektor ini. Perbedaan pentingnya adalah tindakan yang berulang. Ambang batas dapat mencerminkan runtime dan baseline yang dipelajari, sehingga lima hanyalah contoh, bukan aturan universal.

Periksa hasil detektor
{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}
Unduh input dan hasil lengkap (JSON)
Cara contoh diperiksa

Contoh-contoh ini mengevaluasi detektor yang diterbitkan dengan data peristiwa yang dibuat atau file konfigurasi sementara. Video mengilustrasikan perilaku tersebut. Ini bukan rekaman agen langsung atau antarmuka produk. Tidak ada perintah dalam contoh yang dieksekusi.

Hasilnya menetapkan perilaku untuk input ini. Ini tidak menetapkan konsumsi runtime, pencegahan, atau kompromi nyata. Periksa kontrak sumber yang disematkan.

Apa yang perlu diperiksa selanjutnya

Periksa langkah yang berulang dan hasilnya. Apakah agen menunggu sesuatu yang tidak bisa berubah? Apakah perlu dependensi yang hilang atau tindakan berikutnya yang lebih jelas? Gunakan temuan ini untuk memutus siklus sendiri, lalu periksa apakah pekerjaan yang berguna dilanjutkan.

  1. Periksa langkah yang berulang
  2. Cari apa yang kurang
  3. Tentukan tindakan konkret berikutnya

Apa yang ditetapkan sinyal ini

Pengulangan bisa disengaja. Temuan ini tidak menentukan penyebab, menghentikan sesi, atau membatasi pengeluaran.

Jaga agar momen penting tetap terlihat.

Ikuti aktivitas agen, periksa temuan, dan tentukan apa yang perlu diperhatikan.