İyi Bir Hata Raporu Nasıl Yazılır (AI ya da Geliştirici İçin)

İyi bir hata raporu, bir geliştiricinin ya da bir AI'nın size hiçbir şey sormadan sizin gördüğünüz sorunu görmesini sağlar. Belirli bir başlık, sorunu yeniden üretmek için tam adımlar, neyi beklediğiniz, gerçekte ne olduğu, hata mesajının kelimesi kelimesine kopyası ve sorunun nerede çıktığı gerekir: hangi sayfa, tarayıcı, cihaz ve kullanıcı. Her raporda tek bir hata olsun; yardımcı olacaksa bir ekran görüntüsü ekleyin.

Çoğu hatayı anlamak, düzeltmekten daha uzun sürer. Net bir rapor anlama kısmını ortadan kaldırır. Bu, AI araçlarında daha da önemlidir: bir AI, "ödeme ekranı garip" dediğinizde ne kastettiğinizi soramaz, bu yüzden tahmin yürütür ve yanlış bir tahmin başka bir şeyi bozabilir.

Şablon

Bunu kopyalayıp doldurun:

Başlık: [Ne yanlış, nerede] — örn. "Rezervasyon formu akşam 6'dan sonraki saatleri reddediyor"

Yeniden üretme adımları:
1. ...
2. ...
3. ...

Beklenen: [ne olması gerekiyor]
Gerçekleşen: [bunun yerine ne oldu]

Hata mesajı: [tam metin, varsa]
Nerede: [sayfa/URL, tarayıcı, cihaz, hangi kullanıcıyla giriş yapılmış]
Ne sıklıkla: [her seferinde / bazen / bir kez]
Ekran görüntüsü ya da kayıt: [eklendi]

Bu rehberin geri kalanı her bölümü açıklar.

Adım 1: Önce yeniden üretin

Yazmadan önce hatayı yeniden oluşturmayı deneyin. Hangi adımların önemli olduğunu ve her seferinde olup olmadığını öğreneceksiniz.

• Temiz bir durumdan başlayın: sayfayı yenileyin ya da çıkış yapıp tekrar girin.
• Her tıklamayı ve yazdığınız her şeyi not edin.
• Hatayı tetikleyen en kısa yolu bulmaya çalışın.
• İkinci bir tarayıcı ya da hesap deneyin. Yalnızca bir kullanıcıda oluyorsa, bu büyük bir ipucudur.

Bu konuda daha fazlası için bkz. AI ile yapılmış bir uygulamayı nasıl ayıklarsınız.

Adım 2: Belirli bir başlık yazın

Başlık, neyin yanlış olduğunu ve nerede olduğunu söylemeli; böylece bir listeyi tarayan biri hangi hata olduğunu anlar.

Adım 3: Tam adımları listeleyin

Numaralandırın. Kelimesi kelimesine yazın: hangi sayfa, hangi düğme, ne yazdınız.

1. Müşteri olarak giriş yapın (test hesabı: customer@example.com).
2. "Başlangıç kiti"ni sepete ekleyin.
3. WELCOME10 indirim kodunu girin ve Uygulaya tıklayın.
4. Ödemeye tıklayın.

"Bir kodla ödemeyi deneyin" demek, çoğu zaman önemli olan ayrıntıları atlar: hangi kullanıcı, hangi ürün, hangi kod ve kodun önce uygulanıp uygulanmadığı.

Adım 4: Beklenen ve gerçekleşen

Raporun özü budur. İkisini de yazın, çünkü aradaki fark hatanın kendisidir.

• Beklenen: Ödeme sayfası açılır ve toplamda yüzde 10 indirim görünür.
• Gerçekleşen: Düğme bir saniye boyunca yükleniyor simgesi gösterir, sonra hiçbir şey olmaz. İndirim kodu olmadan ödeme çalışıyor.

"Beklenen" olmadan okuyucu davranışın yanlış olduğunu anlamayabilir. "Gerçekleşen" olmadan ne arayacağını bilmez.

Adım 5: Hataları tam olarak kopyalayın

Hata mesajları nedene giden en hızlı yoldur. Kelimesi kelimesine, metin olarak kopyalayın; yeniden ifade etmeyin.

Nerede bulacağınız:

• Ekranda: uygulamanın gösterdiği herhangi bir mesaj.
• Tarayıcı konsolu: geliştirici araçlarını açın (F12 ya da sağ tık → İncele) ve kırmızı satırlar için Console sekmesine bakın.
• Ağ sekmesi: geliştirici araçlarında başarısız isteği bulun ve URL'sini ve durum kodunu not edin (örneğin POST /api/checkout → 500).
• Sunucu kayıtları, erişiminiz varsa.

TypeError: Cannot read properties of undefined (reading 'percent') at checkout.ts:48 gibi bir satır çoğu zaman doğrudan sorunu gösterir.

Adım 6: Bağlam ekleyin

• Nerede: sayfa URL'si, ortam (önizleme, hazırlık ya da canlı).
• Kim: hangi kullanıcı ya da rol: yönetici, üye, çıkış yapmış.
• Cihaz ve tarayıcı: "iPhone'da Safari" ile "Windows'ta Chrome" farklı olabilir.
• Veri: kaydın alışılmadık yanları: çok uzun metin, özel karakterler, çok sayıda öğe.
• Ne zaman başladı: "dünkü indirim kodu değişikliğinden sonra" çok değerli bir bilgidir.
• Ne sıklıkla: her seferinde ya da on denemede bir.

Adım 7: Gösterin

Sorunun çevrelendiği bir ekran görüntüsü ya da kısa bir ekran kaydı belirsizliği ortadan kaldırır; özellikle yerleşim hataları için. AI aracınız görsel kabul ediyorsa bir tane ekleyin. Anahtarlar ve başkalarının verileri dahil, özel olan her şeyi kırpın.

AI oluşturucu için hata raporu yazmak

Aynı yapı bir istem olarak da işe yarar. İki ekleme yardımcı olur:

• Neyin değişmemesi gerektiğini söyleyin, böylece düzeltme yeni bir sorun yaratmasın.
• Düzeltmeyi yazmasını değil, doğrulamasını isteyin.

Müşteri olarak giriş yapmış, sepette "Başlangıç kiti" varken ve WELCOME10 kodu uygulanmışken Ödemeye tıklamak hiçbir şey yapmıyor. Beklenen: ödeme sayfası toplamda yüzde 10 indirimle açılsın. Gerçekleşen: kısa bir yükleniyor simgesi, sonra hiçbir şey. Ağ sekmesinde POST /api/checkout isteğinin 500 döndüğü görünüyor. Kodsuz ödeme çalışıyor. Nedenini bul ve düzelt; kodsuz siparişler için fiyat hesaplamasını değiştirmeden. Sonra yüzde indirim kodu, sabit tutarlı indirim kodu ve kodsuz ödemeyi kontrol et.

Nedenden emin değilseniz, önce bir teşhis isteyin:

Henüz kodu değiştirme. Bu rapora göre olası nedenler neler ve her birini neyin doğrulayacağı?

Sık yapılan hatalar

• "Bozuk." Adım yok, beklenen sonuç yok, harekete geçilecek bir şey yok.
• Tek bir raporda birden fazla hata. Bazıları düzeltilir, diğerleri kaybolur.
• Yeniden ifade edilmiş hatalar. "Tanımsız bir şey" demek, işe yarar kısmı gizler.
• Kullanıcıyı ya da rolü eksik yazmak. Birçok hata yalnızca yöneticileri ya da yeni kullanıcıları etkiler.
• Sorunu değil, istediğiniz düzeltmeyi anlatmak ("bir null kontrolü ekle").
• Ekran görüntülerinde ya da yapıştırılan kayıtlarda gizli bilgileri paylaşmak.

Kontrol listesi

• Hatayı yeniden ürettim ve en kısa adımları buldum.
• Başlık neyin yanlış olduğunu ve nerede olduğunu söylüyor.
• Adımlar numaralı ve kelimesi kelimesine.
• Beklenen ve gerçekleşen ikisi de yazılı.
• Hata mesajları tam olarak kopyalandı; başarısız istek ve durum kodu da dahil.
• Sayfa, ortam, kullanıcı, cihaz ve tarayıcı eklendi.
• Ne sıklıkla olduğunu ve ne zaman başladığını yazdım.
• Özel veriler kaldırılmış bir ekran görüntüsü ya da kayıt ekledim.
• Her raporda tek bir hata var.

Mythex agent'ına hata bildirmek

Bir Mythex projesinde rapor, istemin kendisidir. Birkaç özellik yardımcı olur:

• Önizlemenin ya da hata ekranının bir ekran görüntüsünü ekleyin; mesaj başına en fazla 5 dosya.
• /fix agent'ı bir hatayı düzeltmeye odaklar; Plan modu düzenlemeden önce araştırmasını sağlar.
• /test agent'ın akışları önizlemede kendisinin yeniden üretmesini ve gördüklerini bildirmesini sağlar.
• Bu noktaya geri dön özelliği, durumu kötüleştiren bir düzeltmeyi geri alır.

Dokümantasyondaki istemlerle hata ayıklama sayfası aynı adımlar / beklenen / gerçekleşen yapısını kullanır. Bunun etrafındaki düzeltme-ve-kontrol döngüsü için bkz. AI ile yapılmış bir uygulamayı nasıl yinelersiniz.

Sorular