Claude ile Etkili Prompt Yazma: Bağlam, XML Etiketleri ve Örnekler

Neden prompt yazımı önemli?

Claude güçlü bir model, ama ne istediğinizi yalnızca yazdığınız kadarıyla bilir. "Bir giriş formu yaz" isteği ile "PHP 8.2 ve PDO kullanan, CSRF korumalı, hata mesajları Türkçe olan bir giriş formu yaz" isteği arasındaki fark, alacağınız sonucun kalitesine doğrudan yansır. Bu derste Anthropic'in de önerdiği dört temel tekniği uygulamalı göreceğiz.

1. Açık olun ve bağlam verin

İyi bir prompt şu soruları yanıtlar: Amaç ne? Kim kullanacak? Hangi teknolojiler ve kısıtlar var? Başarılı sonuç neye benziyor?

Küçük bir muhasebe bürosu için fatura listeleme sayfası hazırlıyoruz.
Kullanıcılar bilgisayar bilgisi sınırlı kişiler; arayüz sade olmalı.
Teknoloji: PHP 8.2, MySQL (PDO), Tailwind CSS. Framework yok.
İstediğim: faturaları tarihe göre süzen ve sayfalayan bir liste.
Başarı ölçütü: SQL enjeksiyonuna karşı güvenli, 1000 kayıtta hızlı.

2. XML etiketleriyle yapılandırın

Talimatları, verileri ve örnekleri birbirinden ayırmak için XML etiketleri kullanın. Claude etiketlerle ayrılmış bölümleri karıştırmadan işler; uzun istemlerde bu, yanlış anlamaları ciddi biçimde azaltır.

<gorev>
Aşağıdaki fonksiyonu incele, güvenlik açıklarını listele ve düzeltilmiş hâlini yaz.
</gorev>

<kod>
function kullaniciBul($id) {
    return mysqli_query($db, "SELECT * FROM uyeler WHERE id = $id");
}
</kod>

<cikti_bicimi>
Önce madde madde açıklar, sonra tek bir PHP kod bloğu.
</cikti_bicimi>

Uzun bir belgeyle (sözleşme, log dosyası, kod tabanı) çalışırken belgeyi istemin başına, sorunuzu sonuna koyun; bu sıralama uzun bağlamlarda daha iyi yanıt verir.

3. Örnek gösterin

İstediğiniz biçimi tarif etmek yerine bir-iki örnekle gösterin. Buna "few-shot" yaklaşımı denir:

Ürün adlarından SEO uyumlu adres (slug) üret.

<ornek>Girdi: Çelik Termos 500 ml → Çıktı: celik-termos-500-ml</ornek>
<ornek>Girdi: Ağaç Oyuncak Seti (3+ Yaş) → Çıktı: agac-oyuncak-seti-3-yas</ornek>

Girdi: Şişme Yatak Çift Kişilik

4. Çıktı biçimini belirleyin

Yanıtı bir programda kullanacaksanız biçimi kesin tanımlayın. Kullanıcı verisini isteme eklerken etiketlerin içine koymak, verinin talimat gibi algılanmasını da zorlaştırır:

<?php
function yorumAnaliziIstemi(string $yorum): string
{
    // Kullanıcı verisi talimat gibi okunmasın diye etiket içine alınır ve etiket kaçırılır
    $yorum = str_replace(['<yorum>', '</yorum>'], '', $yorum);
    return "Müşteri yorumunu analiz et. Yalnız şu JSON'u döndür:\n"
        . '{"duygu": "olumlu|olumsuz|notr", "konu": "kısa konu", "acil": true|false}' . "\n\n"
        . "<yorum>\n" . $yorum . "\n</yorum>";
}

İpuçları

• Önce düşünmesini isteyin: Karmaşık işlerde "yanıtlamadan önce adım adım planla" demek hataları azaltır.
• Rol verin: "Kıdemli bir PHP güvenlik uzmanı olarak incele" gibi bir rol, yanıtın odağını belirler.
• Yineleyin: İlk yanıt mükemmel olmayabilir; neyin eksik olduğunu söyleyip düzeltme isteyin.

Sık yapılan hatalar

• Belirsiz istekler: "daha iyi yap" yerine neyin, hangi ölçüte göre iyileşmesi gerektiğini yazın.
• Talimatla veriyi karıştırmak: Kullanıcıdan gelen metni etiketlemeden isteme eklemek.
• Çıktıyı doğrulamamak: Özellikle kodda, çalıştırmadan ve test etmeden canlıya almayın.

Özet

Bağlam, yapı (XML etiketleri), örnekler ve net çıktı biçimi, Claude'dan alacağınız sonucun kalitesini belirleyen dört temel taştır. Sonraki adım olarak sık kullandığınız bir isteği bu dört teknikle yeniden yazın ve iki sonucu karşılaştırın.