Copilot’a projeye özgü çalışma biçimini anlatmak için depoda .github/copilot-instructions.md dosyası tutabilirsiniz. Dosya, bir özellik isteğinin yerine geçmez; her görevde yeniden anlatmanız gerekmeyen derleme yolu, dizin yapısı ve temel kuralları taşır. Desteklenen talimat türü kullandığınız Copilot yüzeyine göre değişebileceğinden önce o yüzeyin belge ve gösterdiği bağlamı kontrol edin.
Örnekteki yolları kendi projenizin gerçek yapısına uyarlayın. Talimata parola, gerçek müşteri kaydı veya erişim anahtarı eklemeyin. “Testleri atla” gibi genel bir kural yerine neyin nasıl kontrol edileceğini belirtin. Talimatın yüklendiğini görmek, bütün kodun bu kurala uyduğunu kanıtlamaz; sonuç dosya farkıyla değerlendirilir.
Dosyaya ne yazılmalı?
Yeni katılan bir geliştiricinin ihtiyaç duyacağı kısa bilgiyi düşünün: uygulamanın hangi klasörden başladığı, hangi paket yöneticisinin kullanıldığı ve değişikliğin hangi komutla sınandığı. Bütün README’yi kopyalamak yerine ihtiyaç duyulan bölümü işaret etmek daha bakımı kolay bir metin oluşturur.Depo talimatını kurun
- Proje kökünü açın. .github klasörü yoksa oluşturun. Talimatı aynı adlı başka bir projenin içine koymadığınızı doğrulayın.
- copilot-instructions.md dosyasını yazın. Gerçekte çalışan komutları ve mevcut mimariyi kullanın. Henüz benimsenmemiş bir hedef mimariyi mevcut durum gibi anlatmayın.
- Küçük bir görevle deneyin. Örneğin yalnız bir yardımcı fonksiyona açıklama eklenmesini isteyin. Kullanılan talimat referanslarını ve değişen dosyayı inceleyin.
- Yanlış veya eski bilgiyi düzeltin. Test komutu artık yoksa dosyayı güncelleyin. Birden fazla talimat kaynağındaki zıt paket yöneticisi tercihlerini birleştirin.
- Değişikliği ekipçe paylaşın. Dosyayı normal kod incelemesiyle depoya ekleyin. Böylece talimat değişiklikleri de izlenebilir olur.
Kullanılabilir örnek içerik
Kod:
Uygulama web/ klasöründedir.
Paket yöneticisi npm'dir; package-lock.json korunur.
Arayüz bileşenleri mevcut components/ örneklerini izler.
Kontrol komutlarını web/package.json içinden doğrula.
Kullanıcıya görünen hata metinleri Türkçedir.Örnekteki yolları kendi projenizin gerçek yapısına uyarlayın. Talimata parola, gerçek müşteri kaydı veya erişim anahtarı eklemeyin. “Testleri atla” gibi genel bir kural yerine neyin nasıl kontrol edileceğini belirtin. Talimatın yüklendiğini görmek, bütün kodun bu kurala uyduğunu kanıtlamaz; sonuç dosya farkıyla değerlendirilir.
