// πλαίσιο
GEMINI.md
Πώς πρέπει να συμπεριφέρεται το Gemini σε αυτό το αποθετήριο.
Για χρήστες Gemini CLI
Το GEMINI.md λέει στο Gemini τους κανόνες σας.
Όχι τον κώδικά σας.
Το GEMINI.md ορίζει το πλαίσιο εργασίας. Το MCP επιτρέπει στο Gemini να απλώνεται σε εργαλεία. Το Maguyva είναι ο διακομιστής MCP που δίνει στο Gemini έναν χάρτη του αποθετηρίου σας με δυνατότητα ερωτημάτων, ώστε η πρώτη επεξεργασία να μην είναι μαντεψιά για τη δομή των αρχείων.
Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.
Το GEMINI.md είναι το πλαίσιο. Το MCP είναι το κανάλι. Το Maguyva είναι ο χάρτης.Η στοίβα επιπέδων
Τέσσερις ιδέες. Η καθεμία κάνει μία δουλειά.
// μεταφορά
MCP
Πώς απλώνεται το Gemini σε εξωτερικά εργαλεία και πλαίσιο.
// κώδικας βάσης
Maguyva
Ο διακομιστής MCP που επιστρέφει τεκμηριωμένα δεδομένα αποθετηρίου.
// ποιος πληρώνει
Χώροι εργασίας, όχι θέσεις
Οι πράκτορες δεν πληρώνουν θέσεις. Δείτε τις τιμές
Το GEMINI.md είναι πλαίσιο εργασίας. Χρησιμοποιήστε το.
Οι μόνιμες οδηγίες ανήκουν στο GEMINI.md. Είναι το σωστό μέρος για:
- Εντολές κατασκευής, δοκιμών και λίντινγκ που πρέπει να τρέχει το Gemini.
- Κανόνες “πάντα κάνε X / ποτέ μην κάνεις Y” με εμβέλεια έναν φάκελο.
- Συμβάσεις ονοματοδοσίας και προτιμήσεις αναδιαμόρφωσης.
- Παραπομπές στα κανονικά αρχεία αποφάσεων και τις σημειώσεις αρχιτεκτονικής.
Κρατήστε το συνοπτικό. Δώστε του εμβέλεια. Κάντε υποβολή του.
Όμως το GEMINI.md δεν σχεδιάστηκε ποτέ για να είναι ένα ευρετήριο με δυνατότητα ερωτημάτων για κάθε σύμβολο, αρχείο και σημείο κλήσης στο αποθετήριό σας.
Πού το GEMINI.md από μόνο του εξαντλείται
Τέσσερις τρόποι αστοχίας, ένας ανά κάρτα.
// το πλαίσιο δεν είναι ευρετήριο
Το να λέτε στο Gemini πώς να δουλέψει δεν του λέει τι υπάρχει. Η πρώτη επεξεργασία σε ένα άγνωστο πακέτο είναι μαντεψιά για διαδρομές αρχείων και ονόματα συναρτήσεων. Το GEMINI.md δεν μπορεί να απαριθμήσει κάθε σύμβολο, και δεν θα το θέλατε ούτως ή άλλως.
// το έγγραφο ξεπερνιέται από τον κώδικα
Ένα τμήμα του GEMINI.md που περιγράφει την τοπολογία της ουράς σας είναι σωστό μέχρι κάποιος να προσθέσει έναν νέο καταναλωτή. Ο κώδικας είναι πλέον η πηγή αλήθειας και το έγγραφο είναι με σιγουριά ξεπερασμένο. Το Gemini διαβάζει το λάθος.
// η μετονομασία είναι πρόβλημα γραφήματος
Το «Ποιος αναφέρεται σε αυτή την κλάση;» δεν απαντιέται από ένα αρχείο markdown. Το Gemini είτε κάνει grep-και-εύχεται σε όλο το ενιαίο αποθετήριο, είτε σας ζητά να επικολλήσετε σημεία κλήσης στη συνομιλία.
// τα παράθυρα πλαισίου δεν είναι δωρεάν
Ένα μεγάλο παράθυρο δεν είναι το ίδιο με ένα ευρετήριο με δυνατότητα ερωτημάτων. Το να φορτώνετε το GEMINI.md μέχρι το Gemini να «ξέρει αρκετά» εξακολουθεί να ανταλλάσσει προϋπολογισμό συλλογιστικής με στατικό όγκο πλαισίου.
Πώς ταιριάζουν τα τρία επίπεδα μεταξύ τους
Οι χρήστες του Gemini ήδη σκέφτονται με αυτό το σχήμα. Η σελίδα πρέπει να το κάνει προφανές.
GEMINI.md
πλαίσιο
πώς συμπεριφέρεται το Gemini
MCP
το κανάλι
πώς απλώνεται
Maguyva
δεδομένα βάσης κώδικα
τι βλέπει
- GEMINI.md πώς συμπεριφέρεται το Gemini σε αυτό το αποθετήριο.
- MCP πώς απλώνεται το Gemini σε εργαλεία και πλαίσιο. (προδιαγραφή)
- Maguyva τι βλέπει το Gemini όταν κάνει μια ερώτηση στη βάση κώδικα. Σημασιολογική, AST, γραφήματος και αναζήτηση κειμένου, επιστρεφόμενες με διαδρομές αρχείων και αριθμούς γραμμών.
Το GEMINI.md λέει στο Gemini πώς να δουλέψει.
Το Maguyva δίνει στο Gemini κάτι από το οποίο να ξεκινήσει.
Τρεις ροές εργασίας
Ειδικά για το Gemini. Τεκμηριωμένο πάνω στο πραγματικό γράφημα κλήσεων, όχι στο grep του Gemini.
// workflow 01
Μετονομάστε μια κοινόχρηστη κλάση, βρείτε πρώτα κάθε εξαρτημένο στοιχείο
gemini> μετονόμασε το PaymentClient → BillingClient graph::callers(PaymentClient) 12 αναφορές σε 7 πακέτα graph::importers(src/payments/client.ts) 9 εισαγωγείς graph::extends(PaymentClient) 2 υποκλάσεις (RetryClient, MockClient) → Το Gemini προτείνει μια μετάβαση 21 επεξεργασιών με τη λίστα αρχείων ενσωματωμένη. [exit 0]
Το Gemini ζητά από το Maguyva τα εξαρτημένα στοιχεία πριν αρχίσει να επεξεργάζεται. Η λίστα μετάβασης επιστρέφει τεκμηριωμένη στο πραγματικό γράφημα, όχι στην ανάμνηση του Gemini.
// workflow 02
Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής
gemini> πώς χειρίζεται η normalizePhoneNumber το E.164; semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← πραγματική υλοποίηση test/util/phone.spec.ts:14 jest.mock(...) ← ψευδοϋλοποίηση [exit 0]
Τα ονόματα ψεύδονται. Τα ψευδο-αντικείμενα επισκιάζουν τον πραγματικό κώδικα. Το Maguyva κατατάσσει την πραγματική υλοποίηση πάνω από την ψευδοϋλοποίηση δοκιμής.
// workflow 03
Ελέγξτε την ακτίνα επίδρασης πριν από μια αναδιαμόρφωση
gemini> τι καλεί το QueueDispatcher.publish; graph::callers(QueueDispatcher.publish) 3 σε src/billing/* 1 σε src/audit/* 1 σε src/notifications/* [exit 0]
Τα διαπακετικά σημεία κλήσης αναδεικνύονται άμεσα. Η διαφορά είναι τεκμηριωμένη πάνω σε πραγματικούς εισαγωγείς, όχι στο grep του Gemini.
Ρύθμιση στο Gemini CLI
Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.
// step 01
Ευρετηριάστε ένα αποθετήριο στο maguyva.ai
Επιλέξτε ένα που γνωρίζετε καλά, ώστε να μπορείτε να επαληθεύσετε τις απαντήσεις.
// step 02
Προσθέστε το Maguyva ως διακομιστή MCP στις ρυθμίσεις του Gemini CLI
// ~/.gemini/settings.json { "mcpServers": { "maguyva": { "httpUrl": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer <your-key>" } } } }// step 03
Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε
Μην ξεκινήσετε με ολόκληρη την εταιρεία σας. Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση.