İçeriğe atla

GitHub Copilot CLI kullanıcıları için

Copilot her oturuma kör başlar.

Özel talimatlar Copilot'a nasıl davranması gerektiğini söyler. Deponuzda ne olduğunu söylemez. Maguyva kod tabanını dizinler ve MCP üzerinden geri sunar, böylece GitHub Copilot CLI kodu zaten okumuş gibi düzenleme yapar.

Ücretsiz başlaCopilot kurulumunu oku

Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

Davranış için talimatları kullanın. Güncel kod tabanı gerçekleri için Maguyva'yı kullanın.

Katmanlı yığın

Dört fikir. Her biri tek bir iş yapar.

// anlaşma

copilot-instructions.md

Copilot’un bu repoda nasıl davranması gerektiği.

// taşıma

MCP

Copilot’un harici araçlara ve bağlama nasıl uzandığı.

// kod tabanı

Maguyva

Temellendirilmiş repo bilgilerini döndüren MCP sunucusu.

Özel talimatlar bir çalışma anlaşmasıdır. Onları kullanın.

# .github/copilot-instructions.md
- Mevcut modül sınırlarını tercih edin.
- Bir merge önermeden önce deponun test komutunu çalıştırın.
- Dosya yolları uydurmayın. Yeni bir paket oluşturmadan önce sorun.

Kalıcı talimatlar şuraya aittir: .github/copilot-instructions.md. Burası şunlar için doğru yerdir:

  • Copilot'un çalıştırması gereken build, test ve lint komutları.
  • Bu depoya özgü “Her zaman X yap / asla Y yapma” kuralları.
  • Adlandırma kuralları ve inceleme tercihleri.
  • Karar günlüğüne işaretçiler — her sembolün dökümü değil.

O dosya asla deponun sorgulanabilir bir dizini olmadı. Copilot'a nasıl çalışacağını söyler. Orada ne olduğunu söylemez.

Özel talimatların büyük ölçekte yetersiz kaldığı yerler

Copilot'un bir markdown dosyasından düzeltemeyeceği dört hata modu.

// talimatlar bir dizin değildir

Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. Bilinmeyen bir ağaç üzerindeki ilk düzenleme, dosya yapısı hakkında bir tahmindir.

// dokümanlar eskir, kod eskimez

Geçen çeyreğin auth akışını açıklayan bir talimat bloğu, birisi oturum deposunu böldüğü gün kesinlikle yanlış olur. Copilot will prefer the file you committed over the code that shipped.

// bağımlılıklar markdown'da değildir

“Bunu ne içe aktarıyor?” is a graph question. Talimatlar her çağıranı listeleyemez ve bunu istemezsiniz zaten.

// bağlam pencerelerinin bir bütçesi vardır

Talimatlara deponun daha fazlasını sıkıştırmak, akıl yürütme token'larını eski bir anlık görüntüyle takas eder. Birkaç KB'den sonra daha kötü bir harita için ödeme yaparsınız.

Ek katman olarak Maguyva

Copilot zaten talimatlar ve araçlar cinsinden düşünüyor.

copilot-instructions.md

anlaşma

Copilot nasıl davranır

MCP

kanal

nasıl ulaşır

Maguyva

kod tabanı gerçekleri

ne görür

  • Deponun sorgulanabilir bir haritası uzak bir streamable-HTTP sunucusu olarak MCP üzerinden sunulur.
  • 11 müşteriye yönelik araç anlamsal, yapısal (AST), grafik ve metin aramada, ayrıca semboller, bağımlılar ve dosya alma.
  • Dosya yolları ve satır numaralarıyla sıralanmış sonuçlar 284+ dil ve metin tabanlı teknolojide.
  • Tek bir yapılandırma Aynı workspace Copilot, Claude Code, Cursor, Codex ve diğer tüm MCP uyumlu istemcilerde yanıt verir.

Özel talimatlar Copilot'a nasıl davranması gerektiğini söyler.

Maguyva, Copilot'a kodun sorgulanabilir bir haritasını verir.

Üç iş akışı

Diff'i kabul etmeden önce haritaya sorun.

// workflow 01

Test stub'ını değil, gerçek uygulamayı bulun

copilot> normalizePhoneNumber E.164'ü nasıl işler?

semantic::query("normalize phone E.164")
  src/util/phone.ts:88   normalizePhoneNumber()   ← gerçek impl.
  test/util/phone.spec.ts:14  jest.mock(...)      ← stub

→ Copilot mock'u değil, uygulamayı açar.
[exit 0]

İsimler yanıltır. Mock'lar gerçek kodu gizler. Maguyva gerçek uygulamayı test mock'unun üstünde sıralar.

// workflow 02

Yeniden düzenlemeden önce etki alanını kontrol edin

copilot> QueueDispatcher.publish'i ne çağırıyor?

graph::callers(QueueDispatcher.publish)
  src/billing/*'te 3    src/audit/*'te 1    src/notifications/*'te 1

→ Diff, gerçek içe aktarıcılara dayanır.
[exit 0]

Paketler arası çağrı noktaları doğrudan görünür. Diff, gerçek içe aktarıcılara dayanır, Copilot'un grep'ine değil.

// workflow 03

Paylaşılan bir sınıfı yeniden adlandırın, önce her bağımlılığı bulun

copilot> rename PaymentClient → BillingClient

graph::callers(PaymentClient)            7 pakette 12 referans
graph::importers(src/payments/client.ts)  9 içe aktarıcı
graph::extends(PaymentClient)             2 alt sınıf (RetryClient, MockClient)

→ Copilot, dosya listesiyle birlikte bir geçiş önerir.
[exit 0]

Copilot, düzenlemeye başlamadan önce Maguyva'ya bağımlıları sorar. Geçiş listesi, Copilot'un hafızasına değil, gerçek grafiğe dayanarak döner.

GitHub Copilot CLI'de kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

  1. // step 01

    maguyva.ai'de bir depoyu dizinleyin

    Zaten bildiğiniz birini seçin, böylece yanıtları değerlendirebilirsiniz. Ücretsiz kaydolun, GitHub'ı bağlayın, dizinlemeyi bekleyin.

  2. // step 02

    Copilot'a Maguyva'yı uzak bir MCP sunucusu olarak ekleyin

    copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

    ~/.copilot/mcp-config.json

    {
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

  3. // step 03

    Cevabını zaten bildiğiniz bir soru sorun

    Tüm şirketle başlamayın. Cevabını zaten bildiğiniz bir soru sorun, ardından alıntılanan dosyayı açın.

Self servis kayıtlar açık.

Zaten bildiğiniz bir depoyu dizinleyin.

GitHub Copilot CLI'yi o deponun haritasına bağlayın, ardından kontrol edebileceğiniz bir soru sorun.

İlk deponuzu indeksleyinUyumluluk dokümanlarına bak

ücretsiz plan: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.