Geliştiriciler için prompt engineering: kod, refactor ve unit test teknikleri

Yapay zekâ ve LLM’ler (Claude, GPT-4, Gemini) yazılım mühendisliği manzarasını kalıcı değiştirdi. AI artık yalnızca autocomplete değil; mimari tasarım, performans profiling ve unit test üretimi için aktif pair programmer. LLM’in döndürdüğü kodun kalitesi prompt’un netliği ve yapısıyla doğru orantılıdır. Belirsiz prompt jenerik boilerplate, kod halüsinasyonu ve ince runtime bug üretir.

Günlük mühendislik işinde LLM’leri etkili kullanmak için sohbetten yapılandırılmış prompt engineering’e geçmelisiniz. Workflow’unuza hemen alabileceğiniz ileri teknikler ve gerçek prompt yapıları.

1. Kaliteli bir kod prompt’unun anatomisi

LLM’den kod isterken başarılı bir prompt dört sütundan oluşur: rol tanımı, bağlam, teknik kısıtlar ve çıktı formatı kuralları. Kopyalayıp uyarlayacağınız yapı:

• System persona: çıta yüksek tutun. Örn. «Next.js App Router, TypeScript ve temiz bileşen mimarisinde uzmanlaşmış Senior React Engineer gibi davran.»
• Ayrıntılı bağlam: yazılım ortamını açıklayın. «Proje stiller için Tailwind CSS, global state için Zustand, sunucu verisi için TanStack Query kullanır.»
• Sıkı kısıtlar: kaçınılacakları açık listeleyin. «Harici NPM bağımlılığı kurma. Native React hook kullan. CSS dosyası yazma, yalnızca inline utility class.»
• Çıktı formatı: yanıt tipini tanımlayın. «Yalnızca tam TypeScript snippet’ini bir markdown bloğunda döndür. Giriş metni veya açıklama yazma.»

2. Kod örnekleriyle ileri prompt engineering teknikleri

Yapılandırılmış prompt teknikleri kod doğruluğunu ve güvenilirliğini ciddi yükseltir. Üç güçlü kalıp:

• Few-shot prompting: modele projenizden 1-2 yüksek kaliteli kod örneği verin. AI adlandırma, format ve import yapılarınızı birebir kopyalar.
• Chain of Thought (CoT): LLM’i kod üretmeden önce adım adım teknik plan yazmaya zorlayın. «Adım 1: state yönetim akışını çıkar. Adım 2: boş değer ve loading gibi edge case’leri listele. Adım 3: bu planı uygulayan TypeScript bileşenini yaz.»
• System prompt injection: kod kurallarını IDE’nin (Cursor, VS Code) system prompt’una besleyin, kurallar global uygulansın - deprecated fonksiyon veya legacy CSS gibi klasik AI hatalarını keser.

3. Günlük geliştirme için gerçek prompt şablonları

Frontend mimarisi kurup test etmeyi hızlandırmak için kullandığım üç etkili prompt:

• Refactor için: «Bu React bileşenini olası memory leak, gereksiz re-render ve okunabilirlik sorunları için analiz et. Uygun yerde React.memo veya useMemo ile refactor et, iç içe döngüleri düz lookup tablosuna çevir ve temiz TypeScript döndür.»
• Unit test için: «QA otomasyon mühendisi gibi davran. Şu React bileşeni için Vitest ve React Testing Library ile kapsamlı unit test yaz. Tipik tıklamalar, API hataları, loading spinner ve erişilebilirliği (aria-attributes) kapsa.»
• Şema dönüşümü için: «Aşağıdaki SQL şemasını TypeScript Prisma şemasına ve karşılık gelen Zod doğrulama şemasına çevir. Tüm alanlar doğru tiplensin ve doğrulama için özel hata mesajları ekle.»

Sonuç: daha iyi ürünler, daha hızlı

Prompt engineering modern geliştiricinin çekirdek skill’idir. Bağlam, kısıt ve talimatları yapılandırarak LLM’leri mühendislik kapasitenizin güçlü uzantısına çevirirsiniz. AI temeli kurar; doğrulama, performans auditi ve nihai entegrasyon Senior’ın görevidir. Bu teknikleri bugün Next.js ve Web3 projelerinize alın.