Merhaba arkadaşlar,
Son dönemde OpenAI Codex gibi yapay zeka destekli kod asistanlarını daha sık kullanmaya başladım. Özellikle tek seferde büyük bir modülü veya birden fazla dosyayı etkileyen görevler verdiğimde, modelin proje bağlamını tam kavrayamadığını fark ettim. Bu yüzden görev vermeden önce bazı proje talimatları hazırlamanın önemli olduğunu düşünüyorum. Sizin deneyimlerinizden faydalanmak istiyorum.
Ben genellikle şu unsurları içeren bir talimat seti oluşturmayı planlıyorum: projenin genel amacı, kullanılan teknoloji yığını ve sürümleri, kodlama standartları (isimlendirme, biçimlendirme), klasör yapısı ve dosya organizasyonu, bağımlılık yönetimi, test stratejisi, hata yönetimi yaklaşımı, güvenlik gereksinimleri ve performans beklentileri. Ayrıca, mevcut kod tabanındaki önemli sınıflar, fonksiyonlar veya modüller hakkında kısa açıklamalar eklemenin faydalı olacağını düşünüyorum. Ancak bunları ne kadar detaylandırmalıyım? Çok uzun talimatlar modelin dikkatini dağıtır mı, yoksa daha fazla bağlam her zaman iyi midir?
Sizce Codex'e büyük bir görev vermeden önce hangi proje talimatları mutlaka hazırlanmalı? Özellikle şu sorulara yanıt arıyorum:
- Talimatları bir dosyada mı (örneğin README veya ayrı bir markdown) yoksa doğrudan istem içinde mi veriyorsunuz?
- Kod örnekleri veya şablonlar ekliyor musunuz?
- Modelin sık yaptığı hataları önlemek için özel uyarılar koyuyor musunuz?
- Proje talimatlarını güncel tutmak için nasıl bir iş akışı izliyorsunuz?
- Codex'in daha iyi sonuç vermesi için hangi tür bilgileri vermekten kaçınıyorsunuz?
Gerçek deneyimlerinizi ve önerilerinizi paylaşırsanız çok sevinirim. Özellikle orta veya büyük ölçekli projelerde çalışanların pratik ipuçlarına ihtiyacım var. Teşekkürler!