Kanıtı kontrol edin

Bir Ajan’ın “uygulandı” demesi yetmez. Her açıklama kanıtıyla birlikte gelir: okuduğu kod, çalıştırdığı testler, çalıştırma kayıtları ve ekran görüntüleri; kontrol etmek için bir tık uzakta. Biri sorduğunda tam yeri gösterebilirsiniz.

Kanıt neleri içerir

Notta “Evidence”ı açın. Genellikle şu tür materyaller bulunur:

4export const GRACE_DAYS = 7;56export function openGrace(subscription, failedAt) {7  if (subscription.graceEndsAt !== undefined) {8    return { ...subscription, lastChargeAttemptAt: failedAt };9  }10  return {11    ...subscription,12    graceEndsAt: addDays(failedAt, GRACE_DAYS),13    lastChargeAttemptAt: failedAt,14  };15}1617export function inGrace(subscription, now) {18  return subscription.graceEndsAt !== undefined19    && now < subscription.graceEndsAt;20}

Komut çıktıları, diff’ler ve ekran görüntüleri, Ajan’ın uygulama sırasında bıraktığı kayıtlardan gelir. Noea her turda hangi komutların çalıştığını ve hangi ekran görüntülerinin alındığını saklar; böylece bir açıklama bunlara doğrudan atıf yapabilir.

Bir kod konumuna bakın

Cümle ortasındaki bir kod konumu genellikle openGrace gibi bir işlev ya da değişken adı olarak görünür; aksi halde grace.ts:6-18 gibi bir “dosya:satır” çipi olur. Bir açıklama aynı ada sahip iki dosyaya atıf yapıyorsa çip, üst klasörü de ekler.

Tam yolu, satır aralığını ve sembolü görmek için imleci bir ad ya da çipin üzerinde bekletin. Tıklayın; kod paneli sağda o dosya için, atıf yapılan satırlarda açılır. Dosya hâlâ bir uygulama turunun bıraktığı gibiyse o turun değişiklikleri tüm dosyanın üzerine bindirilir; böylece satırları hangi turun yazdığını görürsünüz. Sağ tık menüsü dosyayı varsayılan uygulamasında açabilir, Finder’da gösterebilir ya da yolunu kopyalayabilir.

Kod o zamandan beri taşındıysa çipin satır numaraları ve sizi götürdüğü yer, güncel konumunu izler. Atıf yapılan kod değiştiyse ve yalnızca adı bulunabiliyorsa çip soluk gösterilir; dosya yoksa ya da kod artık bulunamıyorsa çip soluk ve üstü çizili gösterilir ve üzerine gelince nedenini söyler. Her iki durumda da açıklamanın büyük olasılıkla yeniden incelenmesi gerekir.

Kanıt nereye kadar gider

Bir materyale bakarken önce hangi türden olduğunu ayırt edin:

Explain ve Investigation esas olarak kodu ve mevcut materyali okumaya dayanır; testleri, derlemeleri ya da uygulamayı her seferinde yeniden çalıştırmazlar. Ajan, sonucun dayandığı bir olguyu kodu okumak çözemediğinde bir şeyi doğrular. İyi bir kanıt, neyi doğrulamadığını da söyler; örneğin “Gerçek ödeme sağlayıcısına karşı çalıştırılmadı; ücret sonuçları bir test çifti üzerinden geliyor.” Kanıt zayıfsa, hiçbir uygulama bulunamadıysa ya da niyet belirsizse kanıt ve dikkat bölümleri, yalnızca kesin görünen bir sonuç sunmak yerine bunu açıkça söylemelidir.

Bir açıklamanın bir sertifika değil, kanıtlı bir inceleme kaydı olduğunu da unutmayın. Bir Ajan’ın başka bir Ajan’ın uygulamasını kontrol etmesi, sonucu kendi başına daha kesin yapmaz. Kanıtın değeri, açıp kontrol edebilmenizdir; açıklamanın “doğrulandı” demesi değil.

Ekran görüntüleri ve arayüz

Bazı davranışlar yalnızca koddan anlaşılamaz; örneğin bir bildirimin arayüzde gerçekten görünüp görünmediği. Ajan uygulama sırasında bir ekran görüntüsü aldıysa açıklama bunu kanıt olarak listeleyebilir, örneğin “Ek süre sırasında ekip ayarları sayfasının üstünde bir bildirim görünür.”

Büyütmek için küçük resme tıklayın. Hangi sayfayı, hangi durumda gösterdiğine ve hangi çalıştırmanın bıraktığına dikkat edin: bir ekran görüntüsü, arayüzün o zaman nasıl göründüğünü kanıtlar; kod o zamandan beri değiştiyse arayüz de değişmiş olabilir.

Madde madde kontrol edin

Kanıtı kontrol ederken her madde için sorun:

• Bu atıf, niyetin bu parçasının ilgilendiği yeri gösteriyor mu?
• Testler hangi durumları kapsıyor ve uç durumlar bunların arasında mı?
• Sonuç, açıklamanın vardığı sonucu gerçekten destekliyor mu?
• Kanıt, neyin doğrulanmadığını söylüyor mu?

Örneğin ek süre kanıtı “ek süre testleri çalıştırıldı: 6’sı da geçti” derken, dikkat bölümü “üçüncü yeniden denemenin başarılı olduğu durumu kapsayan bir test yok” diye not düşer. Artık o yolun yalnızca kodu okumaya dayandığını, onu kanıtlayan bir çalıştırma olmadığını biliyorsunuz.

Kanıt yetmediğinde

Önemli bir durum eksikse paragrafın üzerine gelin, solundaki “Ask about this”e tıklayın ve Ajan’dan bunu doğrulamasını isteyin:

Bir test ekle: üçüncü yeniden deneme ek sürenin 6. gününde başarılı olur, böylece abonelik normale döner ve Free’ye düşürülmez. Çalıştırdıktan sonra sonucu bana söyle.

Ajan bitirdiğinde Noea turu kendiliğinden açıklar; bunu kapattıysanız paragrafın solundaki “Investigation”a tıklayın. Yeni açıklama, bu çalıştırmayı kanıt olarak listeler.

Açıklamanın sonucu kanıtıyla uyuşmuyorsa ya da Ajan’ın niyetinizi yanlış anladığını düşünüyorsanız bunu da buradan sorun ve niyetinizi koda uydurmak için değiştirmeyin. Bkz. Üzerinde uzlaştığınızı niyete yazın.