// kesepakatan
copilot-instructions.md
Bagaimana Copilot seharusnya berperilaku di repo ini.
Untuk pengguna GitHub Copilot CLI
Copilot memulai setiap sesi secara buta.
Instruksi khusus memberi tahu Copilot cara berperilaku. Instruksi itu tidak memberi tahu apa yang ada di repo Anda. Maguyva mengindeks basis kode dan menyajikannya kembali lewat MCP, sehingga GitHub Copilot CLI menyunting seolah sudah membaca kodenya.
Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.
Gunakan instruksi untuk perilaku. Gunakan Maguyva untuk fakta basis kode terkini.Stack berlapis
Empat gagasan. Masing-masing menjalankan satu tugas.
// transport
MCP
Bagaimana Copilot menjangkau tool dan konteks eksternal.
// codebase
Maguyva
Server MCP yang mengembalikan fakta repo yang berlandaskan bukti nyata.
// yang bayar
Workspace, bukan pengguna
Tidak ada biaya terpisah per agen. Lihat harga
Instruksi khusus adalah kesepakatan kerja. Gunakan itu.
# .github/copilot-instructions.md
- Utamakan batas modul yang sudah ada.
- Jalankan perintah uji repo sebelum mengusulkan merge.
- Jangan mengarang jalur berkas. Tanyakan dulu sebelum membuat paket baru.Instruksi persisten berada di .github/copilot-instructions.md. Itu adalah tempat yang tepat untuk:
- Perintah build, test, dan lint yang harus dijalankan Copilot.
- Pedoman “selalu lakukan X / jangan pernah lakukan Y” yang berlaku untuk repo ini.
- Konvensi penamaan dan preferensi review.
- Petunjuk ke log keputusan — bukan dump setiap simbol.
Berkas itu tidak pernah menjadi indeks repo yang dapat dikueri. Berkas itu memberi tahu Copilot cara bekerja. Tidak memberi tahu apa yang ada di sana.
Di mana instruksi khusus berhenti bertahan dalam skala besar
Empat mode kegagalan yang tidak dapat diperbaiki Copilot dari file markdown.
// instruksi bukan indeks
Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. Suntingan pertama pada pohon yang tidak dikenal adalah tebakan terhadap struktur berkas.
// dokumen menjadi usang, kode tidak
Blok instruksi yang menjelaskan alur autentikasi kuartal lalu jelas salah pada hari seseorang memecah penyimpanan sesi. Copilot will prefer the file you committed over the code that shipped.
// dependensi tidak ada di markdown
“Apa yang mengimpor ini?” is a graph question. Instruksi tidak dapat mendaftar setiap pemanggil, dan Anda pun tidak akan menginginkannya.
// jendela konteks punya anggaran
Menjejalkan lebih banyak repo ke dalam instruksi menukar token penalaran dengan cuplikan yang usang. Setelah beberapa KB, Anda membayar untuk peta yang lebih buruk.
Maguyva sebagai lapisan tambahan
Copilot sudah berpikir dalam instruksi dan alat.
copilot-instructions.md
kesepakatan
cara Copilot berperilaku
MCP
salurannya
cara mencapainya
Maguyva
fakta basis kode
apa yang dilihatnya
- Peta repo yang dapat dikueri disajikan lewat MCP sebagai server streamable-HTTP jarak jauh.
- 11 alat yang menghadap pelanggan di pencarian semantik, struktural (AST), graf, dan teks, ditambah simbol, dependen, dan pengambilan berkas.
- Hasil berperingkat dengan jalur berkas dan nomor baris di lebih dari 284 bahasa dan teknologi berbasis teks.
- Satu konfigurasi Workspace yang sama menjawab di Copilot, Claude Code, Cursor, Codex, dan klien lain yang kompatibel dengan MCP.
Instruksi khusus memberi tahu Copilot cara berperilaku.
Maguyva memberi Copilot peta kode yang dapat dikueri.
Tiga alur kerja
Tanyakan ke peta sebelum Anda menerima diff.
// workflow 01
Temukan implementasi asli, bukan stub pengujian
copilot> bagaimana normalizePhoneNumber menangani E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← impl. asli test/util/phone.spec.ts:14 jest.mock(...) ← stub → Copilot membuka implementasi, bukan mock. [exit 0]
Nama bisa menipu. Mock menyembunyikan kode asli. Maguyva memprioritaskan implementasi asli di atas mock pengujian.
// workflow 02
Periksa radius dampak sebelum melakukan refactor
copilot> apa yang memanggil QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 di src/billing/* 1 di src/audit/* 1 di src/notifications/* → Diff didasarkan pada pengimpor sebenarnya. [exit 0]
Titik pemanggilan lintas paket muncul langsung. Diff didasarkan pada pengimpor sebenarnya, bukan grep milik Copilot.
// workflow 03
Ganti nama kelas bersama, temukan dulu setiap dependen
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 referensi di 7 paket graph::importers(src/payments/client.ts) 9 pengimpor graph::extends(PaymentClient) 2 subkelas (RetryClient, MockClient) → Copilot mengusulkan migrasi dengan daftar file secara langsung. [exit 0]
Copilot bertanya kepada Maguyva tentang dependen sebelum mulai menyunting. Daftar migrasi kembali berdasarkan graf sebenarnya, bukan ingatan Copilot.
Penyiapan di GitHub Copilot CLI
Tiga langkah. Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.
// step 01
Indeks satu repo di maguyva.ai
Pilih yang sudah Anda kenal, agar Anda dapat menilai jawabannya. Daftar gratis, hubungkan GitHub, tunggu proses indeks.
// step 02
Tambahkan Maguyva sebagai server MCP jarak jauh di Copilot
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" } } } }// step 03
Ajukan satu pertanyaan yang jawabannya sudah Anda ketahui
Jangan mulai dengan seluruh perusahaan. Ajukan satu pertanyaan yang jawabannya sudah Anda ketahui, lalu buka berkas yang dikutip.