Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Písanie kódu s Codexom

Lekcia 5 z 20 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Od nápadu ku kódu v jednom príkaze
  2. Vytváranie nového súboru alebo modulu
  3. Pridávanie funkcií do existujúceho kódu
  4. Generovanie kódu zo špecifikácie
  5. Práca s viacerými súbormi
  6. Tipy pre optimálne výsledky
  7. Kľúčové poznatky

Od nápadu ku kódu v jednom príkaze

Písanie kódu je úloha, ktorú budeš Codexu zadávať najčastejšie, a práve tu je rozdiel medzi Codexom a jednoduchým generátorom úryvkov kódu najzrejmejší. Agent nevytvorí len izolovaný fragment kódu, ktorý musíš následne upravovať. Namiesto toho si prečíta tvoju kódovú základňu, odvodí tvoje konvencie a napíše niečo, čo sa bezproblémovo zapadne do tvojej existujúcej architektúry. Tvojou úlohou je preto menej opisovať kód a viac opisovať miesto v systéme.

Vytváranie nového súboru alebo modulu

Pri generovaní úplne nového kódu záleží na presnosti kontextu rovnako ako na očakávanej funkcionalite.

"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 si prečíta auth.service.ts, aby pochopil aktuálny vzor, analyzuje importy a závislosti projektu, vytvorí súbor s rovnakou štruktúrou, pridá vhodné typy TypeScript a exportuje funkcie podľa konvencií projektu. Výsledok vyzerá takto:

// 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
}

Jeden detail si zaslúži pozornosť: nikto nepožiadal o validáciu pomocou Zod. Codex ju pridal, pretože si všimol, že projekt používa Zod všade inde. Preto sa oplatí odkazovať na vzorový súbor – desaťslovná fráza ti ušetrí celý odsek špecifikácií.

Pridávanie funkcií do existujúceho kódu

Agenty prinášajú najväčšiu hodnotu pri práci s existujúcim kódom, nie preto, že by bolo ťažké napísať riadky, ale preto, že je náročné rešpektovať všetko okolo nich.

"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 analyzuje susedné routy, identifikuje skutočne používaný middleware, zaznamená aktuálny formát odpovede a následne konzistentne pridá endpoint. Táto prieskumná práca by ti zabrala oveľa viac času než samotné kódovanie a je to presne tá časť, na ktorej ľudia v uponáhľaní šetria.

Generovanie kódu zo špecifikácie

Pri komplexných funkciách sa posuň o úroveň vyššie a napíš poriadnu špecifikáciu. Každý bod sa stane požiadavkou, ktorú agent berie ako takú.

"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"

Táto špecifikácia poskytuje číselné hodnoty, názov hlavičky, HTTP stavový kód, dostupnú infraštruktúru a umiestnenie súboru. Každý detail odstraňuje ľubovoľné rozhodnutie, ktoré by inak Codex urobil za teba – rozhodnutie, ktoré by si objavil až počas kódovej revízie.

Práca s viacerými súbormi

Jedna úloha môže oprávnene zasahovať do viacerých vrstiev aplikácie za predpokladu, že vymenuješ výstupy.

"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 vytvorí všetky štyri súbory koherentne: služba sa spolieha na Prisma model, routy volajú službu a testy pokrývajú routy. Dosiahnuť túto vertikálnu konzistenciu je ťažké, ak požiadavku rozdelíš na štyri samostatné úlohy, kde musí každý krok nanovo zisťovať, čo rozhodol ten predchádzajúci – a niekedy tomu aj odporovať.

Tipy pre optimálne výsledky

Po prvé, pamätaj na silu odkazovania na existujúci kód: „ako v auth.service.ts“ vyjadrí v piatich slovách vzor, ktorý by ti trvalo stranu popísať. Knížnice menuj explicitne – „použi Zod na validáciu“ namiesto „pridaj validáciu“ – a keď na tom záleží, špecifikuj výstupný formát, napríklad jednotný objekt { success, data, error } v celej tvojej API. Spomeň hraničné prípady, ktoré ťa trápia, ako napríklad „ošetri prípad, keď používateľ neexistuje“: ak ho necháš na vlastné zariadenie, agent ošetrí len šťastnú cestu a objavovanie ostatného nechá na teba. Nakoniec, všetko, čo opakuješ z úlohy na úlohu, patrí do súboru AGENTS.md, čím udržíš svoje inštrukcie stručné.

Kľúčové poznatky

  • Codex rozumie tvojej kódovej základni a rešpektuje tvoje existujúce konvencie
  • Odkazuj na existujúce súbory, aby si usmernil štýl a vzory
  • Podrobné špecifikácie prinášajú presnejšie výsledky
  • Codex dokáže vytvoriť a upraviť viacero súborov v rámci jednej úlohy
  • AGENTS.md dopĺňa tvoje inštrukcie o trvalé pravidlá