Pisanje kode s Codexom
Na tej strani
Od ideje do kode v enem navodilu
Pisanje kode je naloga, ki jo boš Codexu dodelil najpogosteje, in prav tu je razlika med Codexom in preprostim generatorjem izrezkov najbolj očitna. Agent ne ustvari le osamljenega fragmenta kode, ki bi ga moral nato prilagoditi. Namesto tega prebere tvojo kodo, sklepa o tvojih konvencijah in napiše nekaj, kar se brezhibno vključi v tvojo obstoječo arhitekturo. Tvoje delo je zato manj opisovanje kode in bolj opisovanje mesta znotraj sistema.
Ustvarjanje nove datoteke ali modula
Pri generiranju povsem nove kode je natančnost enako pomembna za kontekst kot za pričakovano funkcionalnost.
"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 prebere auth.service.ts, da razume trenutni vzorec, analizira uvoze in odvisnosti projekta, ustvari datoteko z enako strukturo, doda ustrezne tipe TypeScript in izvozi funkcije v skladu s konvencijami projekta. Rezultat je videti takole:
// 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
}
Ena podrobnost si zasluži pozornost: nihče ni zahteval validacije Zod. Codex jo je dodal, ker je opazil, da projekt povsod drugje uporablja Zod. Zato se sklicevanje na modelno datoteko izplača – stavek z desetimi besedami ti prihrani cel odstavec specifikacij.
Dodajanje funkcij obstoječi kodi
Agenti prinašajo največjo vrednost pri obstoječi kodi, ne zato, ker bi bilo pisanje vrstic težko, ampak zato, ker je spoštovanje vsega, kar jih obdaja, zahtevno.
"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 analizira sosednje rute, identificira dejanski vmesnik (middleware), ki je v uporabi, zabeleži trenutni format odgovora in nato dosledno doda končno točko. To raziskovalno delo bi ti vzelo veliko več časa kot dejavno kodiranje in prav to je del, ki ga ljudje v naglici pogosto opravijo površno.
Generiranje kode iz specifikacije
Za kompleksne funkcije stopi korak višje in napiši ustrezno specifikacijo. Vsaka točka postane zahteva, ki jo agent obravnava kot takšno.
"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"
Ta specifikacija zagotavlja številčne vrednosti, ime glave, kodo stanja HTTP, razpoložljivo infrastrukturo in lokacijo datoteke. Vsaka podrobnost odstrani poljubno odločitev, ki bi jo Codex sicer sprejel namesto tebe – odločitev, ki bi jo odkril šele med pregledom kode.
Delo z več datotekami
Ena sama naloga lahko upravičeno zajema več plasti aplikacije, pod pogojem, da našteješ rezultate dela.
"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 koherentno ustvari vse štiri datoteke: storitev temelji na modelu Prisma, rute kličejo storitev, testi pa pokrivajo rute. Doseganje te navpične doslednosti je težko, če zahtevo razbiješ na štiri ločene naloge, kjer mora vsak korak znova odkriti, kaj je sklenil prejšnji – in ga včasih celo ovreči.
Nasveti za optimalne rezultate
Najprej se spomni moči sklicevanja na obstoječo kodo: „kot v auth.service.ts” v petih besedah prenese vzorec, za katerega bi ti potreboval stran opisa. Knjižnice imej eksplicitno – „uporabi Zod za validacijo” namesto „dodaj validacijo” – in določi izhodni format, kadar je to pomembno, na primer enoten objekt { success, data, error } v celotnem API-ju. Omeni robne primere, ki te skrbijo, kot je „obravnavaj primer, ko uporabnik ne obstaja”: če ga prepustiš samemu sebi, bo agent obravnaval srečni potek, tebi pa prepustil odkrivanje ostalega. Končno, vse, kar ponavljaš iz naloge v nalogo, spada v AGENTS.md, kar ohranja tvoja navodila kratka.
Ključne ugotovitve
- Codex razume tvojo kodo in spoštuje tvoje obstoječe konvencije
- Sklicuj se na obstoječe datoteke za usmerjanje sloga in vzorcev
- Podrobne specifikacije prinašajo bolj natančne rezultate
- Codex lahko ustvari in spremeni več datotek v eni sami nalogi
- AGENTS.md dopolnjuje tvoja navodila s trajnimi pravili