Langkau ke kandungan

Buku Resipi

Resipi praktikal untuk kerja Maguyva MCP setiap hari. Setiap resipi menamakan alatan dan urutan — bukan rujukan parameter penuh. Untuk parameter alat, gunakan Rujukan MCP API. Untuk persediaan kali pertama, gunakan Mula pantas.

Pilih alat yang betul#

Kebanyakan soalan bermula dengan satu panggilan. Tingkatkan hanya apabila jawapan pertama terlalu luas atau terlalu nipis.

  • intelligent_search — mulakan di sini untuk sebarang soalan asas kod bahasa semula jadi; ia merentasi carian semantic, symbol, struktur dan dependency.
  • find_symbol — anda sudah tahu fungsi, kelas atau nama pembolehubah.
  • dependency_search — jejari letupan: pemanggil, tanggungan atau kesan sebelum (dan selepas) suntingan.
  • get_task_context — kawasan yang tidak dikenali; satu berkas terhad fail, symbol dan kebergantungan untuk penerangan tugas.
  • repository_context — senaraikan repositori yang boleh diakses atau periksa cara nama repositori diselesaikan.
  • ask_maguyva dengan operation="guidance" — bantuan setempat pada pemilihan alat dan penggunaan Maguyva (tiada mutasi repo).

Pasang dan sahkan pelanggan#

Dapatkan Maguyva ke dalam klien MCP anda dan sahkan sambungan dengan senarai repositori sebenar.

  1. Cipta kunci API dalam app.maguyva.ai (kunci bermula dengan mgv_).
  2. Sambung dan indeks sekurang-kurangnya satu repositori GitHub yang anda sudah fahami.
  3. Sambungkan pelanggan anda menggunakan Panduan Pemasangan (pemalam Claude Code, atau konfigurasi jauh asli untuk Cursor, VS Code, Windsurf, Zed dan lain-lain).
  4. Tanya ejen anda "Apakah repositori yang saya sambungkan?" — yang menjalankan pengesahan dan repository_context hujung ke hujung.
  5. Tanya satu soalan sebenar tentang repo itu yang jawapannya boleh anda nilai. Anda sepatutnya melihat laluan fail dan nombor baris daripada pokok yang diindeks.

Terperangkap pada kunci, jambatan atau repo yang hilang? Menyelesaikan masalah.

Tanya sebelum anda mengedit#

Petakan symbol dan jejari letupan sebelum menukar kod kongsi. Alat Maguyva tidak mengubah suai repositori anda — ia memaklumkan pengeditan pelanggan anda digunakan secara setempat.

  1. Jika anda tahu nama symbol, hubungi find_symbol untuk mendapatkan definisi dan kegunaan.
  2. Jika anda hanya mempunyai perihalan tugasan ("tambah SSO", "betulkan webhook pengebilan"), mulakan dengan get_task_context atau intelligent_search.
  3. Sebelum mengedit symbol yang dikongsi, hubungi dependency_search dengan tanggungan/analisis kesan (atau lulus laluan yang diubah untuk kesan gaya PR-) supaya anda melihat jejari letupan.
  4. Buka fail yang dipetik (bacaan tempatan untuk fail pada cakera; get_file untuk laluan jauh/rentas repo) dan sahkan pelan terhadap kod sebenar.
  5. Selepas pengeditan, semak semula symbol yang sama dengan dependency_search (termasuk pengesahan pasca edit apabila pelanggan anda menyokong bendera pengesahan) supaya pemanggil masih menyelesaikan seperti yang diharapkan.

Parameter penuh: Rujukan MCP API.

Cari, kemudian tukar#

Gelung ejen lalai: teroka → pin symbols → edit dengan bukti.

  1. Mulakan dengan intelligent_search dan pertanyaan bahasa biasa ("bagaimana sesi tamat tempoh berfungsi", "di manakah logik cuba semula").
  2. Sempit dengan penapis bahasa atau laluan apabila tetingkap pertama bising.
  3. Promosikan hits yang menjanjikan kepada find_symbol atau dependency_search dan bukannya bertanya semula soalan samar-samar yang sama.
  4. Gunakan get_file hanya apabila anda memerlukan laluan diindeks khusus yang tiada pada cakera.
  5. Edit dalam alatan pelanggan biasa anda. Maguyva adalah untuk penemuan dan pengesahan — bukan penulisan.

Mengapa gelung ini berfungsi: Bagaimana Ia Berfungsi.

Hasil kosong atau nipis#

Apabila alat tidak mengembalikan apa-apa yang berguna, betulkan resolusi dan pengindeksan sebelum menulis semula pertanyaan selama-lamanya.

  1. Sahkan repositori disambungkan dan selesai pengindeksan dalam app.maguyva.ai.
  2. Semak rentetan repositori: "owner/repo" menggunakan cawangan lalai; "owner/repo:branch" menyematkan cawangan. Pemadanan tidak peka huruf besar-besaran, tidak kabur — kesilapan silap tidak dibetulkan secara automatik.
  3. Panggil repository_context dengan action="info" dan periksa metadata resolusi (contohnya metadata.resolution_reason).
  4. Abaikan repository hanya apabila pelanggan MCP anda membekalkan permintaan lalai atau kunci boleh mengakses tepat satu repositori; jika tidak luluskannya secara eksplisit.
  5. Cuba semula dengan pertanyaan yang lebih khusus, nama symbol yang diketahui melalui find_symbol atau penapis bahasa/laluan. Jika sambungan itu sendiri terputus, gunakan Menyelesaikan masalah.

Kegagalan persediaan: Menyelesaikan masalah.

Bekerja merentasi berbilang repositori#

Sasarkan repo diindeks yang betul apabila kunci boleh melihat lebih daripada satu.

  1. Panggil repository_context dengan action="list" sekali untuk mengetahui slug tepat yang boleh dicari oleh kunci anda.
  2. Lulus repository secara eksplisit pada carian dan alat symbol apabila anda memerlukan repo bukan lalai (contohnya "owner/other-repo" atau "owner/other-repo:develop").
  3. Simpan satu soalan = satu repositori melainkan anda sengaja membandingkan merentas repo dalam panggilan berasingan.
  4. Gunakan get_file apabila fail berada dalam repo terindeks yang bukan pokok kerja semasa anda.
  5. Ingat: alatan jangan sekali-kali menulis kembali kepada GitHub — context berbilang repo adalah untuk bacaan dan perancangan sahaja.

Butiran format repositori: Rujukan MCP API.

Baru menggunakan Maguyva? Berjalan Mula pantas dahulu, kemudian kembali ke sini untuk gelung hari kedua.

Langkah seterusnya#