Mode Debug
Mode Debug membantu Anda menemukan akar penyebab dan memperbaiki bug rumit yang sulit direproduksi atau dipahami. Alih-alih langsung menulis kode, agent menyusun hipotesis, menambahkan pernyataan log, dan menggunakan informasi runtime untuk mengidentifikasi issue secara tepat sebelum menerapkan perbaikan yang terarah.
Kapan menggunakan Mode Debug
Mode Debug paling efektif untuk:
- Bug yang dapat direproduksi tetapi sulit dipahami: Saat Anda tahu ada yang salah, tetapi penyebabnya tidak jelas hanya dengan membaca kode
- Race condition dan masalah pengaturan waktu: Masalah yang bergantung pada urutan eksekusi atau perilaku async
- Masalah performa dan kebocoran memori: Issue yang memerlukan profiling runtime untuk dipahami
- Regresi pada fitur yang sebelumnya berfungsi: Saat Anda perlu melacak perubahan yang terjadi
Saat interaksi standar dengan Agent kesulitan menangani bug, Mode Debug menawarkan pendekatan berbeda dengan menggunakan bukti runtime alih-alih menebak perbaikannya.
Cara kerjanya
-
Eksplorasi dan buat hipotesis: Agent menelusuri file yang relevan, membangun konteks, dan menghasilkan beberapa hipotesis tentang kemungkinan akar penyebab.
-
Tambahkan instrumentasi: Agent menambahkan pernyataan log yang mengirim data ke server debug lokal yang berjalan di ekstensi Cursor.
-
Reproduksi bug: Mode Debug meminta Anda mereproduksi bug dan memberikan langkah-langkah spesifik. Ini membuat Anda tetap terlibat dan memastikan agent menangkap perilaku runtime yang sebenarnya.
-
Analisis log: Setelah reproduksi, agent meninjau log yang dikumpulkan untuk mengidentifikasi akar penyebab sebenarnya berdasarkan bukti runtime.
-
Lakukan perbaikan terarah: Agent melakukan perbaikan terfokus yang langsung mengatasi akar penyebab, sering kali hanya beberapa baris kode.
-
Verifikasi dan bersihkan: Anda dapat menjalankan kembali langkah-langkah reproduksi untuk memverifikasi perbaikan. Setelah dikonfirmasi, agent menghapus semua instrumentasi.
Tips untuk Mode Debug
- Berikan konteks yang mendetail: Semakin jelas Anda menjelaskan bug dan cara mereproduksinya, semakin baik instrumentasi agent. Sertakan pesan error, stack trace, dan langkah-langkah spesifik.
- Ikuti langkah reproduksi dengan tepat: Jalankan langkah-langkah yang diberikan agent untuk memastikan log menangkap issue yang sebenarnya.
- Ulangi reproduksi jika diperlukan: Mereproduksi bug beberapa kali dapat membantu agent mengidentifikasi masalah rumit seperti race condition.
- Jelaskan secara spesifik perilaku yang diharapkan dan yang sebenarnya terjadi: Bantu agent memahami apa yang seharusnya terjadi dan apa yang sedang terjadi.
Beralih antar mode
- Gunakan menu drop-down pemilih mode di Agent
- Tekan Shift+Tab untuk beralih dengan cepat