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

Για χρήστες Antigravity

Το Antigravity τρέχει τους πράκτορες.
Το Maguyva τους δίνει τον χάρτη.

Το Antigravity είναι ένα IDE με προτεραιότητα στους πράκτορες: οι πράκτορες σχεδιάζουν και επεξεργάζονται σε επεξεργαστή, τερματικό και περιηγητή. Σε ένα πραγματικό ενιαίο αποθετήριο εξακολουθούν να χρειάζονται έναν χάρτη για το ποιο αρχείο έχει σημασία. Το Maguyva ευρετηριάζει τη βάση κώδικά σας και την προσφέρει πίσω μέσω MCP (σημασιολογική, AST, γραφήματος και κειμένου), ώστε το «πού συμβαίνει η αυθεντικοποίηση» να επιστρέφει την πραγματική ροή αυθεντικοποίησης, όχι επτά ψευδοϋλοποιήσεις δοκιμών.

Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.

Το Antigravity τρέχει τον πράκτορα. Το Maguyva του λέει ποιο αρχείο να αγγίξει.

Τι κάνει κάθε επίπεδο

Τέσσερα κομμάτια. Το καθένα έχει τη δουλειά του.

// ide πρακτόρων

Antigravity

Εκεί όπου οι πράκτορές σας σχεδιάζουν, επεξεργάζονται και επαληθεύουν.

// χειροκίνητο πλαίσιο

Αναφορές @ + κανόνες

Το χειροκίνητο πλαίσιο κερδίζει, μέχρι να μεγαλώσει το αποθετήριο.

// κώδικας βάσης

Maguyva

Αυτόματα δεδομένα βάσης κώδικα μέσω MCP.

// ποιος πληρώνει

Χώροι εργασίας, όχι θέσεις

Οι πράκτορες δεν πληρώνουν θέσεις. Δείτε τις τιμές

Το Antigravity τρέχει τους πράκτορες. Αφήστε το.

Το IDE πρακτόρων δεν είναι το πρόβλημα. Ο Agent Manager, η εκτέλεση πολλαπλών επιφανειών και τα αρχεία κανόνων είναι εξαιρετικά, και ήδη τα χρησιμοποιείτε για:

  • Σχεδιασμό και εκτέλεση πρακτόρων σε επεξεργαστή, τερματικό και περιηγητή.
  • Επεξεργασίες πολλαπλών αρχείων όταν η αλλαγή είναι τοπική.
  • Κανόνες πρακτόρων για συμβάσεις αποθετηρίου και κανόνες στιλ.
  • Αναφορές @ για να φέρετε ένα συγκεκριμένο αρχείο στο πλαίσιο.

Συνεχίστε έτσι. Τίποτα από αυτά δεν χάνεται.

Όμως σε ένα πραγματικό ενιαίο αποθετήριο (TypeScript με εξαρτήσεις χώρου εργασίας, υπηρεσίες Python, μεικτά πακέτα) το πλαίσιο του πράκτορα σπάει τη στιγμή που το σχετικό αρχείο δεν είναι ήδη στο ραντάρ του πράκτορα.

Χειροκίνητες διορθώσεις που έχετε ήδη δοκιμάσει, και πού αστοχούν

Τέσσερις χειροκίνητες διορθώσεις σε ζευγάρι με τον τρόπο αστοχίας τους. Αριστερά = τι κάνετε σήμερα. Δεξιά = πού αστοχεί.

// the fix

// αναφέρετε τα αρχεία

Κάνετε @-αναφορά στα τρία αρχεία που πιστεύετε ότι έχουν σημασία. Ο πράκτορας επεξεργάζεται καθαρά μέσα σε αυτά.

// where it breaks

// η αναφορά είναι μαντεψιά

Λειτουργεί όταν ήδη γνωρίζετε ποια αρχεία εμπλέκονται. Ένας αυτόνομος πράκτορας χρειάζεται τα αρχεία που δεν ξέρατε να αναφέρετε.

// the fix

// επικολλήστε τα αποσπάσματα

Επικολλάτε 200 γραμμές από άλλο πακέτο μέσα στον πράκτορα για να του δώσετε αρκετό πλαίσιο.

// where it breaks

// ο επικολλημένος κώδικας μπαγιατεύει

Το απόσπασμα που επικολλήσατε στις 9 π.μ. δεν αντικατοπτρίζει το rebase που έκανε ο συνάδελφός σας στις 11 π.μ. Ο πράκτορας επεξεργάζεται πάνω σε μια φαντασματική έκδοση του πακέτου.

// the fix

// γράψτε ένα έγγραφο πλαισίου

Γράφετε ένα αρχείο κανόνων πράκτορα ή ένα markdown αρχιτεκτονικής. Είναι σωστό σήμερα.

// where it breaks

// τα έγγραφα ξεπερνιούνται πιο γρήγορα από τον κώδικα

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

// the fix

// κρατήστε τα αρχεία κανόνων

Προσθέτετε κανόνες πράκτορα για ονοματοδοσία, lint, και εντολές κατασκευής. Εξαιρετικό για τη συμπεριφορά.

// where it breaks

// οι κανόνες ≠ ευρετήριο

Οι κανόνες είναι το σωστό μέρος για το “πάντα τρέχετε pnpm tsc -b πριν τις υποβολές.” Δεν είναι ένα ευρετήριο με δυνατότητα ερωτημάτων για κάθε σύμβολο, αρχείο και σημείο κλήσης στο ενιαίο αποθετήριό σας.

Το Maguyva είναι το επίπεδο από κάτω

Δεν είναι υποκατάστατο του Antigravity. Το επίπεδο πλαισίου αποθετηρίου που στηρίζεται στην υποστήριξη MCP του Antigravity.

  • Σημασιολογική + AST + γράφημα + κείμενο αναζήτηση με βάση το νόημα, τη δομή, την εξάρτηση ή το ακριβές κείμενο. Κάθε αποτέλεσμα επιστρέφει μια διαδρομή αρχείου και έναν αριθμό γραμμής.
  • Διαπακετικά εξ ορισμού σημεία κλήσης και εισαγωγείς σε κάθε πακέτο του ενιαίου αποθετηρίου, όχι μόνο σε αυτό που έχει ανοιχτό ο πράκτορας.
  • Με επίγνωση κλάδου Το Maguyva βλέπει την έκδοση του κώδικα που επεξεργάζεται ο πράκτορας.
  • Φτιαγμένο για αυτονομία ένας πράκτορας που σχεδιάζει πολλές επεξεργασίες χρειάζεται την ακτίνα επίδρασης εκ των προτέρων, όχι αφού το CI γίνει κόκκινο.

Το Antigravity αποφασίζει τι θα επεξεργαστεί.

Το Maguyva λέει στον πράκτορα τι αγγίζει η επεξεργασία.

Τρεις ροές εργασίας σε ενιαίο αποθετήριο

Διαπακετικά, διαγλωσσικά. Τεκμηριωμένο πάνω στο πραγματικό γράφημα κλήσεων, όχι στο grep του πράκτορα.

// workflow 01

Βρείτε τη ροή αυθεντικοποίησης σε όλα τα πακέτα, χωρίς να αναφέρετε τίποτα

agent> πού συμβαίνει η αυθεντικοποίηση σε αυτό το ενιαίο αποθετήριο;

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           επαλήθευση διακριτικού
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  πύλη rbac

 4 σημεία εισόδου σε 4 πακέτα, κατατεταγμένα κατά πυκνότητα σημείων κλήσης.
[exit 0]

Δεν αναφέρατε κανένα αρχείο. Δεν επικολλήσατε κανένα απόσπασμα. Ο πράκτορας έχει τα τέσσερα αρχεία που έχουν σημασία, στη σωστή κατάταξη, και μπορεί να κάνει μια τεκμηριωμένη επεξεργασία.

// workflow 02

Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής

agent> πώς χειρίζεται η normalizePhoneNumber το E.164;

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← πραγματική υλοποίηση
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← ψευδοϋλοποίηση
[exit 0]

Τα ονόματα ψεύδονται. Τα ψευδο-αντικείμενα επισκιάζουν τον πραγματικό κώδικα. Το Maguyva κατατάσσει την πραγματική υλοποίηση πάνω από την ψευδοϋλοποίηση δοκιμής, σε κάθε πακέτο.

// workflow 03

Ελέγξτε την ακτίνα επίδρασης πριν ο πράκτορας κάνει αναδιαμόρφωση

agent> τι καλεί το QueueDispatcher.publish σε ολόκληρο το ενιαίο αποθετήριο;

graph::callers(QueueDispatcher.publish)
  3 σε packages/billing/*
  1 σε packages/audit/*
  1 σε packages/notifications/*
  1 σε services/python-worker/*  ← διαγλωσσικά μέσω ψευδοϋλοποίησης gRPC
[exit 0]

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

Ρύθμιση με το Antigravity

Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς κάρτα.

  1. // step 01

    Ευρετηριάστε ένα αποθετήριο στο maguyva.ai

    Επιλέξτε το ενιαίο αποθετήριο όπου έχετε νιώσει τον μεγαλύτερο πόνο πλαισίου.

  2. // step 02

    Προσθέστε το Maguyva ως διακομιστή MCP στο Antigravity

    // ~/.gemini/antigravity/mcp_config.json
    {
      "mcpServers": {
        "maguyva": {
          "serverUrl": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer <your-key>"
          }
        }
      }
    }
  3. // step 03

    Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε

    Μην κατευθύνετε τον πράκτορα σε ολόκληρη την εταιρεία σας. Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση, όπως «τι καλεί το formatInvoice σε όλα τα πακέτα;»