Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Αυτοματοποιημένη Ανασκόπηση Κώδικα

Μάθημα 11 / 20 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Βελτίωση της Ποιότητας Κώδικα με Αναθεωρήσεις AI
  2. Εκτέλεση Αναθεώρησης σε ένα PR
  3. Στοχευμένες Αναθεωρήσεις ανά Τομέα
  4. Αυτοματοποίηση Αναθεωρήσεων στο GitHub
  5. Αυτο-αναθεώρηση Πριν το Άνοιγμα του PR
  6. Ορίστε τα Πρότυπά σας στο AGENTS.md
  7. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση τις σελίδες Code Review και Use Codex in GitHub της τεκμηρίωσης του Codex και τη βοήθεια CLI έκδοσης 0.166.0: οι αναθεωρήσεις ενεργοποιούνται μέσω @codex review ή με την αυτόματη αναθεώρηση που είναι ενεργοποιημένη στις ρυθμίσεις, τοπικά μέσω codex review --uncommitted ή /review· η ενότητα AGENTS.md έχει τίτλο ## Code Review Rules. Η εντολή επέκτασης “Codex: Review Changes” και το URL codex.openai.com έχουν καταργηθεί, και το παράδειγμα αναφοράς παρουσιάζεται ως επεξηγηματικό. Πηγές: Code review · Use Codex in GitHub.

Βελτίωση της Ποιότητας Κώδικα με Αναθεωρήσεις AI

Στις περισσότερες ομάδες, η αναθεώρηση κώδικα έχει μετατραπεί σε σημείο συμφόρησης στη ροή παράδοσης: τα pull requests συσσωρεύονται επειδή οι έμπειροι αναθεωρητές είναι απασχολημένοι γράφοντας οι ίδιοι κώδικα. Το Codex δεν αντικαθιστά τους ανθρώπινους αναθεωρητές· διεκπεραιώνει τον πρώτο έλεγχο, εντοπίζοντας προφανείς παραλείψεις, αποκλίσεις από την υπάρχουσα αρχιτεκτονική και μη δοκιμασμένες οριακές περιπτώσεις. Όταν τελικά ένας προγραμματιστής ανοίγει το PR, δεν χρειάζεται πλέον να επισημάνει ελλείποντες ελέγχους για μονοπάτια σφαλμάτων· μπορεί να εστιάσει την προσοχή του σε αποφάσεις που απαιτούν επιχειρηματική κρίση.

Εκτέλεση Αναθεώρησης σε ένα PR

Στο GitHub, η πιο άμεση προσέγγιση είναι να αναφέρετε το Codex σε ένα σχόλιο pull request: @codex review. Το Codex αντιδρά (👀) και στη συνέχεια δημοσιεύει την αναθεώρησή του στο PR. Στην εφαρμογή υπολογιστή, η ενότητα Code Review εμφανίζει την περιγραφή του PR, τα αρχεία που έχουν αλλάξει, τα σχόλια και τους ελέγχους, επιτρέποντάς σας να κάνετε ερωτήσεις στο Codex σχετικά με την αλλαγή. Και στις δύο περιπτώσεις, η ποιότητα της αναφοράς εξαρτάται από την ακρίβεια του αιτήματος: ονομάστε τις περιοχές που πρέπει να καλυφθούν.

"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"

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

## Review PR #142 — Notification System Addition

### Security
⚠️ src/api/routes/notifications.ts:34
  The userId parameter comes from the request body without 
  validation. A user could send notifications on behalf of 
  another. Use req.user.id from the authentication middleware.

### Architecture
✅ The service follows the same pattern as other services
⚠️ The notification.service.ts file is already 200 lines.
  Consider separating channels (email, webhook) into 
  distinct files.

### Tests
❌ No test for when the email service is 
   unavailable (timeout/network error)
⚠️ Tests mock the DB but not the email service

### Code quality
💡 The sendBatch function could use Promise.allSettled 
   instead of Promise.all to avoid failing if one 
   notification out of 50 fails.

Δώστε προσοχή στη φύση των σχολίων και όχι στη μορφοποίησή τους. Η τρωτότητα userId είναι ακριβώς αυτό που χάνει ένας βιαστικός αναθεωρητής ένα βράδυ Παρασκευής: ο κώδικας μεταγλωττίζεται, οι δοκιμές περνούν, ωστόσο οποιοσδήποτε χρήστης μπορεί να γράψει εκ μέρους άλλου. Η πρόταση Promise.allSettled αντικατοπτρίζει την κατανόηση της αναμενόμενης συμπεριφοράς—μια μαζική αποστολή δεν πρέπει να αποτύχει επειδή μία διεύθυνση από τις πενήντα δεν παραδόθηκε—και όχι τη μηχανική εφαρμογή ενός κανόνα στυλ.

Στοχευμένες Αναθεωρήσεις ανά Τομέα

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

"Security review on files modified in 
src/api/ over the last 5 commits. Look for:
- SQL injections
- Potential XSS  
- Missing authentication
- Exposed sensitive data
- Unchecked permissions"

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

"Analyze performance of src/services/report.service.ts.
Identify:
- N+1 database queries
- Loops that could be parallelized
- Loaded but unused data
- Calculations that could be cached"

Αυτοματοποίηση Αναθεωρήσεων στο GitHub

Μόλις η πρακτική εδραιωθεί στην ομάδα, καταστήστε τη συστηματική αντί να εξαρτάται από την ατομική μνήμη. Η τεκμηρίωση του Codex περιγράφει τη ρύθμιση ως εξής:

  1. Συνδέστε το αποθετήριο GitHub σας με το Codex (χρειάζεστε δικαιώματα push ή διαχειριστή στις ρυθμίσεις του).
  2. Ανοίξτε τις ρυθμίσεις αναθεώρησης κώδικα.
  3. Επιλέξτε το αποθετήριο και, στη συνέχεια, ενεργοποιήστε την Αυτόματη αναθεώρηση κάτω από την ενότητα Review code.

Όλοι μπορούν επίσης να ενεργοποιήσουν την αυτόματη αναθεώρηση για τα δικά τους PR στις προσωπικές τους προτιμήσεις και να επιλέξουν πότε θα ενεργοποιείται (Review trigger), χωρίς να χρειάζεται να πληκτρολογούν @codex review. Αυτή η αναθεώρηση cloud δεν απαιτεί τη δημιουργία περιβάλλοντος Codex Cloud. Τα σχόλια εμφανίζονται απευθείας στο PR του GitHub, στο ίδιο σημείο με τα σχόλια των ανθρώπινων αναθεωρητών—μια λεπτομέρεια που οδηγεί στην υιοθέτηση: μια παρατήρηση που αναγκάζει τους ανθρώπους να ανοίξουν ένα άλλο εργαλείο δεν θα διαβαστεί. Υπάρχει επίσης αναθεώρηση αιτήματος συγχώνευσης GitLab, σε προεπισκόπηση.

Αυτο-αναθεώρηση Πριν το Άνοιγμα του PR

Η καλύτερη στιγμή για να διορθώσετε ένα πρόβλημα είναι πριν το δει οποιοσδήποτε άλλος. Από το IDE ή το CLI, μια αυτο-αναθεώρηση σε μη υποβληθείσες αλλαγές διαρκεί δευτερόλεπτα και σας γλιτώνει έναν πλήρη κύκλο αναθεώρησης:

# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted

# Or review a branch against main
codex review --base main

Σε μια διαδραστική συνεδρία, η εντολή /review κάνει το ίδιο πράγμα στο δέντρο εργασίας σας· στην εφαρμογή υπολογιστή, το Code Review προσφέρει επίσης την αναθεώρηση τοπικών αλλαγών.

Δοκιμάστε το στο επόμενο branch σας πριν κάνετε push: θα διαπιστώσετε ότι τα μισά σχόλια που λαμβάνετε συνήθως από συναδέλφους έχουν ήδη αντιμετωπιστεί και η συζήτηση αναθεώρησης ξεκινά σε ένα πιο ενδιαφέρον επίπεδο.

Ορίστε τα Πρότυπά σας στο AGENTS.md

Μια αναθεώρηση έχει αξία μόνο αν εφαρμόζει τα κριτήρια της ομάδας σας και όχι εκείνα κάποιου φανταστικού έργου. Το Codex αναζητά αρχεία AGENTS.md στο αποθετήριο και ακολουθεί τους κανόνες αναθεώρησής τους: προσθέστε μια ενότητα ## Code Review Rules στο αρχείο που βρίσκεται πλησιέστερα στον σχετικό κώδικα, με υπότιτλους ### για την ομαδοποίηση των ελέγχων.

## Code Review Rules

### API
- Every API route must verify authentication
- User data must be validated with Zod
- No TypeScript any (use unknown + type guard)
- Errors must be logged with context
- Functions > 50 lines must be broken down
- TODO comments must have an associated ticket

Το Codex εφαρμόζει αυτά τα πρότυπα σε κάθε αναθεώρηση, με μια συνέπεια που κανένας ανθρώπινος αναθεωρητής δεν διατηρεί σε τριακόσια συνεχόμενα pull requests.

Βασικά σημεία

  • Το Codex εκτελεί μια αναθεώρηση πρώτου περάσματος για να φιλτράρει προφανή ζητήματα
  • Οι αναθεωρήσεις μπορούν να είναι εξειδικευμένες: ασφάλεια, επιδόσεις, αρχιτεκτονική
  • Η ενσωμάτωση με το GitHub επιτρέπει αυτόματες αναθεωρήσεις σε κάθε PR
  • Χρησιμοποιήστε την αναθεώρηση πριν δημιουργήσετε το PR για εξοικονόμηση χρόνου
  • Τεκμηριώστε τα πρότυπά σας στο AGENTS.md για συνεπείς αναθεωρήσεις