Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kodo rašymas su Codex

Paskaita 5 iš 20 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Nuo idėjos iki kodo viena instrukcija
  2. Naujo failo ar modulio kūrimas
  3. Funkcijų pridėjimas į esamą kodą
  4. Kodo generavimas pagal specifikaciją
  5. Darbas su keliais failais
  6. Patarimai optimaliems rezultatams pasiekti
  7. Svarbiausi punktai

Nuo idėjos iki kodo viena instrukcija

Kodo rašymas – tai užduotis, kurią Codex skirsi dažniausiai, ir būtent čia ryškiausiai atsiskleidžia skirtumas tarp Codex ir paprasto kodo fragmentų generatoriaus. Agentas ne tik sugeneruoja atskirą kodo gabalėlį, kurį vėliau turėsi pritaikyti pats. Vietoj to, jis perskaito tavo kodų bazę, atpažįsta tavo naudojamas konvencijas ir parašo kodą, kuris organiškai įsilieja į esamą architektūrą. Todėl tavo darbas – ne aprašyti patį kodą, o nurodyti vietą sistemoje, kurioje jis turi atsirasti.

Naujo failo ar modulio kūrimas

Kuriant visiškai naują kodą, tikslumas yra toks pat svarbus kontekstui, kaip ir laukiamai funkcionalumui.

"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 perskaito auth.service.ts, kad suprastų dabartinį šabloną, išanalizuoja projekto importus ir priklausomybes, sukuria failą ta pačia struktūra, priduria tinkamus TypeScript tipus ir eksportuoja funkcijas pagal projekto konvencijas. Rezultatas atrodo taip:

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

Viena detalė verta dėmesio: niekas neprašė Zod validacijos. Codex ją pridėjo, nes pastebėjo, kad projekte Zod naudojama visur kitur. Štai kodėl verta nurodyti modelinį failą – dešimties žodžių frazė sutaupo tau visą pastraipą specifikacijų.

Funkcijų pridėjimas į esamą kodą

Agentai didžiausią vertę suteikia dirbdami su esamu kodu, ir ne todėl, kad eilučių rašymas būtų sunkus, o todėl, kad reikia atsižvelgti į viską, kas jį supa.

"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 išanalizuoja gretimus maršrutus, nustato tikrąją naudojamą tarpinę programinę įrangą (middleware), pastebi dabartinį atsako formatą ir tada nuosekliai priduria naują galinį tašką. Šis „žvalgybos“ darbas tau užtruktų daug ilgiau nei pats kodavimas, ir būtent šią dalį žmonės dažniausiai praleidžia, kai skuba.

Kodo generavimas pagal specifikaciją

Sudėtingoms funkcijoms pakilk lygmeniu aukščiau ir parašyk tinkamą specifikaciją. Kiekvienas punktas tampa reikalavimu, kurį agentas traktuoja kaip privalomą.

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

Ši specifikacija pateikia skaitines reikšmes, antraštės pavadinimą, HTTP būsenos kodą, prieinamą infrastruktūrą ir failo vietą. Kiekviena detalė pašalina savavališką sprendimą, kurį Codex būtų priėmęs už tave – sprendimą, kurį atrastum tik per kodo peržiūrą.

Darbas su keliais failais

Viena užduotis gali teisėtai apimti kelis programos sluoksnius, jei aiškiai išvardiji pristatytinus rezultatus.

"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 nuosekliai sugeneruoja visus keturis failus: servisas remiasi Prisma modeliu, maršrutai kviečia servisą, o testai padengia maršrutus. Pasiekti tokį vertikalų nuoseklumą būtų sunku, jei suskaidytum užklausą į keturias atskiras užduotis, kur kiekviename žingsnyje reikėtų iš naujo atrasti tai, ką nusprendė ankstesnis žingsnis – ir kartais tam prieštarauti.

Patarimai optimaliems rezultatams pasiekti

Pirmiausia, atminkite esamo kodo nuorodų galią: frazė „kaip faile auth.service.ts“ penkiais žodžiais perteikia šabloną, kurio aprašymui tau prireiktų viso puslapio. Aiškiai įvardyk bibliotekas – „naudok Zod validacijai“ vietoj „pridėk validaciją“ – ir, kai tai svarbu, nurodyk išvesties formatą, pavyzdžiui, vienodą { success, data, error } objektą visoje tavo API. Paminėk kraštutinius atvejus, kurie tau rūpi, pavyzdžiui, „apdorok atvejį, kai vartotojas neegzistuoja“: paliktas savo nuožiūrai, agentas apdoros tik sėkmingą scenarijų („happy path“), o likusius atvejus teks atrasti tau. Galiausiai, viską, ką kartoji nuo užduoties iki užduoties, įtrauk į AGENTS.md, kad tavo instrukcijos išliktų trumpos.

Svarbiausi punktai

  • Codex supranta tavo kodų bazę ir laikosi esamų konvencijų
  • Nuorodos į esamus failus nukreipia stilių ir šablonus
  • Išsamios specifikacijos duoda tiksliausius rezultatus
  • Codex gali sukurti ir modifikuoti kelis failus vienos užduoties metu
  • AGENTS.md papildo tavo instrukcijas nuolatinėmis taisyklėmis