Kodlama için Grok: promptlar, iş akışı ve güvenli alışkanlıklar

Grok, programlamanın günlük adımlarında yetkin bir kodlama ortağıdır: bir hata mesajını okumak, küçük bir fonksiyon yazmak, test taslakları çıkarmak, yabancı bir dosyayı açıklamak veya ham bir fikri ilk sürüme dönüştürmek gibi. Sohbetimizde kodunuzu çalıştıramaz, deponuzu açamaz veya güncel belgelere bakamaz; bu nedenle sağladığı yardımın kalitesi, ne yapıştırdığınıza ve dönen sonucu ne kadar dikkatle incelediğinize bağlıdır. Bu rehber her iki konuyu da kapsamaktadır.

Grok nerede işe yarar, nerede yaramaz?

Grok, bir sohbete sığabilecek problemlerde en iyi sonucu verir. En uygun senaryolar:

• bir yığın izleme (stack trace) veya derleyici hatasını çözümlemek ve olası nedenleri önermek;
• bağımsız bir fonksiyon, betik, SQL sorgusu veya düzenli ifade (regex) yazmak;
• bir kod bloğunun ne yaptığını, dilerseniz satır satır açıklamak;
• akla gelmeyebilecek sınır durumlar da dahil olmak üzere birim test taslakları hazırlamak;
• kısa bir kod farkını (diff) hatalar, anlaşılmayan isimlendirmeler ve eksik kontroller açısından incelemek;
• kodu diller veya kütüphane sürümleri arasında dönüştürmek.

Uygun olmayan senaryolar: daha önce hiç görmediği birçok dosyaya dokunan değişiklikler, sisteminizin anlık durumuna bağlı olan her şey ve eğitim tarihinden daha yeni bir kütüphane sürümüyle ilgili sorular. Ayrıca hiçbir şeyi test edemez. Yazdığı her kod parçası, siz çalıştırana kadar test edilmemiştir.

Yeni bir ekip arkadaşının ihtiyaç duyacağı bağlamı yapıştırın

Yetersiz bir kodlama yanıtının en yaygın nedeni eksik bağlamdır. Sormadan önce şunları toparlayın:

1. Dil ve sürümler. "Python 3.12, pandas 2" veya "Node 22, Express 5". Sürüm farklılıkları, yanlış yanıtların büyük bir kısmına neden olur.
2. İlgili kod. Tüm proje değil; yalnızca hata veren fonksiyon ve çağırdığı kısımlar.
3. Hatanın tam metni. Mesajın ve yığın izlemenin tamamını kopyalayın; kendi kelimelerinizle özetlemeyin.
4. Beklenen ve gerçekleşen. Ne olması gerektiği, yerine ne olduğu ve şimdiye kadar neleri denediğiniz.
5. Kısıtlamalar. Yeni bağımlılık eklenmemesi, eski bir sürümle uyumlu kalma zorunluluğu, yeni başlayanlar için okunabilir olma gereksinimi gibi.

Zayıf:
kodum calismiyor duzelt

Güçlü:
Python 3.12. Bu fonksiyon musteri basina ortalama siparis degerini
dondurmelidir, ancak tek siparisi olan musteriler NaN aliyor. Beklenen:
yalnizca tek siparislerinin degeri. Fonksiyon ve ornek veri asagidadir.
Once nedenini aciklayin, ardindan duzeltilmis fonksiyonu verin. Yeni
kutuphane eklemeyin.
---
[fonksiyon]
[bes ornek satir]

Güçlü sürüm Grok'a dili, belirtiyi, beklenen sonucu ve uyulması gereken bir kuralı bildirir; ayrıca düzeltmeden önce açıklama ister, böylece neyin ters gittiğini de öğrenmiş olursunuz.

Yaygın kodlama işleri için komut istemleri

Bir hatayı anlama

Tam hata izini ve işaret ettiği satırları yapıştırın, ardından şunu sorun: "En olası üç nedeni, en olası olandan başlayarak listeleyin ve her birini nasıl doğrulayacağımı açıklayın." Böylece tek bir tahmin yerine kısa bir teşhis planı elde edersiniz.

Fonksiyon yazma

Girdileri, çıktıları ve sınır durumları sade bir dille açıklayın, ardından kodla birlikte beklenen sonuçları içeren iki veya üç örnek çağrı isteyin. Örnekler, hemen çalıştırabileceğiniz hızlı bir test işlevi de görür.

Test yazma

Asagidaki fonksiyon icin pytest testleri yazin. Sunlari kapsayin:
normal girdi, bos girdi, tek bir oge, cok buyuk sayilar ve gecersiz
turler. Her durum icin anlasilir bir ada sahip tek bir test yazin.
Fonksiyonu degistirmeyin.
---
[fonksiyon]

Kendi kodunuzu inceleme

Belirli bir odak noktası belirterek inceleme isteyin, örneğin: "Bunu yalnızca hatalar ve yakalanmamış istisnalar açısından inceleyin; kod stiline odaklanmayın." Odaklanmış bir inceleme daha kısadır ve uygulaması daha kolaydır. Kendi kod parçanızla inceleme komut istemini deneyin.

Yabancı kodu anlama

"Bunu JavaScript bildiğimi ama bu kütüphaneyi bilmediğimi varsayarak açıklayın. Ardından riskli veya güncelliğini yitirmiş görünen noktaları listeleyin." Riskleri sormak, açıklamayı mini bir kod incelemesine dönüştürür.

Kontrolü elinizde tutan bir iş akışı

1. Önce bir plan üzerinde anlaşın. Tek bir fonksiyondan daha büyük her şey için, herhangi bir kod yazmadan önce yaklaşımın genel hatlarını isteyin. Planı netleştirin, ardından kodu talep edin.
2. Küçük parçalar halinde çalışın. Her mesajda tek bir fonksiyon veya tek bir değişiklik. Uzun çıktılar hataları gizler ve yanıt uzunluğu sınırına takılıp kesilebilir.
3. Kendiniz çalıştırın. Sonuçları veya yeni hataları aynı sohbete geri yapıştırın. "Bunu çalıştırdığımda şu oldu" ifadesi, verilebilecek en yararlı takip mesajıdır.
4. Saklamadan önce her satırı okuyun. Bir satırı bir iş arkadaşınıza açıklayamıyorsanız, Grok'tan açıklamasını veya yeniden yazmasını isteyin.
5. Küçük adımlarla commit yapın. Sürüm kontrolü sayesinde, iyi sonuç vermeyen bir öneriyi geri almak oldukça zahmetsizdir.

Kod asistanı aracı bu alışkanlıkları bir formda toplar: görevi seçin, kodu yapıştırın, yapılandırılmış bir yanıt alın. Geliştiriciler sayfamız, Grok'u günlük olarak kullanabileceğiniz daha fazla yöntem listeler; kodlama komut istemleri ise doldurulmaya hazırdır.

Kod için hangi Grok modeli kullanılmalı?

• Grok 4.20 (varsayılan), açıklamalar, küçük kod parçaları, düzenli ifadeler ve şablon kodlar için hızlıdır.
• Grok 4.3 Thinking, yanıt vermeden önce düşünür; bu da karmaşık hataları izlemeye, algoritma sorularına ve çok koşullu mantıklara yardımcı olur.
• Grok 4.7 sohbetimizdeki en yeni modeldir ve xAI tarafından kodlama ile otonom görevler için amiral gemisi olarak tanımlanmaktadır. Bu modelle günde en fazla 10 mesaj hakkınız vardır; bu nedenle en zor probleminizi tüm bağlamıyla birlikte tek bir mesajda iletin.

Akıl yürütme modelleri rehberimiz, ek düşünme süresine ne zaman değeceğini açıklamaktadır.

Dikkat edilmesi gereken hatalar

• Uydurma fonksiyonlar. Grok bazen kulağa doğru gelen ancak gerçekte var olmayan bir yöntem veya seçenek çağırabilir. Tanımıyorsanız, resmi belgelere bakın.
• Eski sürümler. Bilgisinin bir kesilme tarihi vardır. Bir kütüphane o tarihten bu yana bir şeyleri yeniden adlandırmış veya kaldırmış olabilir. Sürümünüzü belirtin ve şüpheye düştüğünüzde değişiklik günlüğünü (changelog) kontrol edin.
• Sadece olumlu senaryoya (happy-path) odaklanan kod. İlk taslaklar genellikle boş girdileri, eksik dosyaları, saat dilimlerini ve ağ kesintilerini göz ardı eder. Şunu sorun: "Hangi girdiler bunu bozar?"
• Sessiz değişiklikler. Bir şeyi düzeltirken, model başka bir yeri "toparlamaya" çalışabilir. Yalnızca minimum değişikliği veya yalnızca farklı olan satırları isteyin.
• Güvenlik açıkları. Dizeleri uç uca ekleyerek oluşturulan sorgulara, eksik girdi kontrollerine ve koda doğrudan yazılmış gizli anahtarlara dikkat edin. Doğrudan şunu sorun: "Bu kod SQL injection saldırılarına karşı güvenli mi?"

Gizli bilgileri sohbetten uzak tutun

Kodu yapıştırmadan önce API anahtarlarını, şifreleri, belirteçleri (token), bağlantı dizelerini, müşteri verilerini ve dahili ana bilgisayar adlarını kaldırın. Bunları YOUR_API_KEY gibi yer tutucularla değiştirin. İşvereninizin kaynak kodunu harici hizmetlerle paylaşmaya ilişkin kuralları varsa bunlara uyun; şüpheye düştüğünüzde, sorunu gizli kısımlar olmadan aynı davranışı sergileyen küçük bir örneğe indirgeyin. Bu küçük örnek genellikle hatayı tek başına da ortaya çıkarır. Gizlilik ve güvenlik rehberimiz, mesajların sohbetimiz üzerinden nasıl iletildiğini açıklamaktadır.

SSS

Grok kodumu sohbet içinde çalıştırabilir mi?

Hayır. Kodu okur ve yazar ancak çalıştırmaz, bu nedenle gerçek çıktıyı göremez. Kodu kendiniz çalıştırın ve sonucu veya hatayı sohbete geri yapıştırın.

Bir hatanın ekran görüntüsünü gönderebilir miyim?

Evet, her üç model de görselleri okuyabilir. Ancak mümkün olduğunda metni yapıştırmak yine de daha iyidir; böylece Grok doğrudan alıntı yapabilir ve hiçbir şey yanlış okunmaz.

Hangi programlama dillerini biliyor?

Grok yaygın dillerde oldukça rahattır: Python, JavaScript ve TypeScript, Java, C# ve C++, Go, PHP, SQL, kabuk (shell) betikleri ve daha fazlası. Nadir diller ve niş kütüphaneler için daha fazla hata bekleyin ve kontrolleri daha dikkatli yapın.

Kod neden yarıda kesildi?

Yanıtların bir uzunluk sınırı vardır. "Kaldığın fonksiyondan itibaren devamını yaz" diyebilir veya programın her seferinde bir parçasını isteyebilirsiniz.

İş yerinde yapay zeka tarafından yazılmış kod kullanmak uygun mu?

Bu, işvereninizin kurallarına ve projenizin lisansına bağlıdır. Üretilen koda herhangi bir dış katkı gibi yaklaşın: inceleyin, test edin ve kullanma izninizin olduğundan emin olun.