Премини към основното съдържание
Български— Изберете език
Меню

Писане на код с Codex

Урок 5 от 20 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. От идея до код с една инструкция
  2. Създаване на нов файл или модул
  3. Добавяне на функции към съществуващ код
  4. Генериране на код от спецификация
  5. Работа с множество файлове
  6. Съвети за оптимални резултати
  7. Ключови изводи

От идея до код с една инструкция

Писането на код е задачата, която ще възлагате на Codex най-често и именно тук разликата между Codex и обикновен генератор на фрагменти става най-очевидна. Агентът не просто произвежда изолиран код, който след това трябва да адаптирате. Вместо това той чете вашата кодова база, разбира вашите конвенции и пише нещо, което се вписва безпроблемно във вашата съществуваща архитектура. Вашата работа следователно е по-малко да описвате код и повече да описвате място в рамките на една система.

Създаване на нов файл или модул

Когато генерирате напълно нов код, прецизността е толкова важна за контекста, колкото и за очакваната функционалност.

"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 прочита auth.service.ts, за да разбере текущия шаблон, анализира импортирането и зависимостите на проекта, създава файла със същата структура, добавя подходящи TypeScript типове и експортира функциите според конвенциите на проекта. Резултатът изглежда така:

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

Един детайл заслужава внимание: никой не е поискал валидация чрез Zod. Codex я добави, защото забеляза, че проектът използва Zod навсякъде другаде. Ето защо позоваването на моделен файл си заслужава – фраза от десет думи ви спестява цял параграф спецификации.

Добавяне на функции към съществуващ код

Агентите носят най-голяма полза при работа със съществуващ код, не защото писането на редове е трудно, а защото спазването на всичко около тях е такова.

"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 анализира съседните маршрути, идентифицира действителния middleware в употреба, отбелязва текущия формат на отговора и след това добавя крайната точка последователно. Тази разузнавателна работа би отнела много повече време от самото кодиране и това е точно частта, от която хората правят компромиси, когато бързат.

Генериране на код от спецификация

За сложни функции повишете нивото и напишете правилна спецификация. Всяка точка се превръща в изискване, което агентът третира като такова.

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

Тази спецификация предоставя числови стойности, името на хедъра, HTTP кода на състоянието, наличната инфраструктура и местоположението на файла. Всеки детайл премахва произволно решение, което Codex иначе би взел вместо вас – решение, което бихте открили едва по време на преглед на кода.

Работа с множество файлове

Една единствена задача може законно да обхваща множество слоеве на приложението, стига да изброите крайните резултати.

"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 произвежда и четирите файла кохерентно: услугата разчита на Prisma модела, маршрутите извикват услугата, а тестовете покриват маршрутите. Постигането на тази вертикална последователност е трудно, ако разделите заявката на четири отделни задачи, където всяка стъпка трябва отново да открие какво е решила предишната – и понякога да ѝ противоречи.

Съвети за оптимални резултати

Първо, помнете силата на позоваването на съществуващ код: „както в auth.service.ts“ предава с пет думи шаблон, чието описание би ви отнело цяла страница. Назовавайте библиотеките изрично – „използвайте Zod за валидация“, вместо „добавете валидация“ – и уточнявайте формата на изхода, когато това има значение, например униформен обект { success, data, error } в цялото ви API. Споменете граничните случаи, които ви притесняват, като „обработете случая, когато потребителят не съществува“: оставен на собствените си устройства, агентът обработва основния сценарий (happy path) и ви оставя да откриете останалото. Накрая, всичко, което повтаряте от задача на задача, принадлежи в AGENTS.md, което поддържа инструкциите ви кратки.

Ключови изводи

  • Codex разбира вашата кодова база и уважава вашите съществуващи конвенции
  • Правете препратки към съществуващи файлове, за да насочите стила и шаблоните
  • Детайлните спецификации водят до по-прецизни резултати
  • Codex може да създава и модифицира множество файлове в рамките на една задача
  • AGENTS.md допълва вашите инструкции с постоянни правила