Písanie kódu s Codexom
Na tejto strane
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á