// perjanjian
copilot-instructions.md
Macam mana Copilot patut berkelakuan pada repo ini.
Untuk pengguna GitHub Copilot CLI
Copilot memulakan setiap sesi secara buta.
Arahan tersuai memberitahu Copilot cara berkelakuan. Ia tidak memberitahu apa yang ada dalam repo anda. Maguyva mengindeks pangkalan kod dan menyajikannya semula melalui MCP, supaya GitHub Copilot CLI menyunting seolah-olah ia sudah membaca kod tersebut.
Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.
Gunakan arahan untuk kelakuan. Gunakan Maguyva untuk fakta pangkalan kod semasa.Stack berlapis
Empat idea. Setiap satu buat satu kerja.
// pengangkutan
MCP
Macam mana Copilot mencapai alat luaran dan konteks.
// pangkalan kod
Maguyva
Pelayan MCP yang pulangkan fakta repo yang terbukti.
// siapa bayar
Ruang kerja, bukan pengguna
Tiada caj per pengguna untuk ejen. Lihat harga
Arahan tersuai ialah perjanjian kerja. Gunakannya.
# .github/copilot-instructions.md
- Utamakan sempadan modul sedia ada.
- Jalankan arahan ujian repo sebelum anda mencadangkan merge.
- Jangan reka laluan fail. Tanya dahulu sebelum anda membuat pakej baharu.Arahan berterusan tergolong dalam .github/copilot-instructions.md. Itulah tempat yang sesuai untuk:
- Arahan build, test dan lint yang perlu dijalankan oleh Copilot.
- Garis panduan “sentiasa buat X / jangan sekali-kali buat Y” khusus untuk repo ini.
- Konvensyen penamaan dan keutamaan semakan.
- Petunjuk kepada log keputusan — bukan longgokan setiap simbol.
Fail itu tidak pernah menjadi indeks repo yang boleh dipertanyakan. Ia memberitahu Copilot cara bekerja. Ia tidak memberitahu apa yang ada di situ.
Di mana arahan tersuai berhenti bertahan pada skala besar
Empat mod kegagalan yang tidak dapat diperbaiki Copilot daripada fail markdown.
// arahan 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 pokok yang tidak dikenali ialah tekaan terhadap struktur fail.
// dokumen menjadi lapuk, kod tidak
Blok arahan yang menghuraikan aliran pengesahan suku tahun lalu jelas salah pada hari seseorang memecahkan storan sesi. Copilot will prefer the file you committed over the code that shipped.
// pergantungan tiada dalam markdown
“Apa yang mengimport ini?” is a graph question. Arahan tidak boleh menyenaraikan setiap pemanggil, dan anda pun tidak akan mahukannya.
// tetingkap konteks mempunyai bajet
Menyumbat lebih banyak repo ke dalam arahan menukar token penaakulan dengan gambaran yang lapuk. Selepas beberapa KB, anda membayar untuk peta yang lebih buruk.
Maguyva sebagai lapisan tambahan
Copilot sudah berfikir dalam arahan dan alat.
copilot-instructions.md
perjanjian
cara Copilot berkelakuan
MCP
saluran
cara ia sampai
Maguyva
fakta pangkalan kod
apa yang dilihatnya
- Peta repo yang boleh dipertanyakan disajikan melalui MCP sebagai pelayan streamable-HTTP jauh.
- 11 alat berorientasikan pelanggan merentasi carian semantik, struktur (AST), graf dan teks, ditambah simbol, pergantung dan pengambilan fail.
- Keputusan tersusun dengan laluan fail dan nombor baris merentasi lebih 284 bahasa dan teknologi berasaskan teks.
- Satu konfigurasi Workspace yang sama menjawab dalam Copilot, Claude Code, Cursor, Codex dan mana-mana klien serasi MCP yang lain.
Arahan tersuai memberitahu Copilot cara berkelakuan.
Maguyva memberi Copilot peta kod yang boleh dipertanyakan.
Tiga aliran kerja
Tanya peta sebelum anda menerima diff.
// workflow 01
Cari pelaksanaan sebenar, bukan stub ujian
copilot> bagaimana normalizePhoneNumber mengendalikan E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← impl. sebenar test/util/phone.spec.ts:14 jest.mock(...) ← stub → Copilot membuka pelaksanaan, bukan mock. [exit 0]
Nama boleh menipu. Mock menyembunyikan kod sebenar. Maguyva menyusun pelaksanaan sebenar mengatasi mock ujian.
// workflow 02
Semak radius kesan sebelum anda melakukan refactor
copilot> apa yang memanggil QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 dalam src/billing/* 1 dalam src/audit/* 1 dalam src/notifications/* → Diff diasaskan pada pengimport sebenar. [exit 0]
Titik panggilan merentas pakej muncul secara terus. Diff diasaskan pada pengimport sebenar, bukan grep Copilot.
// workflow 03
Namakan semula kelas yang dikongsi, cari setiap pergantungan dahulu
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 rujukan dalam 7 pakej graph::importers(src/payments/client.ts) 9 pengimport graph::extends(PaymentClient) 2 subkelas (RetryClient, MockClient) → Copilot mencadangkan migrasi dengan senarai fail secara terus. [exit 0]
Copilot bertanya kepada Maguyva tentang pergantungan sebelum ia mula menyunting. Senarai migrasi kembali diasaskan pada graf sebenar, bukan ingatan Copilot.
Persediaan dalam GitHub Copilot CLI
Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.
// step 01
Indeks satu repo di maguyva.ai
Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya. Daftar percuma, sambungkan GitHub, tunggu pengindeksan.
// step 02
Tambah Maguyva sebagai pelayan MCP jauh dalam 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
Tanya satu soalan yang anda sudah tahu jawapannya
Jangan mula dengan seluruh syarikat. Tanya satu soalan yang anda sudah tahu jawapannya, kemudian buka fail yang disebut.