Kód írása a Codex segítségével
Ezen az oldalon
Ötlettől a kódig egyetlen utasítással
A kódírás az a feladat, amelyet a leggyakrabban bízol a Codexre, és ez az a terület, ahol a Codex és egy egyszerű kódrészlet-generátor közötti különbség a legszembetűnőbb. Az ügynök nem csupán egy elszigetelt kódrészletet állít elő, amelyet aztán neked kell igazítanod. Ehelyett beolvassa a kódállományodat, következtet a konvencióidra, és olyat ír, amely zökkenőmentesen illeszkedik a meglévő architektúrádba. A te feladatod tehát kevésbé a kód leírása, sokkal inkább egy hely meghatározása a rendszeren belül.
Új fájl vagy modul létrehozása
Teljesen új kód generálásakor a pontosság ugyanolyan fontos a kontextus szempontjából, mint a várt funkcionalitás tekintetében.
"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)."
A Codex beolvassa a auth.service.ts fájlt, hogy megértse az aktuális mintát, elemzi a projekt importálásait és függőségeit, létrehozza a fájlt ugyanazzal a szerkezettel, hozzáadja a megfelelő TypeScript típusokat, és a projekt konvencióinak megfelelően exportálja a függvényeket. Az eredmény így néz ki:
// 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
}
Egy részlet külön figyelmet érdemel: senki nem kért Zod validálást. A Codex mégis hozzáadta, mert észrevette, hogy a projekt mindenhol máshol Zodot használ. Ezért éri meg egy modellfájlra hivatkozni: egy tíz szavas kifejezés megspórol neked egy egész bekezdésnyi specifikációt.
Funkciók hozzáadása meglévő kódhoz
Az ügynökök a meglévő kódon nyújtják a legnagyobb értéket, nem azért, mert nehéz lenne leírni a sorokat, hanem mert nehéz betartani mindent, ami körülveszi őket.
"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."
A Codex elemzi a szomszédos útvonalakat, azonosítja a ténylegesen használt middleware-t, megjegyzi az aktuális válaszformátumot, majd következetesen hozzáadja a végpontot. Ez a felderítő munka sokkal több időt venne igénybe tőled, mint maga a kódolás, és pontosan ez az a rész, amin az emberek spórolni szoktak, amikor sietnek.
Kód generálása specifikáció alapján
Komplex funkciók esetén lépj egy szinttel feljebb, és írj egy megfelelő specifikációt. Minden pont egy követelménnyé válik, amelyet az ügynök annak is kezel.
"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"
Ez a specifikáció numerikus értékeket, a fejléc nevét, a HTTP státuszkódot, a rendelkezésre álló infrastruktúrát és a fájl helyét tartalmazza. Minden egyes részlet kiküszöböl egy önkényes döntést, amelyet a Codex egyébként helyetted hozna meg – egy döntést, amelyre csak a kódreview során derülne fény.
Munka több fájllal
Egyetlen feladat jogosan spanzolhat több alkalmazásrétegen is, feltéve, hogy felsorolod a szállítandó elemeket.
"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"
A Codex mind a négy fájlt koherensen állítja elő: a szolgáltatás a Prisma modellre támaszkodik, az útvonalak meghívják a szolgáltatást, a tesztek pedig lefedik az útvonalakat. Ezt a függőleges konzisztenciát nehéz elérni, ha a kérést négy külön feladatra bontod, ahol minden lépésnek újra fel kell fedeznie, mit döntött az előző – és néha ellentmond annak.
Tippek az optimális eredményekhez
Először is, ne feledd a meglévő kódra való hivatkozás erejét: a „mint az auth.service.ts-ben“ kifejezés öt szóval közvetít egy mintát, amelyet neked egy oldal leírni. Nevezd meg expliciten a könyvtárakat – „használj Zodot a validáláshoz“ ahelyett, hogy „adj hozzá validálást“ –, és add meg a kimeneti formátumot, amikor számít, például egy egységes { success, data, error } objektumot az egész API-dban. Említsd meg azokat a perem eseteket, amelyek aggasztanak, például: „kezeld azt az esetet, amikor a felhasználó nem létezik“: ha magára hagyod, az ügynök csak a boldog utat (happy path) kezeli, a többit pedig rád hagyja felfedezni. Végül pedig bármit, amit feladatról feladatra ismételsz, az AGENTS.md fájlba érdemes tenni, így rövidebben tarthatod az utasításaidat.
Főbb megállapítások
- A Codex megérti a kódállományodat és tiszteli a meglévő konvencióidat
- Hivatkozz meglévő fájlokra a stílus és minták irányításához
- A részletes specifikációk pontosabb eredményeket hoznak
- A Codex képes több fájlt létrehozni és módosítani egyetlen feladat keretében
- Az AGENTS.md állandó szabályokkal egészíti ki az utasításaidat