// συμφωνία
AGENTS.md
Πώς πρέπει να συμπεριφέρεται το Codex σε αυτό το αποθετήριο.
Για χρήστες Codex CLI
Το AGENTS.md λέει στο Codex πώς να δουλέψει.
Όχι τι υπάρχει εκεί.
Το AGENTS.md ορίζει τη συμφωνία εργασίας. Το MCP επιτρέπει στο Codex να απλώνεται σε εργαλεία. Το Maguyva είναι ο διακομιστής MCP που δίνει στο Codex έναν χάρτη του αποθετηρίου σας με δυνατότητα ερωτημάτων, ώστε η πρώτη επεξεργασία να μην είναι μαντεψιά για τη δομή των αρχείων.
Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.
Το AGENTS.md είναι η συμφωνία. Το MCP είναι το κανάλι. Το Maguyva είναι ο χάρτης.Η στοίβα επιπέδων
Τέσσερις ιδέες. Η καθεμία κάνει μία δουλειά.
// μεταφορά
MCP
Πώς απλώνεται το Codex σε εξωτερικά εργαλεία και πλαίσιο.
// κώδικας βάσης
Maguyva
Ο διακομιστής MCP που επιστρέφει τεκμηριωμένα δεδομένα αποθετηρίου.
// ποιος πληρώνει
Χώροι εργασίας, όχι θέσεις
Οι πράκτορες δεν πληρώνουν θέσεις. Δείτε τις τιμές
Το AGENTS.md είναι μια συμφωνία εργασίας. Χρησιμοποιήστε το.
Οι μόνιμες οδηγίες ανήκουν στο AGENTS.md. Είναι το σωστό μέρος για:
- Εντολές κατασκευής, δοκιμών και λίντινγκ που πρέπει να τρέχει το Codex.
- Κανόνες “πάντα κάνε X / ποτέ μην κάνεις Y” με εμβέλεια έναν φάκελο.
- Συμβάσεις ονοματοδοσίας και προτιμήσεις αναδιαμόρφωσης.
- Παραπομπές στα κανονικά αρχεία αποφάσεων και τις σημειώσεις αρχιτεκτονικής.
Κρατήστε το συνοπτικό. Δώστε του εμβέλεια. Κάντε υποβολή του.
Όμως το AGENTS.md δεν σχεδιάστηκε ποτέ για να είναι ένα ευρετήριο με δυνατότητα ερωτημάτων για κάθε σύμβολο, αρχείο και σημείο κλήσης στο αποθετήριό σας.
Πού το AGENTS.md από μόνο του γίνεται στατικό σε μεγάλη κλίμακα
Τέσσερις τρόποι αστοχίας, ένας ανά κάρτα.
// οι συμφωνίες δεν είναι ευρετήριο
Το να λέτε στο Codex πώς να δουλέψει δεν του λέει τι υπάρχει. Η πρώτη επεξεργασία σε ένα άγνωστο πακέτο είναι μαντεψιά για διαδρομές αρχείων και ονόματα συναρτήσεων. Το AGENTS.md δεν μπορεί να απαριθμήσει κάθε σύμβολο, και δεν θα το θέλατε ούτως ή άλλως.
// το έγγραφο ξεπερνιέται από τον κώδικα
Ένα τμήμα του AGENTS.md που περιγράφει την τοπολογία της ουράς σας είναι σωστό μέχρι κάποιος να προσθέσει έναν νέο καταναλωτή. Ο κώδικας είναι πλέον η πηγή αλήθειας και το έγγραφο είναι με σιγουριά ξεπερασμένο. Το Codex διαβάζει το λάθος.
// η μετονομασία είναι πρόβλημα γραφήματος
Το «Ποιος αναφέρεται σε αυτή την κλάση;» δεν απαντιέται από ένα αρχείο markdown. Το Codex είτε κάνει grep-και-εύχεται σε όλο το ενιαίο αποθετήριο, είτε σας ζητά να επικολλήσετε σημεία κλήσης στη συνομιλία.
// τα παράθυρα πλαισίου δεν είναι δωρεάν
Το να παραγεμίζετε το AGENTS.md μέχρι το Codex να «ξέρει αρκετά» καταναλώνει διακριτικά που θα έπρεπε να πληρώνουν τη συλλογιστική. Πέρα από λίγα KB, ανταλλάσσετε ποιότητα απάντησης με στατικό όγκο πλαισίου.
Πώς ταιριάζουν τα τρία επίπεδα μεταξύ τους
Οι χρήστες του Codex ήδη σκέφτονται με αυτό το σχήμα. Η σελίδα πρέπει να το κάνει προφανές.
AGENTS.md
συμφωνίες
πώς συμπεριφέρεται το Codex
MCP
το κανάλι
πώς απλώνεται
Maguyva
δεδομένα βάσης κώδικα
τι βλέπει
- AGENTS.md πώς συμπεριφέρεται το Codex σε αυτό το αποθετήριο.
- MCP πώς απλώνεται το Codex σε εργαλεία και πλαίσιο. (προδιαγραφή)
- Maguyva τι βλέπει το Codex όταν κάνει μια ερώτηση στη βάση κώδικα. Σημασιολογική, AST, γραφήματος και αναζήτηση κειμένου, επιστρεφόμενες με διαδρομές αρχείων και αριθμούς γραμμών.
Το AGENTS.md λέει στο Codex πώς να δουλέψει.
Το Maguyva δίνει στο Codex κάτι από το οποίο να ξεκινήσει.
Τρεις ροές εργασίας
Ειδικά για το Codex. Τεκμηριωμένο πάνω στο πραγματικό γράφημα κλήσεων, όχι στο grep του Codex.
// workflow 01
Μετονομάστε μια κοινόχρηστη κλάση, βρείτε πρώτα κάθε εξαρτημένο στοιχείο
codex> μετονόμασε το PaymentClient → BillingClient graph::callers(PaymentClient) 12 αναφορές σε 7 πακέτα graph::importers(src/payments/client.ts) 9 εισαγωγείς graph::extends(PaymentClient) 2 υποκλάσεις (RetryClient, MockClient) → Το Codex προτείνει μια μετάβαση 21 επεξεργασιών με τη λίστα αρχείων ενσωματωμένη. [exit 0]
Το Codex ζητά από το Maguyva τα εξαρτημένα στοιχεία πριν αρχίσει να επεξεργάζεται. Η λίστα μετάβασης επιστρέφει τεκμηριωμένη στο πραγματικό γράφημα, όχι στην ανάμνηση του Codex.
// workflow 02
Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής
codex> πώς χειρίζεται η 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
Ελέγξτε την ακτίνα επίδρασης πριν από μια αναδιαμόρφωση
codex> τι καλεί το QueueDispatcher.publish; graph::callers(QueueDispatcher.publish) 3 σε src/billing/* 1 σε src/audit/* 1 σε src/notifications/* [exit 0]
Τα διαπακετικά σημεία κλήσης αναδεικνύονται άμεσα. Η διαφορά είναι τεκμηριωμένη πάνω σε πραγματικούς εισαγωγείς, όχι στο grep του Codex.
Ρύθμιση στο Codex CLI
Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.
// step 01
Ευρετηριάστε ένα αποθετήριο στο maguyva.ai
Επιλέξτε ένα που γνωρίζετε καλά, ώστε να μπορείτε να επαληθεύσετε τις απαντήσεις.
// step 02
Προσθέστε το Maguyva ως διακομιστή MCP στις ρυθμίσεις του Codex
$ export MAGUYVA_API_KEY=mgv_xxxx $ codex mcp add maguyva --url https://maguyva.tools/mcp \ --bearer-token-env-var MAGUYVA_API_KEY # equivalent ~/.codex/config.toml [mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY"// step 03
Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε
Μην ξεκινήσετε με ολόκληρη την εταιρεία σας. Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση.