Писане на код с Codex
На тази страница
От идея до код с една инструкция
Писането на код е задачата, която ще възлагате на 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 допълва вашите инструкции с постоянни правила