// συμφωνία
copilot-instructions.md
Πώς πρέπει να συμπεριφέρεται το Copilot σε αυτό το αποθετήριο.
Για χρήστες του GitHub Copilot CLI
Το Copilot ξεκινά κάθε συνεδρία χωρίς καμία γνώση.
Οι προσαρμοσμένες οδηγίες λένε στο Copilot πώς να συμπεριφέρεται. Δεν του λένε τι υπάρχει στο αποθετήριό σας. Η Maguyva ευρετηριάζει τη βάση κώδικα και την επιστρέφει μέσω MCP, ώστε το GitHub Copilot CLI να επεξεργάζεται σαν να έχει ήδη διαβάσει τον κώδικα.
Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.
Χρησιμοποιήστε οδηγίες για τη συμπεριφορά. Χρησιμοποιήστε τη Maguyva για τα τρέχοντα δεδομένα της βάσης κώδικα.Η στοίβα επιπέδων
Τέσσερις ιδέες. Η καθεμία κάνει μία δουλειά.
// μεταφορά
MCP
Πώς αποκτά το Copilot πρόσβαση σε εξωτερικά εργαλεία και πλαίσιο.
// βάση κώδικα
Maguyva
Ο διακομιστής MCP που επιστρέφει τεκμηριωμένα δεδομένα αποθετηρίου.
// ποιος πληρώνει
Χώροι εργασίας, όχι χρήστες
Οι πράκτορες δεν επιβαρύνονται με χρεώσεις ανά χρήστη. Δείτε τις τιμές
Οι προσαρμοσμένες οδηγίες είναι μια συμφωνία εργασίας. Χρησιμοποιήστε τις.
# .github/copilot-instructions.md
- Προτιμήστε τα υπάρχοντα όρια μονάδων.
- Εκτελέστε την εντολή δοκιμής του αποθετηρίου πριν προτείνετε merge.
- Μην επινοείτε διαδρομές αρχείων. Ρωτήστε πριν δημιουργήσετε νέο πακέτο.Οι μόνιμες οδηγίες ανήκουν στο .github/copilot-instructions.md. Είναι το κατάλληλο μέρος για:
- Εντολές build, test και lint που πρέπει να εκτελεί το Copilot.
- Κανόνες “κάνε πάντα X / ποτέ μην κάνεις Y” περιορισμένους σε αυτό το αποθετήριο.
- Συμβάσεις ονοματοδοσίας και προτιμήσεις αξιολόγησης.
- Δείκτες προς το αρχείο αποφάσεων — όχι μια χωματερή κάθε συμβόλου.
Αυτό το αρχείο δεν ήταν ποτέ ένα ερωτήσιμο ευρετήριο του αποθετηρίου. Λέει στο Copilot πώς να δουλέψει. Δεν του λέει τι υπάρχει εκεί.
Πού οι προσαρμοσμένες οδηγίες παύουν να αντέχουν σε μεγάλη κλίμακα
Τέσσερις τρόποι αποτυχίας που το Copilot δεν μπορεί να διορθώσει από ένα αρχείο markdown.
// οι οδηγίες δεν είναι ευρετήριο
Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. Η πρώτη επεξεργασία σε ένα άγνωστο δέντρο είναι απλώς μια εικασία για τη δομή των αρχείων.
// τα έγγραφα ξεπερνιούνται, ο κώδικας όχι
Ένα μπλοκ οδηγιών που περιγράφει τη ροή ταυτοποίησης του προηγούμενου τριμήνου είναι σαφώς λανθασμένο τη μέρα που κάποιος διαχωρίζει το session store. Copilot will prefer the file you committed over the code that shipped.
// οι εξαρτήσεις δεν είναι σε markdown
“Τι εισάγει αυτό;” is a graph question. Οι οδηγίες δεν μπορούν να απαριθμήσουν κάθε καλούντα, και ούτε θα το θέλατε.
// τα παράθυρα πλαισίου έχουν προϋπολογισμό
Το να στριμώχνετε περισσότερο αποθετήριο στις οδηγίες ανταλλάσσει tokens συλλογισμού με μια ξεπερασμένη στιγμιότυπη εικόνα. Πέρα από λίγα KB, πληρώνετε για έναν χειρότερο χάρτη.
Η Maguyva ως το πρόσθετο επίπεδο
Το Copilot ήδη σκέφτεται με όρους οδηγιών και εργαλείων.
copilot-instructions.md
συμφωνία
πώς συμπεριφέρεται το Copilot
MCP
το κανάλι
πώς φτάνει
Maguyva
δεδομένα βάσης κώδικα
τι βλέπει
- Ένας ερωτήσιμος χάρτης του αποθετηρίου παρέχεται μέσω MCP ως απομακρυσμένος διακομιστής streamable-HTTP.
- 11 εργαλεία στραμμένα στον πελάτη σε σημασιολογική, δομική (AST), γράφου και κειμενική αναζήτηση, συν σύμβολα, εξαρτημένα στοιχεία και ανάκτηση αρχείων.
- Ταξινομημένα αποτελέσματα με διαδρομές αρχείων και αριθμούς γραμμών σε πάνω από 284 γλώσσες και τεχνολογίες βασισμένες σε κείμενο.
- Μία ρύθμιση Ο ίδιος χώρος εργασίας απαντά στο Copilot, το Claude Code, το Cursor, το Codex και οποιονδήποτε άλλο συμβατό με MCP client.
Οι προσαρμοσμένες οδηγίες λένε στο Copilot πώς να συμπεριφέρεται.
Το Maguyva δίνει στο Copilot έναν ερωτήσιμο χάρτη του κώδικα.
Τρεις ροές εργασίας
Ρωτήστε τον χάρτη πριν αποδεχτείτε το diff.
// workflow 01
Βρείτε την πραγματική υλοποίηση, όχι το test stub
copilot> πώς χειρίζεται η normalizePhoneNumber τη μορφή E.164; semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← πραγματική υλοπ. test/util/phone.spec.ts:14 jest.mock(...) ← stub → Το Copilot ανοίγει την υλοποίηση, όχι το mock. [exit 0]
Τα ονόματα λένε ψέματα. Τα mocks κρύβουν τον πραγματικό κώδικα. Το Maguyva κατατάσσει την πραγματική υλοποίηση πάνω από το mock δοκιμής.
// workflow 02
Ελέγξτε την ακτίνα επίδρασης πριν κάνετε refactoring
copilot> τι καλεί το QueueDispatcher.publish; graph::callers(QueueDispatcher.publish) 3 στο src/billing/* 1 στο src/audit/* 1 στο src/notifications/* → Το diff βασίζεται σε πραγματικούς importers. [exit 0]
Τα σημεία κλήσης μεταξύ πακέτων εμφανίζονται απευθείας. Το diff βασίζεται σε πραγματικούς importers, όχι στο grep του Copilot.
// workflow 03
Μετονομάστε μια κοινόχρηστη κλάση, βρείτε πρώτα κάθε εξαρτημένο στοιχείο
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 αναφορές σε 7 πακέτα graph::importers(src/payments/client.ts) 9 importers graph::extends(PaymentClient) 2 υποκλάσεις (RetryClient, MockClient) → Το Copilot προτείνει μια μετάβαση με τη λίστα αρχείων ενσωματωμένη. [exit 0]
Το Copilot ρωτά το Maguyva για τα εξαρτημένα στοιχεία πριν αρχίσει να επεξεργάζεται. Η λίστα μετάβασης επιστρέφει βασισμένη στον πραγματικό γράφο, όχι στη μνήμη του Copilot.
Ρύθμιση στο GitHub Copilot CLI
Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.
// step 01
Ευρετηριάστε ένα αποθετήριο στο maguyva.ai
Επιλέξτε ένα που ήδη γνωρίζετε, ώστε να μπορείτε να αξιολογήσετε τις απαντήσεις. Εγγραφείτε δωρεάν, συνδέστε το GitHub, περιμένετε την ευρετηρίαση.
// step 02
Προσθέστε το Maguyva ως απομακρυσμένο διακομιστή MCP στο 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
Κάντε μία ερώτηση της οποίας γνωρίζετε ήδη την απάντηση
Μην ξεκινήσετε με ολόκληρη την εταιρεία. Κάντε μία ερώτηση της οποίας γνωρίζετε ήδη την απάντηση και έπειτα ανοίξτε το αρχείο που αναφέρεται.