Kodlama agent'larıyla verimli çalışmak: pratik rehber
Yayın
Kısa cevap
Kodlama agent'ından iyi sonuç almak için görevi küçük ve net ver, hedefi doğrulanabilir kıl (test, derleme, tip kontrolü), projenin kurallarını bir talimat dosyasına yaz, her değişikliği diff olarak oku ve gizli anahtarları agent'ın erişemeyeceği yerde tut. Agent işi hızlandırır ama sorumluluk sende kalır.
1. Görevi küçült ve net yaz
"Siteyi iyileştir" yerine "iletişim formuna telefon alanı ekle, alan isteğe bağlı olsun ve mevcut doğrulama şemasını güncelle" yaz. Küçük ve net görevler hem daha doğru sonuç verir hem de incelemesi kolaydır. Büyük bir işi önce planlat, sonra parçalara böl.
2. Doğrulama yolu ver
Agent'ın kendi işini kontrol edebilmesi için bir yol ver: çalıştırılabilir testler, derleme komutu, tip kontrolü, linter. "Bu komutlar geçene kadar çalış" diyebilmek kalitenin en büyük kaldıracıdır. Önce başarısız bir test yazdırıp sonra onu geçirtmek de iyi çalışan bir yöntemdir.
3. Proje kurallarını yaz
Birçok araç, projenin kökündeki bir talimat dosyasını (örneğin AGENTS.md) okur. Oraya kullandığın komutları, klasör yapısını, kod stilini ve yapılmaması gerekenleri yaz. Kısa ve güncel tut; uzun ve eskimiş bir dosya yarardan çok zarar verir.
4. Her değişikliği oku
- Diff'i satır satır oku. Çalışan kod doğru kod demek değildir.
- Beklenmedik dosya değişikliklerine, silinen testlere ve eklenen bağımlılıklara dikkat et.
- Güvenlikle ilgili kodu (kimlik doğrulama, ödeme, girdi doğrulama) ekstra özenle incele.
5. Sırları ve izinleri koru
- Gizli anahtarları ve .env dosyalarını commit'leme ve agent'ın okuyabileceği yerde tutma.
- Agent'a yalnızca gereken komutları çalıştırma izni ver ve silme ya da push gibi işlemleri onaya bağla.
- Üretim ortamına doğrudan erişim verme.
Ne zaman dikkatli ol
Gereksinim belirsizse agent tahmin yürütür ve yanlış şeyi güzelce yapar. Önce soru sordur ya da planı onayla. İncelemeden güvenlik açısından kritik kodu birleştirme.
Sık sorulanlar
- Agent'ın yazdığı kodu test etmem şart mı?
- Evet. Çalışıyor görünmesi doğru olduğunu göstermez. Testler, derleme ve tip kontrolü agent'a da doğrulama yolu verir.
- Talimat dosyasına ne yazmalıyım?
- Projeyi çalıştırma ve test etme komutlarını, klasör yapısını, kod stilini ve yapılmaması gerekenleri. Kısa ve güncel olsun.
- Gizli anahtarlar agent'a açılmalı mı?
- Hayır. Anahtarları agent'ın okuyamayacağı yerde tut ve commit'leme.
Yazan: Mert Yılmaz, freelance fullstack geliştirici.