AI ile kod açıklama

Kod yazmayı öğrenmenin yarısı kod okumaktır; bu derste bir kod parçasının ne yaptığını yapay zekâ araçlarına anlattığımız AI ile kod açıklama tekniğini baştan sona işliyoruz. Hangi araçları kullanabileceğini, nasıl soru sorarsan daha kaliteli açıklama alacağını ve bu yöntemle yapılan tipik hataları somut örneklerle görüyoruz. Tüm seriyi görmek istersen Yapay Zekâ dersleri sayfamızdan devam edebilirsin.

AI ile Kod Açıklama Nedir?

AI ile kod açıklama, bir kod parçasını büyük dil modeli (LLM) tabanlı bir yapay zekâ aracına verip aynı kodun insan dilinde, satır satır veya blok blok anlatılmasını istemek demektir. Kodu sen yazarsın, araç açıklar; yani süreç kod yazmanın tam tersine çalışır. ChatGPT, Claude ve Gemini gibi sohbet botları bunu doğrudan yapabildiği gibi, VS Code içindeki GitHub Copilot veya Cursor gibi düzenleyici asistanları da seçili kodu tek tıkla açıklayabiliyor.

Arka planda çalışan mantık şudur: Bu modeller eğitimleri sırasında çok sayıda kod örneğini ve kodla ilgili açıklamayı birlikte görmüştür. Sorduğunda kodu tek tek okur, ne yaptığını çıkarır ve dille yeniden ifade eder. Yani sihirli bir çeviri makinesi değil, örüntüleri öğrenmiş bir yorumcu düşün.

Bu beceri bugün bu kadar önemli, çünkü modern yazılımda zamanın büyük bölümü yazmaktan çok okumakla geçiyor: Kütüphanelerin örnek kodları, internette bulduğun çözümler, ekip arkadaşından devralınan projeler... AI, sana yabancı olan bu kodu dakikalar içinde anlamlı kılabilir.

Kimler için faydalı?

• Yeni başlayanlar: Ders kitabındaki veya internetten bulduğu örnek kodun satır satır ne yaptığını öğrenmek için.
• Öğrenciler: Konu tekrarı ve örnek çözüm analizi için; öğretmen perspektifinden konuya bakmak istersen Eğitimde yapay zekâ dersimize de göz atabilirsin.
• Yazılımcılar: Hiç bilmedikleri bir projeye hızlı adapte olmak ve kod incelemesine (code review) hazırlanmak için.
• Kariyer değiştirenler: Hazır örnekler üzerinden programlama mantığını kavramak için.

Hangi Araçlarla Kod Açıklanır?

2024-2025 itibarıyla üç ana yol var ve hepsi aynı temel prensiple çalışır: kodu ver, açıklama al.

• Sohbet botları: ChatGPT, Claude ve Gemini gibi araçlara kodu yapıştırıp soru sorarsın. Kurulum gerektirmez, en hızlı yöntem budur.
• Düzenleyici asistanları: VS Code veya JetBrains gibi ortamlarda çalışan GitHub Copilot ve Cursor, açık projenin bağlamını bildiği için açıklamaları dosyanın geri kalanıyla uyumlu verir.
• Platform içi araçlar: Bazı kod paylaşım ve öğrenme platformları "bu kodu açıkla" düğmesi sunar; öğrenci odaklı ürünlerde bu özellik hızla yaygınlaştı.

Ücretsiz katmanlar günlük kullanım için çoğunlukla yeterlidir; uzun dosyaların analizi ve derinlemesine inceleme isteklerinde ise ücretli planlar genellikle daha iyi sonuç verir.

Etkili Açıklama İstemi (Prompt) Nasıl Yazılır?

Aynı kod, nasıl sorulduğuna göre bir derste altı cümlelik açıklama da alır, yarım sayfalık ayrıntılı analiz de. Kaliteli sonuç için istemine şu unsurları ekle:

• Derinlik: "Yeni başlayan birine anlatır gibi" ya da "kısaca özetle" gibi hedef kitleyi belirt.
• Kapsam: "Satır satır açıkla", "sadece döngü kısmını açıkla" gibi sınırlar koy.
• Format: "Madde madde yaz", "önce amacını tek cümleyle söyle" gibi çıktı şekli iste.
• Bağlam: "Bu kod bir e-ticaret sitesinin sepet fonksiyonu" demek, aracın yanlış varsayım yapmasını engeller.
• Ek görevler: "Örnek girdi ve çıktı ver", "koddaki riskli noktaları belirt" gibi istekler ekle.

Karşılaştırma yapacak olursak: "Bu kod ne yapıyor?" sorusu işe yarar ama "Bu Python fonksiyonunu yeni başlayan birine satır satır anlat, örnek girdi-çıktı ver ve olası hataları belirt" sorusu çok daha öğretici bir yanıt döndürür. İstem ne kadar netse açıklama o kadar kullanışlı olur.

Adım Adım Örnek: Bir Fonksiyonu Açıklatalım

Elimizde şu tek satırlık Python fonksiyonu olsun ve amacını bilmiyoruz:

def ortalama(notlar): return sum(notlar) / len(notlar) if notlar else 0

AI'a şunu yazıyoruz: "Bu Python fonksiyonu ne yapıyor? Yeni başlayan birine açıkla, örnek girdi ve çıktı ver, olası hataları belirt."

Beklediğimiz nitelikli açıklama kabaca şöyledir: Fonksiyon, verilen listedeki sayıların ortalamasını hesaplar. sum(notlar) elemanları toplar, len(notlar) eleman sayısını bulur; bu ikisinin bölümü ortalamayı verir. "if notlar else 0" kısmı ise listeyi boş olması durumunda korur, çünkü boş listede len 0 olur ve sıfıra bölme hatası (ZeroDivisionError) çıkardı. Örnek: [80, 90, 100] listesi için sonuç 90.0, boş liste için 0 döner.

Bu örnekte asıl öğretici nokta şudur: İyi bir açıklama "ortalama hesaplar" demekle kalmaz, kodun en kritik savunma satırını (boş liste kontrolünü) de görünür kılar. Yapay zekâdan kod okurken aradığın değer tam olarak budur.

Açıklamayı doğrulama

Son adım kontrol adımıdır: Açıklamayı kodun kendisiyle karşılaştır. sum ve len fonksiyonlarının gerçekten böyle çalıştığını küçük bir denemede test et; açıklamadaki örnek girdiyi kendin çalıştır. Bu alışkanlık hem kod okuma becerini geliştirir hem de aracın olası hatasını yakalamanı sağlar.

Bu Beceri Ünitedeki Diğer Becerilerle Nasıl Birleşir?

Kod açıklama tek başına da değerlidir ama asıl gücünü diğer AI becerileriyle birleşince gösterir: Kodu AI ile kod yazma dersinde üretir, kod tamamlama ile yazım hızını artırır, AI ile hata ayıklama dersindeki yöntemlerle hataları bulup düzeltirsin. Açıklama becerisi bu üçünün ortak zeminiidir, çünkü ne yazdığını, ne tamamladığını ve ne düzelttiğini anlamadan kontrol edemezsin. Bütün bu akışın büyük resmi AI destekli yazılım geliştirme dersinde, Python özelindeki bağlantılar ise Python ve yapay zekâ dersinde işleniyor. Ders alanının geneli için ilgili yazılım dersleri sayfasına bakabilirsin.

Sık Yapılan Hatalar ve Yanılgılar

• "AI her açıklamayı doğru verir" sanmak: Modeller bazen halüsinasyon üretir; olmayan bir parametre uydurabilir ya da kodun amacını yanlış tahmin edebilir. Açıklamayı daima kodla karşılaştır.
• Bağlam vermeden parça paylaşmak: Bir dosyanın ortasından alınan yirmi satır, hangi sınıfa veya fonksiyona ait olduğu söylenmeden yanlış açıklanabilir. Kodun nereden geldiğini ve ne için kullanılacağını da yaz.
• Açıklamayı koltuk değneği yapmak: Amaç kod okuma becerisi kazanmaktır. Her açıklamadan sonra kodu kendi cümlelerinle özetleyebiliyor musun, diye kendini sına.
• Gizli kodu dışarı göndermek: Şirket kodunu veya kişisel veri içeren kodu herkese açık araçlara yapıştırmadan önce gizlilik kurallarını kontrol et.
• Tek kelimelik istem yazmak: Sadece "açıkla" demek yüzeysel sonuç verir; derinlik, format ve hedef kitle iste.
• Çok uzun dosyayı olduğu gibi yapıştırmak: Çok uzun kod, aracın bağlam penceresini zorlayabilir ve açıklama kalitesini düşürebilir; önce ilgili bölümü seç.