Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Pisanje kode s Codexom

Lekcija 5 od 20 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Od ideje do kode v enem navodilu
  2. Ustvarjanje nove datoteke ali modula
  3. Dodajanje funkcij obstoječi kodi
  4. Generiranje kode iz specifikacije
  5. Delo z več datotekami
  6. Nasveti za optimalne rezultate
  7. Ključne ugotovitve

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