Μετάβαση στο περιεχόμενο

Συνταγές

Πρακτικές συνταγές για καθημερινή εργασία Maguyva MCP. Κάθε συνταγή ονομάζει τα εργαλεία και την ακολουθία — όχι μια πλήρη αναφορά παραμέτρου. Για τις παραμέτρους του εργαλείου, χρησιμοποιήστε το MCP API Αναφορά. Για πρώτη εγκατάσταση, χρησιμοποιήστε το Γρήγορη εκκίνηση.

Επιλέξτε το σωστό εργαλείο#

Οι περισσότερες ερωτήσεις ξεκινούν με μια κλήση. Κλιμακώστε μόνο όταν η πρώτη απάντηση είναι πολύ ευρεία ή πολύ λεπτή.

  • intelligent_search — ξεκινήστε εδώ για οποιαδήποτε ερώτηση βάσης κώδικα φυσικής γλώσσας. δρομολογεί σε αναζήτηση semantic, symbol, δομική και dependency.
  • find_symbol — γνωρίζετε ήδη το όνομα της συνάρτησης, της κλάσης ή της μεταβλητής.
  • dependency_search — ακτίνα έκρηξης: καλούντες, εξαρτώμενα άτομα ή αντίκτυπο πριν (και μετά) μια επεξεργασία.
  • get_task_context — άγνωστη περιοχή. μια οριοθετημένη δέσμη αρχείων, symbol και εξαρτήσεις για μια περιγραφή εργασίας.
  • repository_context — λίστα προσβάσιμων αποθετηρίων ή επιθεωρήστε πώς επιλύεται το όνομα ενός χώρου αποθήκευσης.
  • ask_maguyva με operation="guidance" — τοπική βοήθεια για την επιλογή εργαλείου και τη χρήση του Maguyva (χωρίς μετάλλαξη repo).

Εγκαταστήστε και επαληθεύστε έναν πελάτη#

Αποκτήστε το Maguyva στον πελάτη MCP και επιβεβαιώστε τη σύνδεση με μια πραγματική λίστα αποθετηρίου.

  1. Δημιουργήστε ένα κλειδί API στο app.maguyva.ai (τα κλειδιά ξεκινούν με mgv_).
  2. Συνδέστε και δημιουργήστε ευρετήριο τουλάχιστον ενός αποθετηρίου GitHub που ήδη καταλαβαίνετε.
  3. Συνδέστε τον πελάτη σας χρησιμοποιώντας το Οδηγός εγκατάστασης (πρόσθετο Claude Code ή εγγενής απομακρυσμένη διαμόρφωση για Cursor, VS Code, Windsurf, Zed και άλλα).
  4. Ρωτήστε τον αντιπρόσωπό σας "Τι αποθετήρια έχω συνδέσει;" — που ασκεί έλεγχο ταυτότητας και repository_context από άκρη σε άκρη.
  5. Κάντε μια πραγματική ερώτηση σχετικά με αυτό το repo του οποίου την απάντηση μπορείτε να βαθμολογήσετε. Θα πρέπει να δείτε διαδρομές αρχείων και αριθμούς γραμμών από το δέντρο με ευρετήριο.

Κολλήσατε σε κλειδιά, γέφυρες ή λείπουν αποθετήρια; Αντιμετώπιση προβλημάτων.

Ρωτήστε πριν επεξεργαστείτε#

Χαρτογραφήστε τα symbol και την ακτίνα έκρηξης πριν αλλάξετε τον κοινόχρηστο κωδικό. Τα εργαλεία Maguyva δεν τροποποιούν τα αποθετήρια σας — ενημερώνουν την τροποποίηση που εφαρμόζει τοπικά ο πελάτης σας.

  1. Εάν γνωρίζετε το όνομα symbol, καλέστε το find_symbol για να βρείτε ορισμούς και χρήσεις.
  2. Εάν διαθέτετε μόνο μια περιγραφή εργασίας ("προσθήκη SSO", "διορθώστε το webhook χρέωσης"), ξεκινήστε με get_task_context ή intelligent_search.
  3. Πριν επεξεργαστείτε ένα κοινόχρηστο symbol, καλέστε το dependency_search με εξαρτώμενα/ανάλυση κρούσεων (ή περάστε αλλαγμένες διαδρομές για κρούση τύπου PR-), ώστε να δείτε την ακτίνα έκρηξης.
  4. Ανοίξτε τα αναφερόμενα αρχεία (τοπική ανάγνωση για αρχεία στο δίσκο, get_file για διαδρομές απομακρυσμένων/διασταυρούμενων repo) και επιβεβαιώστε το σχέδιο σε σχέση με τον πραγματικό κώδικα.
  5. Μετά την επεξεργασία, ελέγξτε ξανά τα ίδια symbol με το dependency_search (συμπεριλαμβανομένης της επαλήθευσης μετά την επεξεργασία όταν ο πελάτης σας υποστηρίζει τις σημαίες επαλήθευσης), ώστε οι καλούντες να εξακολουθούν να επιλύουν όπως αναμένεται.

Πλήρεις παράμετροι: MCP API Αναφορά.

Ψάξε και μετά άλλαξε#

Ένας προεπιλεγμένος βρόχος πράκτορα: εξερεύνηση → καρφίτσωμα symbol (συμβόλων) → επεξεργασία με στοιχεία.

  1. Ξεκινήστε με το intelligent_search και ένα ερώτημα σε απλή γλώσσα ("πώς λειτουργεί η λήξη της περιόδου λειτουργίας", "πού είναι η λογική επανάληψης δοκιμής").
  2. Περιορίστε με φίλτρα γλώσσας ή διαδρομής όταν το πρώτο παράθυρο είναι θορυβώδες.
  3. Προωθήστε υποσχόμενες επιτυχίες σε find_symbol ή dependency_search αντί να κάνετε ξανά την ίδια ασαφή ερώτηση.
  4. Χρησιμοποιήστε το get_file μόνο όταν χρειάζεστε μια συγκεκριμένη διαδρομή με ευρετήριο που δεν βρίσκεται στο δίσκο.
  5. Επεξεργαστείτε στα κανονικά εργαλεία πελάτη σας. Το Maguyva είναι για ανακάλυψη και επαλήθευση — δεν γράφει.

Γιατί λειτουργεί αυτός ο βρόχος: Πώς λειτουργεί.

Κενά ή λεπτά αποτελέσματα#

Όταν τα εργαλεία δεν επιστρέφουν τίποτα χρήσιμο, διορθώστε την ανάλυση και την ευρετηρίαση πριν ξαναγράψετε το ερώτημα για πάντα.

  1. Επιβεβαιώστε ότι το αποθετήριο είναι συνδεδεμένο και ολοκληρώθηκε η δημιουργία ευρετηρίου στο app.maguyva.ai.
  2. Ελέγξτε τη συμβολοσειρά του αποθετηρίου: Το "owner/repo" χρησιμοποιεί τον προεπιλεγμένο κλάδο. Το "owner/repo:branch" καρφιτσώνει έναν κλάδο. Η αντιστοίχιση είναι χωρίς διάκριση πεζών-κεφαλαίων, όχι ασαφής — τα τυπογραφικά λάθη δεν διορθώνονται αυτόματα.
  3. Καλέστε το repository_context με το action="info" και επιθεωρήστε τα μεταδεδομένα ανάλυσης (για παράδειγμα metadata.resolution_reason).
  4. Παραλείψτε το repository μόνο όταν ο πελάτης σας MCP παρέχει μια προεπιλογή αιτήματος ή το κλειδί μπορεί να έχει πρόσβαση ακριβώς σε ένα χώρο αποθήκευσης. αλλιώς περάστε το ρητά.
  5. Δοκιμάστε ξανά με ένα πιο συγκεκριμένο ερώτημα, ένα γνωστό όνομα symbol μέσω find_symbol ή ένα φίλτρο γλώσσας/διαδρομής. Εάν η ίδια η σύνδεση είναι σπασμένη, χρησιμοποιήστε το Αντιμετώπιση προβλημάτων.

Αποτυχίες εγκατάστασης: Αντιμετώπιση προβλημάτων.

Εργαστείτε σε πολλαπλά αποθετήρια#

Στοχεύστε το σωστό αποθετήριο με ευρετήριο όταν ένα κλειδί μπορεί να δει περισσότερα από ένα.

  1. Καλέστε το repository_context με το action="list" μία φορά για να μάθετε τις ακριβείς γυμνοσάλιαγκες που μπορεί να αναζητήσει το κλειδί σας.
  2. Περάστε ρητά το repository στην αναζήτηση και τα εργαλεία symbol όταν χρειάζεστε ένα μη προεπιλεγμένο αποθετήριο (για παράδειγμα "owner/other-repo" ή "owner/other-repo:develop").
  3. Κρατήστε μία ερώτηση = ένα αποθετήριο, εκτός εάν συγκρίνετε σκόπιμα τα αποθετήρια σε ξεχωριστές κλήσεις.
  4. Χρησιμοποιήστε το get_file όταν το αρχείο βρίσκεται σε ένα αποθετήριο με ευρετήριο που δεν είναι το τρέχον δέντρο εργασίας σας.
  5. Θυμηθείτε: τα εργαλεία δεν γράφουν ποτέ πίσω στο GitHub — το περιβάλλον πολλαπλών αποθετηρίων είναι μόνο για ανάγνωση και προγραμματισμό.

Λεπτομέρειες μορφής αποθετηρίου: MCP API Αναφορά.

Νέος στο Maguyva; Περπατήστε πρώτα στο Γρήγορη εκκίνηση και μετά επιστρέψτε εδώ για βρόχους της δεύτερης ημέρας.

Επόμενα βήματα#