Bağlam ve Görev Tarifi — Yazmadığın Her Karar Bir Tahmindir
Önce şunu oku: AI Kodunu Gözden Geçirmek — Akıcı Görünmek Doğru Olmak Değil
30 saniyede özet
Yapay zekâ asistanı yalnızca ona gösterdiğini bilir. İyi bir görev tarifi hedefi, uyulacak kalıpları, sınırları ve işin ne zaman bitmiş sayılacağını yazar. Daha çok metin değil, seçilmiş metin işe yarar.
“Sipariş iptali ekle” dedin. Asistan yeni bir hata formatı icat etti, farklı bir test kütüphanesi kullandı ve kargodaki siparişleri de iptal edilebilir yaptı. Hiçbiri yanlış bir tahmin değildi — sadece senin kararların değildi.
-
Bayt: Asistana tek cümle yazdım, bambaşka bir şey yaptı!
-
Sen: Ne yazmıştın?
-
Bayt: Sipariş iptali ekle. Bu kadar. Gerisini bilir sandım...
-
Bayt: Ustaya sadece mutfağı yenile desem, hangi mutfağı yapardı?
Asistan senin kafandakini bilmez
Bir dil modeli yalnızca context windowBir dil modelinin tek seferde görebildiği metnin tamamı: senin mesajların, verdiğin dosyalar ve kendi cevapları. Pencerede olmayan bir şeyi model bilmez.Sözlükte gör →’ında olanı bilir: mesajın, gösterdiğin dosyalar, kendi cevapları. Yazmadığın her karar, genel bir alışkanlıkla doldurulur.
Bu tahminler çoğu zaman makuldür. Sorun, hangisinin senin kuralına uymadığını ancak sonuca bakınca görmendir.
Kafam karıştı, daha basit anlat
Asistan yalnızca ona yazdığını bilir. Kafandaki kuralları yazmadıysan, onların yerine makul görünen tahminler koyar.
Bir AI asistanına "sipariş iptali ekle" dedin. Asistan projendeki hata formatını, test alışkanlığını ve iş kurallarını nereden bilir?
İyi bir görev tarifinde ne olur?
'Sipariş iptali ekle' diyen bir tarifte asistan yaklaşık kaç kararı kendi başına vermek zorunda kalır? Cevabı göster
Onu aşkın. Hangi yol, hangi durumlar, iade olacak mı, kural nereye yazılacak, hata formatı, test türü, dokunulabilecek dosyalar, “bitti”nin ölçüsü…
Adım adım oku
- Tek cümlelik bir istekte yol, durumlar, hata formatı, test türü ve bitiş ölçüsü gibi bütün kararlar asistanın tahminine kalır.
- Bütün repoyu yapıştırmak bu soruların hiçbirini cevaplamaz; kurallar yığının içinde kaybolur.
- Hedef, projedeki kalıplar ve sınırlar yazılınca kararların çoğu senin kararın olur.
- Kabul kriterleri eklenince ne zaman bitmiş sayılacağı da belli olur ve sonuç testle doğrulanabilir.
| Parça | Cevapladığı soru |
|---|---|
| Hedef | Ne yapılacak, hangi davranış? |
| Bağlam | Projede hangi kalıplar izleniyor? |
| Sınırlar | Nereye dokunulmayacak, ne eklenmeyecek? |
| acceptance criteriaBir işin ne zaman "bitti" sayılacağını söyleyen somut, doğrulanabilir koşullar. Çoğu zaman doğrudan teste çevrilebilir.Sözlükte gör → | Ne zaman bitti sayılır? |
| Çalışma biçimi | Önce plan mı, adım adım mı? |
Kabul kriteri yoksa sonuç doğrulanamaz. Kriterleri doğrudan test olarak istemek, asistana hedefi, sana da kontrol yolunu verir.
Kafam karıştı, daha basit anlat
İyi bir görev tarifi yeni gelen bir çalışana verilen not gibidir: ne yapılacak, nereye dokunulabilir, iş bitince nasıl kontrol edilecek.
Görev tarifindeki her cümle hangi parçaya ait?
Görev tarifinin hangi parçası olmadan asistanın sonucunun doğru olup olmadığını kontrol edemezsin?
Kendin gör
Görev tarifi — AI neyi tahmin etmek zorunda kalıyor?
Tohum 918533Sipariş iptali ekle.
Şu an ne oldu?
"Sipariş iptali ekle"
Görev tarifinin her parçası bir soruyu cevaplar. Cevaplanmayan her soru, asistanın tahminine kalır.
Görevler0/3
Asistanı on karardan fazlasını tahmin etmek zorunda bırakaçık
İpucu
Yalnızca "sipariş iptali ekle" de.
Sonucu doğrulanabilir kıl — tek bir parçaylaaçık
İpucu
"Bitti"nin ne demek olduğunu hangi parça söyler?
Hiçbir kararı tahmine bırakma ve kısıtları gömmeaçık
İpucu
Bütün parçalar — ama repoyu yapıştırmadan.
Olay günlüğü (0)
Henüz olay yok. Oynat veya adımla.
- Varsayılanla oynat. Yalnızca bir cümle: on bir karar tahmine kaldı.
- Yalnızca kabul kriterlerini aç. Hâlâ tahmin var, ama sonuç artık doğrulanabilir.
- Bütün parçaları aç. Tahmine kalan karar yok.
- “Bütün repoyu yapıştır”ı aç. Hiçbir soru cevaplanmadı, kısıtlar gömüldü.
"Bütün repoyu yapıştırırsam asistan her şeyi bilir" düşüncesinin sorunu ne?
Satır satır: bir görev tarifi
Her satır bir tahmini ortadan kaldırıyor
Hedef: POST /orders/{id}/cancel. Yalnızca PAID siparişler iptal edilir, ödeme iade edilir.Bağlam: Kural Order.cancel() içinde. Hatalar ApiErrors ile ProblemDetail döner. Testler @WebMvcTest.Sınırlar: Yalnızca order paketine dokun. Yeni bağımlılık ekleme.Kabul: PAID → 200; SHIPPED → 409; bilinmeyen id → 404. Her biri için bir test.Çalışma: Önce kısa bir plan yaz ve onayımı bekle.Debug
hedef Yol, izinli durum ve yan etki (iade) belli. 'Kargodakiler de iptal edilsin mi?' sorusu kalmadı.
Sol/sağ ok tuşlarıyla da gezebilirsin.
Seçilmiş bağlam, yığılmış bağlamdan iyidir. Değişecek dosyalar, izlenecek bir örnek ve kuralların kısa listesi yeter.
Aynı tarif bir bankanın kart servisinde nasıl görünür, merak ettin mi? Aşağıda kalıcı kurallar, tek bir görev ve o görevin kabul kriterlerinden çıkan test var.
Derinleş · Kartta geçici limit artışı: kurallar, tarif, test 3 dosya · ~75 satır · ilk okumada atlayabilirsin
Kafam karıştı, daha basit anlat
Görevi küçük parçalara böl. Küçük bir değişikliği okumak ve kontrol etmek kolaydır, büyük bir yığını ise kimse tam okuyamaz.
Büyük bir değişiklik için en iyi çalışma biçimi hangisi?
Görev tarifine "ne yapma" kısıtlarını (yeni bağımlılık ekleme, public API'yi değiştirme) yazmak neden önemlidir?
Tuzaklar
Prompt’ta sır ya da müşteri verisi. Şifreler ve gerçek kişisel veri hiçbir koşulda prompt’a girmez.
Her şeyi tek mesajda istemek. Büyük bir iş, büyük ve incelenemeyen bir diff olarak geri gelir.
“Ne yapma”yı yazmamak. Hedef yolu söylemez; kabul edilemez yolları sınırlar dışarıda bırakır.
Aynı kuralları her seferinde yazmak. Kalıcı kuralları depodaki kısa bir yönergeler dosyasına taşı.
Bu görev tarifi bir asistana verildi. Hangi satırlar sorun çıkarır?
Kendini sına
Asistan, projenin kurallarını sen yazmasan da bilir.
Asistan planında "mevcut RestTemplate çağrılarını WebClient'a çevireceğim" diyor. Senin istediğin yalnızca bir endpoint eklemekti. Ne yaparsın?
Aklında kalacak üç şey
- 1 Asistan yalnızca ona gösterileni bilir. Görev tarifinde yazmadığın her karar onun tahminidir.
- 2 Ne zaman bitmiş sayılacağı yazılmayan bir işin sonucu kontrol edilemez. 'Bitti'nin ölçüsünü yaz, mümkünse bir test olarak.
- 3 Bütün projeyi yapıştırmak iyi bağlam değildir. İlgili dosyaları ve kuralları seç; şifreleri ve gerçek müşteri verisini asla ekleme.
5 kart sonraki derste seni bekliyor
Bu dersin üstüne kurulanlar
Bunlar bu dersi temel alıyor; hazır olduğunda devam edebilirsin.