SQL Server Management Studio'da GitHub Copilot aracı becerilerini kullanma

Ajan becerileri, GitHub Copilot’a belirli görevleri nasıl gerçekleştireceğini söyleyen yeniden kullanılabilir yönerge kümeleridir. Her beceri, bir kez tanımladığınız, zaman kazandıran ve iş akışınızda tutarlı davranışlar sağlayan bir markdown dosyasıdır. Becerileri bir runbook olarak düşünün, dev bir istem olarak değil. Agent modu (önizleme) kullandığınızda, Copilot istediğinize göre ilgili becerileri otomatik olarak bulur ve uygular.

Uyarı

SQL Server Management Studio'de (SSMS) GitHub Copilot Aracı modu şu anda önizleme aşamasındadır.

Her yanıt için genel tercihleri ayarlayan özel yönergelerden farklı olarak, beceriler herhangi bir aracının keşfedebileceği ve kullanabileceği odaklanmış göreve özgü rehberlik sağlar. Bir beceriyi bir kez tanımlayın; bu beceri oturumlar ve ekibiniz genelinde tutarlı bir şekilde uygulanır.

Prerequisites

Agent becerileri nasıl çalışır?

Ajan modunu kullandığınızda Copilot, deponuz ve kullanıcı profilinizle ilgili bilinen beceri konumlarını tarar. Bir becerinin açıklaması isteğinizin amacıyla eşleşiyorsa Copilot beceriyi etkinleştirir ve yönergelerini ek bağlam olarak uygular. Bir beceri etkin olduğunda, bu becerinin adı sohbette görünür, böylece uygulandığını bilirsiniz.

Copilot, her becerinin ön bilgisindeki description alanına göre hangi becerilerin etkinleştirileceğine karar verir. Açık ve anahtar sözcükler açısından zengin bir açıklama, Copilot’un bir becerinin ne zaman uygun olduğunu belirlemesine yardımcı olur.

Beceri konumları

Copilot aşağıdaki konumlardan becerileri keşfeder:

Scope Paths Details
Çalışma alanı (ekibinizle paylaşılan) .github/skills/, .claude/skills/, .agents/skills/ Deponuzun kök dizininde depolanır. Tüm ekip üyelerinin aynı becerilere sahip olması için kaynak denetimine bağlı.
Kişisel (yalnızca profiliniz) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ Tüm projelerinizde geçerlidir. Herhangi bir depoya kaydedilmedi.

Projeye özgü kurallar için çalışma alanı becerileri önceliklidir. Kişisel beceriler, projeler arasında sizinle birlikte seyahat eden iş akışları ve tercihler için yararlıdır.

Beceri oluşturma

SSMS'deki Beceriler panelinden veya dosya sisteminizde el ile beceri oluşturabilirsiniz.

Beceriler panelinden beceri oluşturma

  1. Copilot Chat penceresinde Tools simgesini seçin.
  2. Beceriler panelini seçin.
  3. Beceriler panelinde düğmeyi + seçin.
  4. Kapsamı seçin: çalışma alanı becerisi (depoda depolanır) veya kişisel bir beceri (kullanıcı profilinizde depolanır).
  5. Beceri için bir ad girin. Ad dizin adı olur ve yalnızca küçük harfler, sayılar ve kısa çizgiler kullanmalıdır.
  6. SSMS, yeni beceri dizininde bir SKILL.md şablon oluşturur. Şablonu düzenleyin ve yönergelerinizi dosyaya ekleyin.

El ile bir beceri oluştur

  1. Uygun konumda bir beceri dizini oluşturun. Bir çalışma alanı becerisi için deponuzun kökünde .github/skills/ oluşturun.
  2. Beceriniz için bir alt dizin oluşturun. Her becerinin kendi dizini olmalıdır. Örneğin: .github/skills/tsql-style-guide/.
  3. Beceri dizini içinde bir SKILL.md dosya oluşturun.
  4. İsteğe bağlı olarak, betikler, başvuru belgeleri veya örnek çıktı gibi destekleyici dosyalar ekleyin.

Beceri dizini yapısı

your-repo/
└── .github/
    └── skills/
        └── index-verification/
        │   ├── SKILL.md          # Required: metadata and instructions
        │   └── references/       # Optional: supplementary documentation
        └── agent-job-failure-triage/
            ├── SKILL.md
            └── examples/         # Optional: example scripts

SKILL.md biçimi

Her SKILL.md dosyada YAML ön modeli ve ardından Markdown yönergeleri bulunmalıdır. Ön bilgi bölümü, Copilot’un beceriyi keşfetmek ve etkinleştirmek için kullandığı üst verileri sağlar.

Frontmatter özellikleri

Property Zorunlu Description
name Yes Yalnızca küçük harfler, sayılar ve kısa çizgiler. Üst dizin adıyla eşleşmelidir. En fazla 64 karakter.
description Yes Becerinin ne yaptığını ve ne zaman kullanılacağını açıklar. En fazla 1.024 karakter. Beceri uygun olduğunda işaret eden belirli anahtar sözcükler ekleyin.
license No Lisans adı veya beceriyle birlikte paketlenmiş bir lisans dosyasına atıf.
compatibility No Hedeflenen ürün veya gerekli sistem özellikleri gibi ortam gereksinimleri.
metadata No Diğer meta veriler için rastgele anahtar-değer çiftleri.
allowed-tools No Becerinin kullanılması için önceden onaylanan araç adlarının boşlukla ayrılmış listesi.

Beceriler panelinden becerileri yönetme

Copilot Chat penceresindeki Tools simgesini seçerek Skills panelini açın. Panel, geçerli oturumunuz için Copilot’un keşfettiği her beceriyi gösterir.

Panelden şunları yapabilirsiniz:

  • Düzenle: Herhangi bir becerinin SKILL.md dosyasını ... menüsünden doğrudan düzenleyicide açın.
  • Dosya konumunu açma: Disk üzerindeki beceri dizinine atlayın.
  • Arama: Becerileri ada veya anahtar kelimeye göre filtreleyin.

Panel ayrıca beceri yapılandırma hataları için tanılama bilgilerini ortaya çıkararak sorunları hızla belirleyip düzeltebilirsiniz.

Etkili beceriler yazmak için ipuçları

  • Kısa tutunSKILL.md: 300'in altında satır hedefleyin. Ayrıntılı başvuru malzemesini ilgili alt dizinlerdeki ayrı dosyalara taşıyın.
  • Anahtar sözcük açısından zengin bir açıklama yazın: Copilot becerinin ne zaman etkinleştireceğine karar vermek için description kullanır. Becerinin geçerli olduğu belirli görevleri, nesneleri ve senaryoları ekleyin.
  • Yordamlar için numaralandırılmış adımları kullanın: Modelin izlemesi, adım adım yönergelerden daha kolaydır.
  • Beklenen çıktı örneklerini ekleyin: Modelin "bitti" ifadesinin nasıl göründüğünü bilmesi için örnek kodu, tablo biçimlerini veya açıklama bloklarını gösterin.
  • Net sınırlar belirleyin: Beceriye ne yapmaması gerektiğini söyleyin. Örneğin, "Önce yazma hacmini raporlamadan, 10 milyondan fazla satır içeren tablolarda dizinlerin kaldırılmasını önermeyin."
  • Başvuru için destekleyici materyal: İlgili içeriği ve betikleri references\, scripts\ veya examples\ içindeki dosyalarda depolayın ve beceri içinden belirli içeriğe yönlendirin.

Örnek SQL becerileri

Aşağıdaki örnekler, yaygın SQL Server görevleri için becerilerin nasıl yazılacağını göstermektedir. Bunları bir başlangıç noktası olarak kullanın ve ekibinizin standartlarına göre uyarlayın.

Dizin doğrulama

Yinelemeyi önlemek için yeni dizinler önermeden önce mevcut dizinleri gözden geçirin.

---
name: index-verification
description: Use when an index recommendation has been generated and must be validated before implementation. Verifies workload benefit, redundancy, write overhead, storage impact, and existing index coverage.
---

# Index Verification

## Use this skill when

- A missing index recommendation exists
- An agent generated an index recommendation
- Query tuning suggests adding an index
- A user asks whether an index should be created

## Never assume

- Missing index DMVs are recommendations, not requirements.
- Do not recommend index creation until validation is complete.

## Verification Checklist

### 1. Check Existing Indexes

Determine whether:

- An equivalent index already exists
- A wider index already covers the workload
- Included columns already satisfy the query
- The recommendation duplicates another recommendation

### 2. Estimate Read Benefit

Evaluate:

- Query execution frequency
- Current execution cost
- Expected seek/selectivity improvement
- Number of affected queries

### 3. Evaluate Write Cost

Determine:

- Insert impact
- Update impact
- Delete impact
- Additional maintenance cost

### 4. Evaluate Storage Impact

Estimate:

- Index size on disk
- Memory pressure
- Replication impact

### 5. Make Recommendation

Return one of:

- Create index
- Modify existing index
- Consolidate with existing recommendation
- Reject recommendation

## Avoid

- Blindly trusting missing-index DMVs
- Creating overlapping indexes
- Recommending indexes for one-off queries
- Ignoring write-heavy workloads

## Output Format

Format output as a table: index name, columns, type, and recommendation (create / modify / consolidate / reject).

Ajan görev hatası ayıklaması

Başarısız SQL Aracısı işlerinin geçmişini analiz edin ve kök sorunu gidermek için önerilerde bulunun.

---
name: agent-job-failure-triage
description: Use when an automated job, workflow, maintenance task, or agent execution fails. Determines root cause and appropriate remediation while avoiding unsafe recovery actions.
---
# Agent Job Failure Triage

## Objective

Identify root cause before attempting remediation.

## First Rule

Never retry repeatedly without understanding why the job failed.

## Investigation Order

### 1. Collect Failure Details

Gather:

- Job name
- Error message
- Start time
- End time
- Retry history

### 2. Classify Failure

Determine whether failure is:

- Resource-related
- Permission-related
- Configuration-related
- Data-related
- Dependency-related
- Other or unknown

### 3. Check Recent Changes

Investigate:

- Deployments
- Configuration changes
- Schema changes
- Security changes
- Infrastructure changes

### 4. Determine Blast Radius

Identify:

- Data modified by job
- Schema modified by job
- Affected users or departments
- Downstream jobs
- SLA impact
- Data correctness risk

## Safe Actions

- Collect logs
- Validate dependencies
- Escalate when root cause is unknown

## Unsafe Actions

- Retry job
- Disable job
- Force-completing jobs
- Disabling validation checks
- Modifying production data to "make it pass"
- Restarting the SQL Agent service

İlgili içerik

  • Last updated on