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

Πρώτα ο χάρτης, μετά η αξιολόγηση

[Ecosystem] [Workflow] [Code Review]

> Θεμελιώστε τον πράκτορα προγραμματισμού σε έναν χάρτη του αποθετηρίου πριν γράψει. Αφήστε το Greptile να αξιολογήσει το αίτημα συγχώνευσης μετά. Ένα συμπληρωματικό δίδυμο, όχι αντικατάσταση.

Δύο διαφορετικές δουλειές κάθονται στις δύο πλευρές ενός αιτήματος συγχώνευσης. Πριν γράψει ο πράκτορας, χρειάζεται έναν χάρτη του δέντρου που πρόκειται να αλλάξει. Αφού ο πράκτορας ανοίξει ένα PR, κάτι θα πρέπει να διαβάσει αυτή την αλλαγή σε σχέση με το υπόλοιπο σύστημα και να αφήσει σχόλια που μπορεί να αξιοποιήσει ένας άνθρωπος.

Αυτές οι δουλειές μοιάζουν από μακριά επειδή και οι δύο περιλαμβάνουν «κατανόηση της βάσης κώδικα». Δεν είναι το ίδιο προϊόν. Η μία απαντά στο «πού θα έπρεπε να προσγειωθεί αυτή η αλλαγή;». Η άλλη απαντά στο «τι έσπασε αυτό το diff που ένα εργαλείο στατικού ελέγχου γραμμή προς γραμμή θα χάσει;». Το να τις μπερδέψετε παράγει ένα χειρότερο πρώτο προσχέδιο και μια πιο θορυβώδη αξιολόγηση.

Αυτό το κείμενο είναι ένας οδηγός κοινής ροής εργασίας. Το Maguyva είναι ο χάρτης που ρωτάει πρώτος ο πράκτορας. Το Greptile είναι ο πράκτορας αξιολόγησης που σχολιάζει το PR μετά. Το δίδυμο είναι συμπληρωματικό εκ κατασκευής: το Maguyva δεν αξιολογεί αιτήματα συγχώνευσης, και το Greptile δεν αντικαθιστά το επίπεδο context που χρησιμοποίησε ο πράκτορας για να τα γράψει.

Γιατί αυτός ο διαχωρισμός είναι χρήσιμος

Ένας πράκτορας προγραμματισμού που ξεκινά από όσα έμαθε στην εκπαίδευσή του συν μερικά επικολλημένα αρχεία θα επινοήσει μια εύλογη διαδρομή αρχείου και θα την επεξεργαστεί. Αυτή είναι η αποτυχία «λάθος αρχείου», και είναι πρόβλημα ανάκτησης. Το Maguyva είναι ένα απομακρυσμένο επίπεδο MCP για το context της βάσης κώδικα: σημασιολογική, δομική (AST), γράφου/εξαρτήσεων και κειμενική ανάκτηση συγχωνεύονται σε ταξινομημένα αποτελέσματα, συν αναζήτηση συμβόλων και ανάκτηση αρχείων. Τεκμηριωμένες απαντήσεις επιστρέφουν ως path/file.ext:line, ώστε να μπορείτε να απορρίψετε ένα λάθος πριν υπάρξει patch. Ο ισχυρισμός παραμένει μετριοπαθής: λιγότερες παραισθητικές επεξεργασίες. Το μοντέλο μπορεί ακόμα να μαντέψει. Απλώς το πρώτο βήμα σταματά να είναι μαντεψιά.

Το Greptile είναι ένας πράκτορας αξιολόγησης κώδικα με AI. Με δικά τους λόγια, αξιολογεί αυτόματα κάθε αίτημα συγχώνευσης με πλήρη κατανόηση της βάσης κώδικα, και το τοποθετεί απέναντι σε παραδοσιακά εργαλεία στατικού ελέγχου που ελέγχουν αρχεία απομονωμένα αντί για ολόκληρο το σύστημα. Η ρύθμιση συνίσταται στην εγκατάσταση της εφαρμογής GitHub ή GitLab και στην επιλογή αποθετηρίων. Δεν υπάρχει τοπικό ευρετήριο που πρέπει να λειτουργείτε. Η φιλοξενία είναι στο Greptile Cloud (δηλώνουν συμμόρφωση SOC 2 Type II, με αναφορά διαθέσιμη κατόπιν αιτήματος), με επιλογή αυτοφιλοξενίας που προσφέρεται σε επιχειρήσεις.

Η δική τους αριθμημένη ροή είναι: σύνδεση και δημιουργία ενός γράφου εξαρτήσεων κάθε συνάρτησης, κλάσης και εξάρτησης· σε κάθε αίτημα συγχώνευσης, ανάλυση της αλλαγής χρησιμοποιώντας αυτόν τον πλήρη γράφο του αποθετηρίου και δημοσίευση ευρημάτων ως σχόλια PR με προτεινόμενες διορθώσεις, σε περίπου τρία λεπτά· κάθε σχόλιο μπορεί να παραδώσει το πρόβλημα σε έναν πράκτορα προγραμματισμού που η ομάδα ήδη χρησιμοποιεί. Δηλώνουν επίσης ότι διαβάζουν προηγούμενα ανθρώπινα σχόλια PR με την πάροδο του χρόνου, για να μάθουν τα πρότυπα κώδικα μιας ομάδας και να μειώσουν θορυβώδεις προτάσεις. Το σύστημα εκμάθησής τους, όπως δηλώνουν, χρειάζεται 2–3 εβδομάδες για να προσαρμοστεί.

Αυτό είναι αξιολόγηση, όχι σύνταξη. Το δυνατό σημείο του Greptile είναι το context πλήρους γράφου του αποθετηρίου πάνω στην αλλαγή που έχει ήδη προσγειωθεί σε ένα PR, και έπειτα ένας κλειστός βρόχος που στέλνει το εύρημα στα Claude Code, Codex, Conductor, Cursor ή Devin. Το δυνατό σημείο του Maguyva είναι ο ταξινομημένος χάρτης που ρώτησε ο πράκτορας πριν γραφτεί αυτή η αλλαγή. Χρησιμοποιήστε και τα δύο. Μη ζητάτε από κανένα να κάνει τη δουλειά του άλλου.

Μια επίσημη ενσωμάτωση προϊόντων Maguyva–Greptile πρώτου μέρους δεν δηλώνεται. Ούτε τη χρειάζεστε. Το Maguyva μιλάει με τον πράκτορα μέσω MCP. Το Greptile μιλάει με το GitHub ή το GitLab μέσω της εφαρμογής τους. Συναντιούνται στο αίτημα συγχώνευσης. Κανένα συνδετικό σενάριο, κανένα cron που συνδέει το ένα εργαλείο με το άλλο. Το δίδυμο δεν χρειάζεται bash επειδή κάθε προϊόν κάθεται ήδη στην επιφάνεια που του ανήκει.

Τι δεν είναι αυτό

Αυτό δεν είναι μια κατεδάφιση του Greptile. Δεν είναι μια σελίδα «αλλάξτε τον αξιολογητή σας». Το Greptile λανσαρίστηκε στο Hacker News στις 5 Μαρτίου 2024 ως εταιρεία Y Combinator W24, και εκείνο το νήμα συζήτησης είναι ο τρόπος που πολλοί άνθρωποι γνώρισαν πρώτη φορά το προϊόν. Αν έτσι τους βρήκατε, κρατήστε τους. Αυτή η σελίδα είναι το μισό που λείπει μπροστά από εκείνον τον βρόχο: να θεμελιώσετε τον πράκτορα εκ των προτέρων ώστε το PR που βλέπει το Greptile να στοχεύει ήδη τα σωστά αρχεία.

Το διαφημιστικό υλικό του Greptile προηγείται με ισχυρισμούς για ταχύτητα αξιολόγησης και εντοπισμό σφαλμάτων. Αντιμετωπίστε τους ως δικούς τους ισχυρισμούς του Greptile, όχι ως ανεξάρτητα επαληθευμένους αριθμούς. Αυτό το κείμενο δεν τους επαναλαμβάνει ως γεγονότα.

Η κάλυψη γλωσσών είναι το ίδιο είδος ειλικρίνειας. Το Greptile πλαισιώνει την υποστήριξη ως κάλυψη όλων των γλωσσών προγραμματισμού αντί για μια απαριθμημένη λίστα· ένας ακριβής αριθμός δεν δηλώνεται. Το Maguyva δημοσιεύει υποστήριξη για περισσότερες από 279 γλώσσες και τεχνολογίες βασισμένες σε κείμενο, με έναν τεχνικό διαχωρισμό (AST μέσω συντακτικού αναλυτή έναντι μόνο κειμένου) στον ιστότοπο όταν το ερώτημα είναι τεχνικό. Είναι διαφορετικά προϊόντα που κάνουν διαφορετικούς ισχυρισμούς. Μην τα ανακατεύετε.

Η τιμολόγηση του Greptile δεν δηλώνεται στο υλικό που μπορεί να χρησιμοποιήσει αυτό το κείμενο. Επί πληρωμή πλάνα υπάρχουν· δείτε τη σελίδα τιμών τους. Το Maguyva χρεώνει ανά χώρο εργασίας, όχι ανά θέση. Τα πλάνα ξεκινούν δωρεάν. Η σελίδα τιμών απαριθμεί τα δημοσιευμένα επίπεδα αν χρειάζεστε τους αριθμούς χώρου εργασίας.

Ροή εργασίας

Τρία επώνυμα στάδια. Εκτελέστε τα με αυτή τη σειρά. Μην παραλείψετε κανένα την πρώτη φορά που δοκιμάζετε αυτό το δίδυμο.

1. Context Maguyva

Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε. Συνδέστε το πρόγραμμα-πελάτη MCP στο οποίο ήδη γράφετε — Claude Code, Cursor, Codex CLI, VS Code, Windsurf, ή ένα άλλο συμβατό με MCP πρόγραμμα-πελάτη. Το Maguyva έχει οδηγούς ρύθμισης για 24 τεκμηριωμένα προγράμματα-πελάτες MCP και μπορεί να συνδεθεί με άλλα προγράμματα-πελάτες που υποστηρίζουν τυπική ρύθμιση MCP.

Κάντε μια ερώτηση που μπορείτε να αξιολογήσετε πριν γράψει κανείς μια γραμμή. «Πού διαχειρίζεται η λήξη συνεδρίας, και τι το καλεί;» είναι μια καλύτερη πρώτη κίνηση από «διόρθωσε το auth». Απαιτήστε παραπομπές. Ανοίξτε τα αποτελέσματα file.ext:line. Ακολουθήστε το σύμβολο. Επιβεβαιώστε την εξάρτηση που πρόκειται να αγγίξετε.

Το Maguyva εκθέτει 11 εργαλεία MCP για το πρόγραμμα-πελάτη, που καλύπτουν αναζήτηση, σύμβολα, ανάλυση εξαρτήσεων, ανάκτηση αρχείων, context αποθετηρίου και ντετερμινιστικές ροές εργασίας βοηθητικών εργαλείων. Τέσσερις τρόποι ανάκτησης συγχωνεύονται σε ταξινομημένα αποτελέσματα· το find_symbol είναι ξεχωριστό εργαλείο όταν ήδη γνωρίζετε το όνομα. Η τεκμηρίωση περιγράφει τη συντομότερη διαδρομή: ξεκινήστε δωρεάν, ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε, συνδέστε το πρόγραμμα-πελάτη, μετά κάντε μία ερώτηση που μπορείτε να επαληθεύσετε.

Τα στιγμιότυπα φέρουν χρονοσφραγίδα, ώστε ο πράκτορας να μπορεί να πει ποια έκδοση του δέντρου διαβάζει. Ο ειλικρινής περιορισμός είναι η μη συγχρονισμένη τοπική εργασία. Αν η επεξεργασία υπάρχει μόνο σε ένα τοπικό δέντρο εργασίας και δεν έχει σταλεί στο απομακρυσμένο αποθετήριο, ο φιλοξενούμενος χάρτης δεν την περιέχει ακόμα. Τα αρχεία οδηγιών (CLAUDE.md, AGENTS.md) εξακολουθούν να έχουν τη θέση τους εδώ, για συμβάσεις και για ό,τι δεν πρέπει να αγγίζεται. Δεν είναι ζωντανός χάρτης. Χρησιμοποιήστε τα για συμπεριφορά. Χρησιμοποιήστε το Maguyva για γεγονότα.

Μην αφήνετε τον πράκτορα να ανοίξει PR πριν οι παραπομπές επιβιώσουν την επαφή με το αποθετήριο. Αυτή η πύλη είναι όλο το νόημα αυτού του σταδίου.

2. PR του πράκτορα

Ο ίδιος πράκτορας τώρα γράφει την αλλαγή στο πρόγραμμα-πελάτη για το οποίο ήδη πληρώνετε. Το Maguyva δεν είναι επεξεργαστής κώδικα ούτε αξιολογητής. Ο πράκτορας εξακολουθεί να παράγει το diff. Εσείς εξακολουθείτε να ανοίγετε το αίτημα συγχώνευσης στο GitHub ή στο GitLab με τον τρόπο που ήδη κάνετε.

Αυτό που θα έπρεπε να είναι διαφορετικό είναι το πρώτο αρχείο. Το PR θα πρέπει να ονομάζει τον χειριστή που πράγματι υλοποιεί τη συμπεριφορά, τον καλούντα που θα σπάσει, και τη δοκιμή που θα αποτύχει αν η αλλαγή είναι λάθος. Αν το στάδιο 1 παραλείφθηκε, το στάδιο 3 θα ξοδέψει τα σχόλιά του σε μια αλλαγή που προσγειώθηκε στο λάθος πακέτο. Το Greptile μπορεί ακόμα να βρει συστημικά προβλήματα. Δεν θα έπρεπε επιπλέον να χρειάζεται να ανακάμψει από μια παραισθητική διαδρομή αρχείου.

Κρατήστε το PR περιορισμένο. Ένα τεκμηριωμένο πρώτο αρχείο δεν είναι άδεια να ξαναγράψετε την ενότητα κώδικα. Αυτό το συμπληρωματικό δίδυμο λειτουργεί όταν ο πράκτορας έκανε μια δουλειά με έναν χάρτη, και μετά ζήτησε από έναν αξιολογητή να κάνει μια άλλη δουλειά σε ένα οριοθετημένο diff.

3. Αξιολόγηση Greptile

Το Greptile είναι ήδη συνδεδεμένο με το αποθετήριο μέσω της εφαρμογής GitHub ή GitLab. Στο νέο αίτημα συγχώνευσης αναλύει την αλλαγή χρησιμοποιώντας τον πλήρη γράφο του αποθετηρίου που έχτισε, και δημοσιεύει ευρήματα ως σχόλια με προτεινόμενες διορθώσεις. Το δικό τους υλικό τοποθετεί αυτό το πέρασμα στα περίπου τρία λεπτά.

Διαβάστε τα σχόλια όπως θα διαβάζατε έναν προσεκτικό συνάδελφο ομάδας: ανοίξτε την παραπεμπόμενη τοποθεσία, αποφασίστε αν το εύρημα είναι πραγματικό, μετά ενεργήστε. Εκεί όπου το Greptile προσφέρει «Fix with your Agent», στέλνει το πρόβλημα — διαδρομές αρχείων, αριθμούς γραμμής, προτεινόμενο κώδικα — στα Claude Code, Codex, Conductor, Cursor ή Devin. Το «Fix All» στέλνει όλα τα προβλήματα της αξιολόγησης ταυτόχρονα. Παρέχουν επίσης ένα Greptile MCP και ένα πρόσθετο για το Claude Code για αυτή την παράδοση. Το Maguyva δεν βρίσκεται σε αυτή την επώνυμη λίστα στόχων· αυτή η απουσία δεν είναι πρόβλημα. Το Maguyva έχει ήδη κάνει τη δουλειά του στο στάδιο 1. Ο πράκτορας προγραμματισμού που έγραψε το PR είναι αυτός που θα έπρεπε να λάβει τα δεδομένα της διόρθωσης.

Περιμένετε θόρυβο τις πρώτες 2–3 εβδομάδες όσο το σύστημα εκμάθησης του Greptile προσαρμόζεται στα σχόλια που πραγματικά αφήνει η ομάδα σας. Αυτό είναι το δηλωμένο χρονοδιάγραμμά τους, όχι ελάττωμα του διδύμου. Η ανθρώπινη αξιολόγηση παραμένει στον βρόχο. Το Greptile είναι το αυτοματοποιημένο πρώτο πέρασμα, όχι το κουμπί της συγχώνευσης.

Αν ένα σχόλιο του Greptile δείχνει σε ένα αρχείο που ο πράκτορας δεν ρώτησε ποτέ στο στάδιο 1, αυτό είναι χρήσιμο σήμα. Είτε ο χάρτης έχασε έναν καλούντα, είτε ο πράκτορας παρέλειψε μια παραπομπή. Διορθώστε το προσχέδιο σύμφωνα με το σχόλιο. Μην απενεργοποιείτε τον αξιολογητή.

Πώς να κρατήσετε αυτή τη συμπληρωματικότητα ειλικρινή

  • Το Maguyva πάντα πρώτο. Μια αξιολόγηση ενός PR με λάθος αρχείο παραμένει αξιολόγηση του λάθος αρχείου.
  • Το Greptile πάντα μετά. Ένα καλά παραπεμπόμενο προσχέδιο χρειάζεται ακόμα μια ανάγνωση του diff σε επίπεδο ολόκληρου συστήματος.
  • Μη ζητάτε από το Maguyva να δημοσιεύει σχόλια PR. Δεν το κάνει.
  • Μη ζητάτε από το Greptile να είναι το πρώτο επίπεδο ανάκτησης του πράκτορα ενώ ακόμα επιλέγει διαδρομή αρχείου. Αυτή δεν είναι η δουλειά για την οποία είναι καλωδιωμένη η εφαρμογή τους GitHub ή GitLab.
  • Μην επινοείτε μια αλυσίδα σεναρίων bash που τα «συγχρονίζει». Το PR είναι η διεπαφή.
  • Επαληθεύστε και τις δύο πλευρές ανεξάρτητα. Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε. Κάντε μία ερώτηση που μπορείτε να επαληθεύσετε. Έπειτα ανοίξτε ένα μικρό PR και διαβάστε τι πραγματικά σχολιάζει το Greptile.

Ο βρόχος είναι συνηθισμένος μόλις του δώσετε όνομα. Πρώτα ο χάρτης. Μετά το PR του πράκτορα. Μετά η αξιολόγηση. Κάθε προϊόν μένει στην πλευρά του αιτήματος συγχώνευσης στην οποία είναι καλό.

// map first. review second. in that order.

Σχετική ανάγνωση

Περισσότερα από το ημερολόγιο κατασκευής του Maguyva

Δώστε σε πράκτορα AI το πλαίσιο μεγάλου αποθετηρίου χωρίς τοπικό ευρετήριο_

Πώς να δώσετε σε έναν πράκτορα προγραμματισμού έναν αναζητήσιμο χάρτη ενός μεγάλου αποθετηρίου από το νέφος, χωρίς να τρέχετε τοπικό μηχανισμό ευρετηρίασης στον φορητό υπολογιστή σας.

[AI Agents] [MCP] [Indexing] [Monorepos]

Πολυτροπική Συγχωνευμένη Αναζήτηση: Επιλέγοντας τον Σωστό Ανακτητή για Κάθε Ερώτημα_

Ένα ερώτημα όπως «πού ορίζεται το parseConfig» θέλει διαφορετική αναζήτηση από το «πώς λειτουργεί η ταυτοποίηση». Το Maguyva ταξινομεί την πρόθεση, σταθμίζει ανάλογα τέσσερις τρόπους ανάκτησης και συγχωνεύει τα αποτελέσματα με σταθμισμένη Reciprocal Rank Fusion.

[Αναζήτηση] [Αρχιτεκτονική]