Koodi kirjutamine Codexiga
Sellel lehel
Ideest koodini ühe käsuga
Koodi kirjutamine on ülesanne, mille annad Codexile kõige sagedamini, ja just siin tuleb kõige selgemini esile erinevus Codexi ja lihtsa koodilõikude generaatori vahel. Agent ei loo üksikut koodifragmenti, mida peaksid hiljem ise kohandama. Selle asemel loeb ta sinu koodibaasi, mõistab sinu kokkuleppeid ja kirjutab midagi, mis sobitub sujuvalt sinu olemasoleva arhitektuuriga. Sinu töö seisneb seega vähem koodi kirjeldamises ja rohkem süsteemis asukoha määratlemises.
Uue faili või mooduli loomine
Täiesti uue koodi genereerimisel on konteksti täpsus sama oluline kui oodatav funktsionaalsus.
"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 loeb faili auth.service.ts, et mõista praegust mustrit, analüüsib projekti imporditavaid mooduleid ja sõltuvusi, loob faili sama struktuuriga, lisab sobivad TypeScripti tüübid ja ekspordib funktsioonid vastavalt projekti kokkulepetele. Tulemus näeb välja selline:
// 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
}
Üks detail väärib tähelepanu: keegi ei palunud Zodiga valideerimist. Codex lisas selle, sest märkas, et projekt kasutab Zod’i kõikjal mujal. Seepärast tasub viidata olemasolevale mudelifailile – kümnest sõnast koosnev fraas säästab sind tervest lõigust spetsifikatsiooni kirjutamisest.
Olemasolevale koodile funktsioonide lisamine
Agendid toovad suurimat väärtust just olemasoleva koodi puhul, mitte sellepärast, et ridade kirjutamine oleks keeruline, vaid sest ümbritseva austamine on seda.
"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 analüüsib naaberruute, tuvastab tegelikult kasutatava vahevara (middleware), paneb tähele praegust vastuse vormingut ja lisab seejärel lõpp-punkti kooskõlaliselt. See luuretegevus võtaks sinult palju rohkem aega kui tegelik kodeerimine ja just see on osa, millest inimesed kiirustades mööda hiilivad.
Koodi genereerimine spetsifikatsiooni põhjal
Keerukate funktsioonide puhul astu sammuke tagasi ja kirjuta korralik spetsifikatsioon. Iga punkt muutub nõudeks, mida agent käsitleb kui sellist.
"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"
See spetsifikatsioon sisaldab arvulisi väärtusi, päise nime, HTTP olekukoodi, olemasolevat taristut ja faili asukohta. Iga detail kõrvaldab suvalise otsuse, mille Codex muidu sinu eest teeks – otsuse, mille avastaksid alles koodi ülevaatuse käigus.
Töö mitme failiga
Üksainus ülesanne võib õigustatult hõlmata mitut rakenduse kihti, eeldusel et loetled tarnitavad osad.
"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 loob kõik neli faili kooskõlaliselt: teenus tugineb Prisma mudelile, ruudid kutsuvad teenust ja testid katavad ruute. Sellise vertikaalse järjepidevuse saavutamine on keeruline, kui jagad taotluse neljaks eraldi ülesandeks, kus iga samm peab uuesti avastama, mida eelmine otsustas – ja mõnikord sellele isegi vastu rääkima.
Nõuanded optimaalsete tulemuste saavutamiseks
Esiteks, pea meeles olemasolevale koodile viitamise jõudu: „nagu failis auth.service.ts“ edastab viie sõnaga mustri kirjeldamiseks, mille sõnastamiseks kulub sul lehekülg. Nimeta teegid selgelt – „kasuta valideerimiseks Zod-i“ asemel „lisa valideerimine“ – ja määra väljundvorming, kui see on oluline, näiteks ühtne { success, data, error } objekt kogu sinu API ulatuses. Maini äärejuhtumeid, mis sind muretsema panevad, nagu „käsitle juhtu, kui kasutajat ei eksisteeri“: omapead jäetuna käsitleb agent vaid õnnelikku stsenaariumi ja jätab ülejäänu sinu avastada. Lõpuks, kõik, mida kordad ühest ülesandest teise, kuulub faili AGENTS.md, hoides sinu juhised lühikestena.
Peamised punktid
- Codex mõistab sinu koodibaasi ja austab sinu olemasolevaid kokkuleppeid
- Viita olemasolevatele failidele, et suunata stiili ja mustreid
- Üksikasjalikud spetsifikatsioonid annavad täpsemaid tulemusi
- Codex suudab luua ja muuta mitut faili ühe ülesande raames
- AGENTS.md täiendab sinu juhiseid püsivate reeglitega