Χρήση λειτουργίας σχεδίου

Αυτός ο οδηγός δείχνει πώς να πάρετε ένα δομημένο σχέδιο από έναν πράκτορα προτού γράψει κώδικα.

Στη λειτουργία σχεδίου ο πράκτορας ερευνά μόνο για ανάγνωση και το μοναδικό παραδοτέο του είναι ένα τυποποιημένο σχέδιο: ένα γράφημα εξαρτήσεων με βήματα που εγκρίνετε και το οποίο το Control Center μεταγλωττίζει μετά σε πραγματική εργασία. Χρησιμοποιήστε τη όταν θέλετε να δείτε το εύρος μιας αλλαγής, να πάρετε τα βήματα αναλυμένα ή να κατονομαστούν οι κίνδυνοι και οι εξαρτήσεις προτού αγγιχτεί οτιδήποτε.

Μετάβαση χώρου σε λειτουργία σχεδίου

Οποιοδήποτε από τα παρακάτω αλλάζει τη λειτουργία του χώρου και η αλλαγή αποθηκεύεται:

Επιλέξτε Σχέδιο από το αναπτυσσόμενο μενού λειτουργίας στο άκρο αριστερά της γραμμής εργαλείων του πεδίου σύνταξης
Πατήστε Shift+Tab
Στείλτε /plan. Ένα σκέτο /plan απλώς οπλίζει τη λειτουργία· το /plan <request> την οπλίζει και στέλνει τα υπόλοιπα ως μήνυμά σας

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

Η λειτουργία αποθηκεύεται στον χώρο, οπότε ο ίδιος πράκτορας μπορεί να βρίσκεται σε λειτουργία σχεδίου εδώ και σε λειτουργία πράκτορα αλλού.

Τι παράγει ο πράκτορας

Ερευνά μόνο για ανάγνωση — μνήμη, το ευρετήριο κώδικα, αρχεία
Καλεί το submit_plan μία φορά, με έναν goal και nodes, που το καθένα φέρει ένα σταθερό key, ένα title, μια description και τα κλειδιά των κόμβων από τους οποίους εξαρτάται (dependsOn) — αυτό ακριβώς επιτρέπει στην ανεξάρτητη εργασία να εκτελείται παράλληλα
Σταματά

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

Το σχέδιο εμφανίζεται στη συνομιλία ως συμπαγής γραμμή που δείχνει τον στόχο, την κατάστασή του και τον αριθμό βημάτων. Το Plan Studio — το γράφημα εξαρτήσεων, ο επιθεωρητής ανά κόμβο και η εκτίμηση κόστους — ανοίγει ως καρτέλα δίπλα στη συνομιλία: πατήστε Άνοιγμα στη γραμμή ή απλώς περιμένετε, γιατί ένα σχέδιο που φτάνει μέσα σε 30 δευτερόλεπτα ενώ παρακολουθείτε τη συνομιλία ανοίγει μόνο του την καρτέλα του.

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

Ο προσαρμογέας Claude Code δεν έχει τέτοιο φιλτράρισμα: η λειτουργία φτάνει σε αυτόν ως αίτημα που ο δικός του εκτελεστής μπορεί ή όχι να σεβαστεί, και το Control Center βλέπει μόνο τις κλήσεις mcp__* του. Το ένδειγμα επιβολής δίπλα στο αναπτυσσόμενο μενού λειτουργίας εμφανίζεται ακριβώς όταν συμβαίνει αυτό.

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

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

Η πεζογραφία δεν είναι παραδοτέο εδώ. Μια εκτέλεση που τελειώνει χωρίς να καλέσει το submit_plan αναρτά μια ορατή γραμμή “Ended without submitting a plan (no submit_plan call).” στη συνομιλία και σηματοδοτεί την εκτέλεση ως απούσα το παραδοτέο της. Η κατάσταση της εκτέλεσης παραμένει σκόπιμα completed — αυτό αφήνει ανέπαφες τις μηχανές καταστάσεων των pipeline και των εισιτηρίων — οπότε διαβάστε τη γραμμή, όχι το σήμα κατάστασης.

Έγκριση του σχεδίου

Από τη γραμμή του σχεδίου στη συνομιλία, πατήστε Έγκριση και εκτέλεση. Από τη γραμμή έγκρισης του Plan Studio, πατήστε Έγκριση σχεδίου (ή Απόρριψη δίπλα της· η έγκριση είναι ανενεργή όσο το γράφημα έχει σφάλμα επικύρωσης).

Στη συνέχεια:

Το Control Center μεταγλωττίζει το σχέδιο σε μια ενορχήστρωση και την υλοποιεί — τα εισιτήρια και την εκτέλεση. Κανένα μοντέλο δεν εμπλέκεται σε αυτό το βήμα· είναι ντετερμινιστικό
Το σχέδιο εκτελείται ως ο πράκτορας που το έγραψε. Το αν θα μπει κάποιος άλλος είναι απόφαση εκείνου του πράκτορα κατά την εκτέλεση — μπορεί να αναθέσει ένα βήμα σε έναν καταλληλότερο συνεργάτη με delegate_task, εντός του ορίου βάθους ανάθεσης του χώρου εργασίας
Ο στόχος του σχεδίου γίνεται ο στόχος της συνομιλίας και η εργασία εκτελείται στην ίδια εκείνη συνομιλία: κάθε βήμα αναρτά τι ζητήθηκε από τον πράκτορα και μεταδίδει τη στροφή του πίσω, ώστε να την παρακολουθείτε (και να μπορείτε να σταματήσετε μια στροφή) εκεί που βρίσκεστε ήδη
Η γραμμή στόχου στον πλαϊνό πίνακα Γενικά της συνομιλίας (κάτω από τις Εκκρεμότητες) φέρει την πρόοδο της εκτέλεσης ως settled/total και το κουμπί διακοπής της· το Plan Studio δείχνει την κατάσταση ανά κόμβο στο γράφημα και επιτρέπει ακύρωση και εκεί

Συνέχεια εργασίας χωρίς έγκριση

Αν προτιμάτε να μείνετε σε αυτή τη συνομιλία αντί να εγκρίνετε το σχέδιο, ο πράκτορας μπορεί να καλέσει το exit_plan_mode. Αυτή είναι η μόνη εγκεκριμένη έξοδος: ανοίγει ένα διαρκές αίτημα έγκρισης συνδεδεμένο με τη συνομιλία και επιστρέφει pending — ο χώρος παραμένει σε λειτουργία σχεδίου και ο πράκτορας δεν πρέπει να ενεργήσει. Μόλις εγκριθεί το αίτημα, η επόμενη κλήση exit_plan_mode του πράκτορα γυρίζει τον χώρο από λειτουργία σχεδίου σε λειτουργία πράκτορα και ξεκλειδώνει τα εργαλεία μετάλλαξής του. Μια απόρριψη τού επιτρέπει να ανοίξει νέο αίτημα για αναθεωρημένο σχέδιο.

Για να βγείτε από τη λειτουργία σχεδίου, αλλάξτε το αναπτυσσόμενο μενού του πεδίου σύνταξης (ή πατήστε Shift+Tab) ή εγκρίνετε το υποβληθέν σχέδιο. Το exit_plan_mode ανοίγει μια διαρκή έγκριση που αποφασίζεται με το εργαλείο MCP decide_approval. Η επικάλυψη περιορισμών για μπλοκαρισμένες κλήσεις εργαλείων είναι διαφορετική, ουρά στη μνήμη, και δεν μεταφέρει αιτήματα εξόδου από σχέδιο.

Λειτουργία σχεδίου σε βήμα pipeline

Ένας κόμβος pipeline messaging.createSpace διαβάζει τη λειτουργία συνομιλίας από το extra mode της διαμόρφωσης του κόμβου — extras['mode']: 'plan'. Το κλειδί απαιτεί ακριβή αντιστοίχιση: οποιαδήποτε άλλη γραφή, συμπεριλαμβανομένων των conversationMode ή dispatchMode, αγνοείται σιωπηλά και το δωμάτιο πέφτει στην προεπιλογή του σώματος, που είναι λειτουργία ανασκόπησης, όχι συνομιλίας. Ένα βήμα promptAgent μπαίνει σε δωμάτιο που δεν δημιούργησε και δεν επαναρυθμίζει τα δικαιώματά του. Το αναπτυσσόμενο στοιχείο Λειτουργία αποστολής (allParallel / manager) του επεξεργαστή διαμόρφωσης κόμβου προορίζεται για κόμβους αποστολής ομάδας. Ορίστε τη λειτουργία συνομιλίας με το extras['mode'] σε ένα πρότυπο που ανοίγει τον χώρο ή στη διαμόρφωση εκείνου του κόμβου μέσω του API.