Ajana yararlı kod deposu bağlamı verin

Mevcut çalışma kopyasıyla başlayın

Ajan hangi kod deposunu ve dalı değiştirdiğini bilmelidir. Çalışma dizininde ilgisiz değişiklikler olup olmadığını da bilmelidir. Bu bilgiler neleri güvenle düzenleyebileceğini ve son diff’in nasıl yorumlanacağını etkiler.

Ajandan uygulamadan önce proje talimatlarını ve paket yapılandırmasını incelemesini isteyin. Başka bir kod deposundan hatırlanan komut burada yanlış olabilir. Tanıdık framework adı, kurulu sürümü veya proje kurallarını göstermez.

Küçük değişiklik için ilgili modülü, çağıran kodu, testleri ve mimari kararı sağlayın. Araştırma belirli bir ihtiyaç gösterdiğinde daha fazla bilgi ekleyin.

Kalıcı kurallar için kod deposu talimatlarını kullanın

Talimat dosyası desteklenen komutları, modül sınırlarını, inceleme gereksinimlerini ve sorumlu kararı gerektiren işlemleri açıklayabilir. AGENTS.md kuralı, kodlama araçlarına bu bilgi için tanınabilir bir yer sunar. Araç desteği ve talimat önceliği değişebilir; aracınızın davranışını kontrol edin.

Kalıcı proje kurallarını kod deposunda tutun. Güncel görevi görev tanımında tutun. Talimat dosyasını her konuşmanın geçmişine veya geçici plan listesine dönüştürmeyin.

Yararlı talimat ‘Bir route erişim davranışını değiştirdiğinde yetkilendirme entegrasyon testlerini çalıştır’ der. Belirsiz talimat ‘Güvenlikte her zaman dikkatli ol’ der. İlki, inceleyicinin doğrulayabileceği bir tetikleyici ve işlem tanımlar.

Talimatları kodla karşılaştırın

Komutlar, dizinler veya mimari değiştiğinde talimatlar eskir. Rehber eksik bir betik adı veriyorsa paket yapılandırmasını inceleyin. Belge hizmetin salt okunur olduğunu söylüyorsa iddiaya güvenmeden önce izinleri inceleyin.

Çelişkiyi kaydedin. Uygulama davranışını anlamak için güncel sürümün doğrudan kanıtını kullanın. Eski kod ihlal ediyor diye bilinçli bir politikayı sessizce bırakmayın. Politika ve mevcut davranış farklı soruları yanıtlar.

Örneğin rehber paylaşılan dala doğrudan yazmayı yasaklarken eski bir betik bunu hâlâ yapıyor olabilir. Doğru yanıt politikayı koruyup betiği düzeltmektir. Mevcut kod, yasak işlemi tekrarlama izni değildir.

Bağlamı ilgili ve güvenli tutun

Kod deposunun tamamı erişim bilgileri, özel test verileri, müşteri dışa aktarımları ve eski destek logları içerebilir. Kod deposu erişimi, her dosyayı otomatik olarak model hizmetine uygun hâle getirmez.

Onaylı araçları ve veri işleme kurallarını kullanın. Gizli bilgileri bağlamdan çıkarın. Mümkünse müşteri örneklerini uydurma verilerle değiştirin. Yüklenen dosyalar kadar bağlı araçları da kontrol edin: arama bağlayıcısı ilk istemde hiç bulunmayan bilgi alabilir.

‘Gizli bilgileri okuma’ diyen kod deposu talimatı yararlı yönlendirmedir. Gizli bilgi deposuna ve hassas dizinlere erişimi sınırlamanın yerini almaz.

Sonraki kişi için yararlı kayıt bırakın

Tamamlandığında değişen davranışı, doğrulamayı ve çözümlenmemiş sınırları pull request’e kaydedin. Desteklenen iş akışı değiştiğinde kalıcı proje belgelerini güncelleyin. Ajan konuşmasının tamamını kod deposuna kopyalamaktan kaçının.

Kayıt, sonraki bakım sorumlusunun uzun konuşmayı yeniden kurmadan işi tekrarlamasına yardımcı olmalıdır. Esas belgelere bağlantı verin ve her kalıcı kuralın tek yetkili açıklamasını koruyun.

İyi bağlam tekrarlanan araştırmayı azaltır. Beklenen davranış ve çalışan komutlar açık olduğu için hataları tespit etmeyi de kolaylaştırır.