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

Συγγραφή Κώδικα με το Codex

Μάθημα 5 / 20 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Από την Ιδέα στον Κώδικα με Μία Οδηγία
  2. Δημιουργία Νέου Αρχείου ή Λειτουργικής Μονάδας
  3. Προσθήκη Λειτουργιών σε Υφιστάμενο Κώδικα
  4. Δημιουργία Κώδικα από Προδιαγραφή
  5. Εργασία με Πολλαπλά Αρχεία
  6. Συμβουλές για Βέλτιστα Αποτελέσματα
  7. Βασικά σημεία

Από την Ιδέα στον Κώδικα με Μία Οδηγία

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

Δημιουργία Νέου Αρχείου ή Λειτουργικής Μονάδας

Κατά τη δημιουργία εντελώς νέου κώδικα, η ακρίβεια είναι εξίσου σημαντική για το πλαίσιο όσο και για την αναμενόμενη λειτουργικότητα.

"Create a service at src/services/notification.service.ts that handles 
sending notifications via email and webhook. Use the same pattern as 
src/services/auth.service.ts. The service must expose sendEmail(to, subject, body) 
and sendWebhook(url, payload)."

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

// src/services/notification.service.ts
import { z } from "zod";
import { logger } from "@/lib/logger";
import { env } from "@/lib/env";

const emailSchema = z.object({
  to: z.string().email(),
  subject: z.string().min(1),
  body: z.string().min(1),
});

export async function sendEmail(
  to: string, 
  subject: string, 
  body: string
): Promise<void> {
  const validated = emailSchema.parse({ to, subject, body });
  // ... implementation
}

export async function sendWebhook(
  url: string, 
  payload: Record<string, unknown>
): Promise<Response> {
  // ... implementation
}

Μια λεπτομέρεια αξίζει προσοχής: κανείς δεν ζήτησε επικύρωση Zod. Το Codex την πρόσθεσε επειδή παρατήρησε ότι το έργο χρησιμοποιεί το Zod παντού αλλού. Αυτός είναι ο λόγος που η αναφορά σε ένα αρχείο-μοντέλο αποδίδει: μια φράση δέκα λέξεων σας γλιτώνει ολόκληρη παράγραφο προδιαγραφών.

Προσθήκη Λειτουργιών σε Υφιστάμενο Κώδικα

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

"In src/api/routes/users.ts, add a GET /users/:id/activity endpoint 
that returns the user's last 50 actions. Use the same authentication 
middleware as the other routes."

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

Δημιουργία Κώδικα από Προδιαγραφή

Για σύνθετες λειτουργίες, ανεβάστε το επίπεδο και γράψτε μια σωστή προδιαγραφή. Κάθε σημείο γίνεται μια απαίτηση την οποία ο πράκτορας αντιμετωπίζει ως τέτοια.

"Implement a rate limiting system for the API:
- Maximum 100 requests per minute per IP
- Maximum 1000 requests per hour per authenticated user
- Return an X-RateLimit-Remaining header
- Return 429 Too Many Requests when the limit is reached
- Store counters in Redis (already configured in the project)
- Create the middleware in src/middleware/rate-limit.ts"

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

Εργασία με Πολλαπλά Αρχεία

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

"Add an in-app notification system:
1. Prisma model Notification (id, userId, type, message, read, createdAt)
2. Service at src/services/notification.service.ts
3. CRUD API routes in src/api/routes/notifications.ts
4. Tests in src/api/routes/notifications.test.ts"

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

Συμβουλές για Βέλτιστα Αποτελέσματα

Πρώτον, θυμηθείτε τη δύναμη της αναφοράς σε υπάρχοντα κώδικα: το «όπως στο auth.service.ts» μεταφέρει με πέντε λέξεις ένα πρότυπο που θα σας έπαιρνε μια σελίδα να περιγράψετε. Ονομάστε ρητά τις βιβλιοθήκες—«χρησιμοποιήστε το Zod για επικύρωση» αντί για «προσθέστε επικύρωση»—και καθορίστε τη μορφή εξόδου όταν έχει σημασία, όπως ένα ομοιόμορφο αντικείμενο { success, data, error } σε όλο το API σας. Αναφέρετε οριακές περιπτώσεις που σας απασχολούν, όπως «διαχειριστείτε την περίπτωση όπου ο χρήστης δεν υπάρχει»: αν αφεθεί στις δικές του συσκευές, ο πράκτορας διαχειρίζεται την ευχάριστη διαδρομή και σας αφήνει να ανακαλύψετε τα υπόλοιπα. Τέλος, οτιδήποτε επαναλαμβάνετε από εργασία σε εργασία ανήκει στο AGENTS.md, κρατώντας τις οδηγίες σας σύντομες.

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

  • Το Codex κατανοεί τη βάση κώδικά σας και σέβεται τις υφιστάμενες συμβάσεις σας
  • Αναφερθείτε σε υπάρχοντα αρχεία για να καθοδηγήσετε το στυλ και τα πρότυπα
  • Λεπτομερείς προδιαγραφές παράγουν πιο ακριβή αποτελέσματα
  • Το Codex μπορεί να δημιουργήσει και να τροποποιήσει πολλαπλά αρχεία σε μία εργασία
  • Το AGENTS.md συμπληρώνει τις οδηγίες σας με μόνιμους κανόνες