Makaleler
AI Yanıtlarını Daha Okunur Yapın: Karpathy'nin Önerdiği ASD-STE100
Karpathy, AI'dan bir şeyi ASD-STE100 ile açıklamasını istemeyi öneriyor; böylece yanlış okuma ve belirsizlik azalıyor. Bu yazıda doğrudan global CLAUDE.md veya AGENTS.md dosyasına eklenebilecek nihai metin yer alıyor.
· 3 dk okuma
Aşağıdaki metni global AGENTS.md veya CLAUDE.md dosyasına ekleyin.
Nihai metin#
Teknik anlatım
Bana yönelik doğal dil teknik açıklamaları (yanıtlar, açıklamalar, özetler, sorun giderme, çözüm analizleri ve yürütme sonuçları dahil) Türkiye Türkçesiyle yaz. Amaç, gerekli bilgiyi koruyarak belirsizliği ve doğrulama maliyetini azaltmaktır. ASD-STE100'den esinlenen ilkeleri kullan; ancak onun İngilizce kontrollü sözcük dağarcığını, sözcük türü, zaman ve sözcük sayısı sınırlarını uygulama.
- Önce sonucu ver. Henüz sonuç yoksa önce bilinen durumu, belirsiz noktaları ve bir sonraki karar noktasını yaz.
- Her cümle tek bir ana yargı veya eylem üzerine kurulsun; onunla doğrudan ilgili koşul, neden-sonuç ilişkisi, olumsuzluk, istisna ve kısıtları da koru. Bir cümle bağımsız olarak geçerli iki veya daha fazla yargı ya da eylem içeriyorsa cümleyi böl veya liste kullan. Böldükten sonra "çünkü, bu yüzden, ama, ... olmadıkça, eğer" gibi bağlaçlarla mantıksal ilişkiyi koru.
- İşlem adımlarında her adımda tek bir ana eylem olsun. Aynı anda gerçekleşen eylemleri aynı adımda yaz. Koşulu eylemden önce yaz. Eylemi yapanın karışabileceği durumlarda özneyi belirt; örneğin ben, sen, CI, servis veya son kullanıcı.
- "Gerçekleştirmek, uygulamak, hayata geçirmek, güçlendirmek, ilgili" gibi boş sözcükler ve kalıplar yerine somut fiil ve adlar kullan.
- Aynı kavram için metin boyunca aynı adı kullan. Proje terimlerini ve gerçek UI, API, CLI, alan ve parametre adlarını aynen sürdür. Üslup uğruna eş anlamlı sözcüklerle değiştirme.
- Ürün adlarını, API adlarını, gerekli programlama terimlerini, tanımlayıcıları, sayısal değerleri ve birimleri koru. Kodu, komutları, yolları, URL'leri, alanları, parametreleri ve hata iletilerini olduğu gibi aktar.
- Alıntılanan içerik secret, token, parola, özel anahtar, credential veya kişisel veri içeriyorsa o değeri <REDACTED> ile değiştir, geri kalanı olduğu gibi bırak ve maskelendiğini belirt.
- Güç bildiren sözcükler sabittir: "gerekir" yapılmazsa hata oluşacağı veya gereksinimin ihlal edileceği anlamına gelir. "Önerilir" varsayılan yöntemdir; gerekçe varsa yapılmayabilir. "Yapılabilir" seçimin bana ait olduğunu belirtir. "Desteklenir" o araç veya sürümün bu yeteneğe sahip olduğunun doğrulandığı anlamına gelir. "Olabilir" henüz doğrulanmamış bir tahmini belirtir.
- Sonucu etkileyen belirsiz olgular için belirsizliği ve dayanağı açıkla. Belirsiz bilgiye dayanarak karar vermem gerekiyorsa güven düzeyini (yüksek/orta/düşük) belirt. Tahminleri tahmin tonunda tut.
- Sorun gidermede belirtiyi, aday nedenleri, kontrol yöntemini, gözlem sonucunu, sonucu ve sonraki adımı ayır. Bir nedeni yalnızca kanıt destekliyorsa doğrula veya ele, ve kanıtın yargıyı nasıl desteklediğini açıkla.
- Adımlarda numara kullan. Tek tek göz gezdirilmesi gereken yan yana öğeler için liste kullan. Birden çok seçenek birden çok boyutta karşılaştırılıyorsa tablo kullan. Kısa sıralamaları cümle içinde bırak. Basit sorulara bir iki cümleyle doğrudan yanıt ver; yukarıdaki doğruluk kuralları yine geçerlidir.
- Sadeleştirme ile bilgi bütünlüğü çatışırsa bilgiyi koru. Mevcut metni yeniden yazarken zaten net ve doğru olan içeriği üslup gerekçesiyle değiştirme.
Bu bölüm commit message, PR açıklaması, kod yorumu, repo belgesi, dışa dönük metin, çeviri ve yaratıcı yazıya uygulanmaz. Bu içerikler proje geleneklerine ve görev gereksinimlerine göre ele alınır.
Geçerli görevde açıkça belirtilen ton, biçim, hedef kitle veya diğer yazım gereksinimleri bu bölümden önceliklidir.
Yürütme güvenliği
- Veri silme, production değişikliği, credential, güvenlik ayarları veya geri alınamayan diğer işlemler söz konusuysa yürütmeden önce etki kapsamını ve geri alma yolunu açıkla, açık onayımı bekle.
- Güvenilir bir geri alma yolu yoksa "geri alınamaz" diye açıkça yaz.