Freebuff στην πράξη: διάβασε τον κώδικα του πράκτορα πριν το merge

Ένα πράσινο σύνολο δοκιμών δεν είναι έλεγχος

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

Το ίδιο ισχύει για μια τακτοποιημένη σύνοψη: η περιγραφή τού τι έκανε ο πράκτορας είναι ισχυρισμός τού ίδιου συστήματος που έκανε την αλλαγή. Διάβασε το diff, όχι το συνοδευτικό σημείωμα, και πάρε τις δοκιμές ως ένα σήμα ανάμεσα σε άλλα.

Ξεκίνα από καθαρή και αναστρέψιμη κατάσταση

Πριν από το πρώτο prompt: κάνε commit ή άφησε στην άκρη τη δουλειά, δημιούργησε κλάδο και ξέρε ακριβώς πώς επιστρέφεις. Ένας πράκτορας με πρόσβαση στο τερματικό μπορεί να τρέξει μεταναστεύσεις, να ξαναγράψει ρυθμίσεις και να διαγράψει αρχεία· ένα αναστρέψιμο σημείο εκκίνησης μετατρέπει το ατύχημα σε ενόχληση.

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

Διάβασε το diff με τη σειρά που πονάει

Μια μεγάλη παραγόμενη αλλαγή ελέγχεται καλύτερα με σκόπιμη σειρά παρά από πάνω προς τα κάτω.

• Σημεία εισόδου: διαδρομές, χειριστές, άδειες και ό,τι αλλάζει ποιος φτάνει πού.
• Δεδομένα: σχήμα, μεταναστεύσεις, σειριοποίηση και ερωτήματα, ειδικά ό,τι διαγράφει ή αντικαθιστά.
• Ρυθμίσεις: μεταβλητές περιβάλλοντος, βήματα build, CI και ρυθμίσεις ανάπτυξης.
• Τα υπόλοιπα: ονόματα, δομή, διπλοτυπίες και οι καλλωπιστικές αλλαγές που φουσκώνουν το diff.

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

Εξαρτήσεις, μυστικά και γραμμές που κανείς δεν διαβάζει

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

Ψάξε για διαπιστευτήρια, token και εσωτερικά URL που δεν ανήκουν σε commit, και δες αν η καταγραφή άρχισε να τυπώνει δεδομένα πελατών. Ακριβώς αυτές τις γραμμές τις περνάει κανείς γρήγορα — και ακριβώς εκεί ο πράκτορας δεν έχει λόγο να είναι προσεκτικός: βελτιστοποιεί για το αίτημα, όχι για το μοντέλο απειλών σου.

Πότε να τα πετάξεις όλα

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

Ο ίδιος κανόνας ισχύει για το prompt: η λίστα ελέγχου από τον οδηγό μας για το Manus και οι συμβουλές δομής από τον οδηγό για το Prompt Cowboy μικραίνουν και τα δύο το diff. Για το προϊόν ξεκίνα από την επισκόπηση του Freebuff, και το πώς χειριζόμαστε τις συστάσεις το περιγράφει η δήλωση συνεργασίας μας.