GitHub Copilot Sohbet yanıtlarını özelleştirme

Tamamlandı

GitHub Copilot Chat, doğru bağlam verildiğinde kodlama uygulamalarınızla ve proje gereksinimlerinizle eşleşen yanıtlar ve kodlar oluşturabilir. Bu bilgileri her sohbet istemine tekrar tekrar eklemek yerine, bu bağlamı dosyalarda depolayabilir ve her sohbet isteğine otomatik olarak ekleyebilirsiniz.

Visual Studio Code'da yapay zeka yanıtlarını özelleştirmenin üç ana yolu vardır:

  • Özel yönergeler: Kod oluşturma, kod gözden geçirmeleri gerçekleştirme veya işleme iletileri oluşturma gibi görevler için ortak yönergeler tanımlayın. Bunlar görevlerin nasıl gerçekleştirileceğini açıklar ve kodlama uygulamalarını, tercih edilen teknolojileri, güvenlik kurallarını veya işleme iletisi biçimlerini belirtebilir.

  • İstem dosyaları: Ortak görevler için yeniden kullanılabilir istemler tanımlayın. Bu tek başına istemler, ne yapılması gerektiğini tanımlar ve yapı iskelesi bileşenlerini içermenin yanı sıra, kod incelemeleri yapmayı, adım adım kılavuzlar oluşturmayı veya uygulama planları geliştirmeyi içerebilir.

  • Özel sohbet modları: Sohbetin nasıl çalıştığını, hangi araçları kullanabileceğini ve kod tabanıyla nasıl etkileşim kurabileceğini tanımlayın. Örnek olarak salt okunur erişimli planlama modları, dış kaynaklara erişen araştırma modları veya ön uç geliştirme gibi role özgü modlar verilebilir.

Özel yönergeler

Özel yönergeler, belirli kodlama uygulamalarınızla ve teknik yığınınızla eşleşen yanıtlar alan yönergeleri açıklamanıza olanak tanır. Bu bağlamı her sohbet sorgusuna el ile eklemek yerine, özel yönergeler bu bilgileri her sohbet isteğiyle otomatik olarak birleştirir.

Note

Kod tamamlama işlemleri için özel yönergeler dikkate alınmaz.

Özel yönerge türleri

Visual Studio Code, özel yönergeleri tanımlamanın üç yolunu destekler:

Type Description Kullanım Örnekleri
.github/copilot-instructions.md Çalışma alanında, tüm isteklere otomatik olarak eklenen tek Markdown dosyası, düzenleyiciler arası destek. Genel kodlama uygulamaları, tercih edilen teknolojiler, proje genelindeki gereksinimler.
.instructions.md files Glob desen desteği, çalışma alanı veya kullanıcı profili depolaması ile birden çok Markdown dosyası. Göreve özgü yönergeler, yönergeler uygulandığında ayrıntılı denetim.
Visual Studio Code ayarları Belirli senaryolar için kullanıcı/çalışma alanı ayarlarındaki yönergeler. Kod oluşturma, test oluşturma, commit mesajları, kod incelemeleri, PR açıklamaları.

Bu yaklaşımları birleştirebilirsiniz, ancak öncelik sırası uygulanmadıkça çakışan yönergelerden kaçınabilirsiniz.

Özel yönergeler örnekleri

Genel kodlama yönergeleri:

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

TypeScript ve React yönergeleri:

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

.github/copilot-instructions.md dosyasını kullanma

Kodlama uygulamalarını, tercih edilen teknolojileri ve proje gereksinimlerini açıklamak için özel yönergeleri çalışma alanı kökünüzdeki bir .github/copilot-instructions.md dosyada depolayın. Bu yönergeler yalnızca çalışma alanı için geçerlidir ve her sohbet isteğine otomatik olarak eklenir.

Kurulum adımları:

  1. github.copilot.chat.codeGeneration.useInstructionFiles seçeneğini true olarak ayarlayın.
  2. Çalışma alanı kökünde .github/copilot-instructions.md oluşturun.
  3. Doğal dil ve Markdown biçimini kullanarak yönergeleri açıklayın.

Note

Bu dosya Visual Studio Code, Visual Studio ve GitHub.com genelinde çalışır.

.instructions.md dosyalarını kullanma

Belirli görevler, programlama dilleri, çerçeveler veya proje türleri için birden çok .instructions.md dosya oluşturun. Bunlar dosya desenlerine göre otomatik olarak uygulanabilir veya sohbet istemlerine el ile eklenebilir.

Dosya konumları:

  • Çalışma alanı dosyaları: Klasörde depolanır .github/instructions ve yalnızca çalışma alanı içinde kullanılabilir.
  • Kullanıcı dosyaları: Birden çok çalışma alanında kullanılabilen ve Ayarlar Eşitleme aracılığıyla eşitlenen Visual Studio Code profilinde depolanır.

Dosya yapısı:

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

Yönergeler dosyalarını oluşturma ve kullanma:

  1. Komut Paleti'nden Chat: New Instructions File çalıştırın.
  2. Çalışma alanını veya kullanıcı konumunu seçin.
  3. Markdown'da ad ve yazar yönergelerini girin.
  4. Mevcut dosyaları düzenlemek için kullanın Chat: Configure Instructions .

El ile ek:

  • Sohbet görünümünde: Bağlam > Yönergeleri Ekleme
  • Komut Paleti: Chat: Attach Instructions

Otomatik uygulama: Glob desenli meta verileri kullanın applyTo (** tüm istekler için, hedeflenen uygulama için belirli desenler)

Ayarlarda özel yönergeler belirtme

Belirli senaryolar için Visual Studio Code ayarlarında özel yönergeleri yapılandırın:

Scenario Setting
Kod oluşturma github.copilot.chat.codeGeneration.instructions
Test oluşturma github.copilot.chat.testGeneration.instructions
Kod gözden geçirme github.copilot.chat.reviewSelection.instructions
İletileri işleme github.copilot.chat.commitMessageGeneration.instructions
Çekme isteği başlıkları/açıklamaları github.copilot.chat.pullRequestDescriptionGeneration.instructions

Yönergeleri metin olarak tanımlayın veya dış dosyalara başvurun:

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

Özel yönergeler için en iyi yöntemler

  • Yönergeleri kısa tutun: Her yönerge tek ve basit bir deyim olmalıdır.
  • Dış başvurulardan kaçının: Dış kodlama standartlarına veya kaynaklarına başvurmayın.
  • Konuya göre düzenleme: Daha iyi bir düzenleme için yönergeleri birden çok dosyaya bölün.
  • Ekip paylaşımını etkinleştirme: Ekip işbirliği için yönergeleri sürüm denetimli dosyalarda depolayın.
  • Hedef uygulamayı kullanın: Dosyaya özgü yönergeler için applyTo özelliğinden faydalanın.
  • Verimli başvuru: Yinelemeyi önlemek için istem dosyalarındaki özel yönergelere başvurun.

Summary

GitHub Copilot Sohbeti'ndeki özel yönergeler, her sohbet isteğine otomatik olarak dahil edilen kodlama uygulamalarını, tercih edilen teknolojileri ve proje gereksinimlerini tanımlamanızı sağlar. Visual Studio Code ayarlarını, .github/copilot-instructions.md dosyalarını veya .instructions.md dosyalarını kullanarak yapay zeka tarafından oluşturulan yanıtların kodlama standartlarınıza ve proje gereksinimlerinize uygun olduğundan emin olabilirsiniz. Bu yaklaşım, kodlama işlemi üzerinde denetimi korurken yapay zeka yardımının kalitesini ve ilgi düzeyini artırır.