Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Koda rakstīšana ar Codex

Nodarbība 5 no 20 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. No idejas līdz kodam vienā instrukcijā
  2. Jauna faila vai moduļa izveide
  3. Funkciju pievienošana esošam kodam
  4. Koda ģenerēšana no specifikācijas
  5. Darbs ar vairākiem failiem
  6. Padomi optimālu rezultātu sasniegšanai
  7. Galvenās atziņas

No idejas līdz kodam vienā instrukcijā

Koda rakstīšana ir uzdevums, ko visbiežāk uzticēsi Codex, un tieši šeit visskaidrāk iezīmējas atšķirība starp Codex un vienkāršu koda fragmentu ģeneratoru. Aģents ne tikai ģenerē izolētu koda gabalu, kas tev pēc tam jāpielāgo. Tā vietā tas nolasa tavu koda bāzi, izsecina tavus konvenciju noteikumus un uzraksta kaut ko, kas nevainojami iekļaujas tavā esošajā arhitektūrā. Tavs uzdevums tādēļ ir mazāk aprakstīt pašu kodu un vairāk aprakstīt konkrētu vietu sistēmā.

Jauna faila vai moduļa izveide

Ģenerējot pilnīgi jaunu kodu, precizitāte ir tikpat svarīga konteksta ziņā, cik paredzamās funkcionalitātes ziņā.

"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 nolasa auth.service.ts, lai saprastu pašreizējo paraugu, analizē projekta importus un atkarības, izveido failu ar tādu pašu struktūru, pievieno atbilstošus TypeScript tipus un eksportē funkcijas saskaņā ar projekta konvencijām. Rezultāts izskatās šādi:

// 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 detaļa ir pelnījusi uzmanību: neviens nelūdza Zod validāciju. Codex to pievienoja, jo pamanīja, ka projekts visur citur izmanto Zod. Tieši tāpēc atsauce uz parauga failu atmaksājas – desmit vārdu frāze ietaupa tev veselu specifikācijas rindkopu.

Funkciju pievienošana esošam kodam

Aģenti sniedz vislielāko vērtību, strādājot ar esošu kodu, nevis tāpēc, ka rindu rakstīšana būtu sarežģīta, bet gan tāpēc, ka ir grūti ievērot visu, kas to ieskauj.

"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 analizē blakus esošos maršrutus, identificē faktiski izmantoto starpprogrammatūru (middleware), fiksē pašreizējo atbildes formātu un pēc tam konsekventi pievieno jauno galapunktu. Šī izpētes darba veikšana tev prasītu daudz vairāk laika nekā pašam kodēšanas procesam, un tieši šo posmu cilvēki mēdz nokārtot pavirši, steidzoties.

Koda ģenerēšana no specifikācijas

Sarežģītām funkcijām paaugstini līmeni un uzraksti pienācīgu specifikāciju. Katrs punkts kļūst par prasību, ko aģents uztver tieši tā.

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

Šī specifikācija nodrošina skaitliskās vērtības, HTTP galvenes nosaukumu, HTTP statusa kodu, pieejamo infrastruktūru un faila atrašanās vietu. Katra detaļa novērš patvaļīgu lēmumu, ko Codex citādi pieņemtu tavā vietā – lēmumu, ko tu atklātu tikai koda pārskatīšanas laikā.

Darbs ar vairākiem failiem

Viens uzdevums likumīgi var aptvert vairākus lietotnes slāņus, ja vien tu uzskaiti sagaidāmos rezultātus.

"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 konsekventi ģenerē visus četrus failus: serviss balstās uz Prisma modeli, maršruti izsauc servisu, un testi pārklāj maršrutus. Šīs vertikālās saskaņotības sasniegšana ir sarežģīta, ja sadali pieprasījumu četros atsevišķos uzdevumos, kur katram solim no jauna jāatklāj, ko iepriekšējais ir nolēmis, un dažkārt pat jānonāk pretrunā ar to.

Padomi optimālu rezultātu sasniegšanai

Pirmkārt, atceries atsaukšanās uz esošu kodu spēku: „kā failā auth.service.ts” piecos vārdos nodod paraugu, kura aprakstīšanai tev būtu nepieciešama vesela lapa. Nosauc bibliotēkas eksplicīti – „validācijai izmanto Zod”, nevis „pievieno validāciju” – un norādi izvades formātu, ja tas ir svarīgi, piemēram, vienotu { success, data, error } objektu visā tavā API. Piemin arī robežgadījumus, kas tevi uztrauc, piemēram, „apstrādā gadījumu, kad lietotājs neeksistē”: ja to atstāsi aģenta ziņā, tas apstrādās tikai veiksmīgo scenāriju, bet pārējo atstās tev atklāšanai. Visbeidzot, viss, ko atkārto no uzdevuma uz uzdevumu, ir jāievieto failā AGENTS.md, lai tavas instrukcijas paliktu īsas.

Galvenās atziņas

  • Codex saprot tavu koda bāzi un ievēro tavas esošās konvencijas
  • Atsaucies uz esošiem failiem, lai vadītu stilu un paraugus
  • Detalizētas specifikācijas rada precīzākus rezultātus
  • Codex spēj izveidot un modificēt vairākus failus viena uzdevuma ietvaros
  • AGENTS.md papildina tavas instrukcijas ar pastāvīgiem noteikumiem