AI CodeOps

Yapay zekânın yazdığı bir değişiklik için olay postmortem şablonu

Son güncelleme

Yapay zekânın yazdığı değişikliklerin yol açtığı olaylar için suçlamasız postmortem şablonu: görev, araç, merge anındaki kanıt ve hangi inceleme adımının ya da kapının onu kaçırdığı.

Bunu olay takip aracınıza veya wiki'nize kopyalayın. [Köşeli parantez] içindekileri değiştirin, ihtiyacınız olmayan bölümleri ve bu notu silin. Suçlamasız tutun: kimin daha iyi bilmesi gerektiğini değil, kişilerin ve araçların ne yaptığını ve neyi görebildiğini anlatın.

  • Olay: [ID ve kısa başlık]
  • Önem derecesi: [SEV1 / SEV2 / SEV3]
  • Tarih ve süre: [YYYY-MM-DD, HH:MM ile HH:MM UTC arası]
  • Yazan: [ad]
  • Gözden geçirenler: [adlar]
  • Durum: [taslak / gözden geçirildi / eylemler tamamlandı]

1. Özet

[İki veya üç cümle: ne bozuldu, kimler etkilendi, ne kadar süreyle ve buna ne neden oldu.]

2. Etki

  • Etkilenen kullanıcılar veya müşteriler: [sayı veya oran ve bunu nereden bildiğiniz]
  • Yaşadıkları: [hatalar, yanlış veriler, yavaşlık, veri ifşası]
  • Etkilenen veriler: [yok / hangi veriler ve herhangi birinin sistemlerinizin dışına çıkıp çıkmadığı]
  • Maliyet: [biliniyorsa krediler, iadeler, mühendislik zamanı]

3. Değişiklik

SoruYanıt
Pull request ve commit[bağlantılar]
Nasıl yazıldı?[kodlama ajanı / yapay zekâ asistanı / kişi]
Araç ve model[ad ve sürüm]
Araca verilen görev[yapıştırın veya bağlantısını verin]
Değişiklik yalnızca görevin istediğini mi yaptı?[evet / hayır: başka ne yaptığı]
Kim talep etti, kim onayladı?[roller; farklı kişiler olmalıdır]
Merge edilen sürümde hangi testler çalıştı?[çalıştırmanın bağlantısı; atlanan var mıydı?]
Test diff'i bir şeyi sildi, atladı veya gevşetti mi?[evet / hayır]
Merge anında açık inceleme veya güvenlik bulguları[yok / liste ve nasıl triyajdan geçirildikleri]
Değişiklik onaydan sonra düzenlendi mi?[evet / hayır; yeniden onaylandı mı?]
Onaylayıcı onaylarken neyi gördü?[o sırada pull request'teki kanıt]

4. Zaman çizelgesi

Tüm saatler UTC'dir.

SaatNe oldu
HH:MMAraca görev verildi
HH:MMPull request açıldı
HH:MM[rol] tarafından onaylandı
HH:MMMerge edildi ve dağıtıldı
HH:MMSorunun ilk belirtisi: [uyarı, destek talebi, kullanıcı]
HH:MMOlay ilan edildi
HH:MMEtkisi hafifletildi: [revert, özellik bayrağını kapatma, geri alma]
HH:MMÇözüldü

5. Kök neden ve katkıda bulunan etkenler

Değişiklikteki sorun neydi: [asıl kusur, örn. yutulup boş bir sonuçla değiştirilen bir hata]

Neden geçebildi. Her katman için bunu yakalayıp yakalayamayacağını ve neden yakalamadığını belirtin.

KatmanBunu yakalayabilir miydi?Neden yakalamadı
Görev[evet / hayır][belirsizdi, bir kısıt eksikti]
Aracın kendi kontrolleri[evet / hayır]
Testler[evet / hayır][bu durum için test yoktu, test zayıflatılmıştı]
Otomatik inceleme[evet / hayır][çalışmadı, bulgu göz ardı edildi, kapsam dışıydı]
İnsan incelemesi[evet / hayır][çok büyüktü, riskli dosyaya göz gezdirildi, kendi kendine onaylandı]
Kalite kapıları[evet / hayır][kapı yoktu, kapı eski kanıtla geçti]
Staging veya kanarya[evet / hayır]
İzleme ve uyarılar[evet / hayır][birinin fark etmesi ne kadar sürdü]

6. İyi giden şeyler

  • [örn. Revert tek tıklamaydı ve dört dakika sürdü.]

7. Eylemler

Kişilerden daha dikkatli olmalarını isteyen eylemler yerine bir sistemi değiştiren eylemleri tercih edin.

EylemTürSorumluSon tarihİş kaydı
[örn. Boş bir upstream yanıtı için test eklemek][test][ad][YYYY-MM-DD][bağlantı]
[örn. Faturalandırma modülü için kod sahibi incelemesini zorunlu kılmak][kapı veya izin][ad][YYYY-MM-DD][bağlantı]
[örn. İnceleme kontrol listesine "sessiz geri dönüş yok" maddesini eklemek][inceleme pratiği][ad][YYYY-MM-DD][bağlantı]
[örn. Ajanın yazma erişimini kendi branch'leriyle sınırlamak][ajan yapılandırması][ad][YYYY-MM-DD][bağlantı]

8. Dersler

[Aynı araçları kullanan başka bir ekibe ne söylerdiniz? Bir paragraf.]

Bu şablon hakkında

Bu bölüm yalnızca web sayfasında yer alır, indirilen dosyalarda yoktur.

Suçlamasız yaklaşım, Google'ın SRE kitabındaki Postmortem Culture: Learning from Failure bölümünü izler; bu bölüm odağı "herhangi bir kişiyi veya ekibi suçlamadan olayın katkıda bulunan nedenlerini belirlemeye" koyar. 3. bölüm, bu şablonu yapay zekânın yazdığı değişikliklere özgü kılan kısımdır: onaylayıcının onayladığı anda neyi görebildiğini bilmeniz gerekir, yoksa bir inceleme hatasını bir kanıt hatasından ayıramazsınız.

AI CodeOps kullanıyorsanız, değişikliğin kanıt paketi 3. bölümün büyük kısmını içerir: görev, modeller, onaylar, bulgular, test çalıştırmaları ve teslimat. Geri alma kılavuzu, 4. bölümdeki hafifletme adımını kapsar.

Sık sorulan sorular

Bir postmortem yapay zekâ aracını suçlamalı mı?

Bir derleyiciyi suçlayacağından daha fazla değil. Faydalı soru, sürecinizin hangi parçasının değişikliğin geçmesine izin verdiği ve bir sonrakinin yakalanması için neyin değişmesi gerektiğidir: bir kontrol, bir kapı, bir izin veya bir inceleme alışkanlığı.

Bunu normal bir postmortem şablonundan farklı kılan nedir?

3. bölüm. Araca verilen görevi, modeli ve onaylayıcının merge anında gördüğü kanıtı kaydeder; böylece incelemenin mi başarısız olduğunu, yoksa kanıtın mı eksik veya yanlış olduğunu ayırt edebilirsiniz.

Postmortem'i kim yazmalı?

Olaya dahil olmuş biri; taslağı hem talep eden hem de onaylayan kişi gözden geçirmeli. İkisine de kusurlu oldukları hissettirilmemeli; gördüklerine dair anlattıkları en değerli girdidir.

Atıf yapın

AI CodeOps (2026). Yapay zekânın yazdığı bir değişiklik için olay postmortem şablonu. https://aicodeops.dev/templates/ai-change-postmortem

Bu sayfa ve indirilebilir dosyaları CC BY 4.0 lisansıyla sunulur: ekibiniz için kopyalayıp uyarlayın ve kendi sürümünüzü yayımladığınızda bu sayfaya bağlantı verin.