Pisanie kodu z Codex
Na tej stronie
Od pomysłu do kodu w jednej instrukcji
Pisanie kodu to zadanie, które będziesz powierzać Codexowi najczęściej i właśnie tutaj różnica między Codex a zwykłym generatorem fragmentów kodu staje się najbardziej widoczna. Agent nie produkuje po prostu izolowanego kawałka kodu, który potem musisz dostosować. Zamiast tego analizuje Twoją bazę kodu, wnioskowane stosowane konwencje i pisze coś, co bezproblemowo wpisuje się w istniejącą architekturę. Twoim zadaniem jest więc mniej opisywanie samego kodu, a bardziej wskazanie miejsca w systemie, gdzie ma on trafić.
Tworzenie nowego pliku lub modułu
Podczas generowania całkowicie nowego kodu precyzja jest równie ważna w kontekście, co w przypadku oczekiwanej funkcjonalności.
"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 odczytuje plik auth.service.ts, aby zrozumieć obecny wzorzec, analizuje importy i zależności projektu, tworzy plik o tej samej strukturze, dodaje odpowiednie typy TypeScript i eksportuje funkcje zgodnie z konwencjami projektu. Wynik wygląda następująco:
// 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 szczegół zasługuje na uwagę: nikt nie prosił o walidację Zod. Codex dodał ją, ponieważ zauważył, że projekt używa Zod we wszystkich innych miejscach. Dlatego odwoływanie się do pliku wzorcowego się opłaca – dziesięciowyrazowe zdanie oszczędza Ci pisania całego akapitu specyfikacji.
Dodawanie funkcji do istniejącego kodu
Agenci dostarczają największej wartości przy pracy z istniejącym kodem, nie dlatego, że napisanie linii jest trudne, ale dlatego, że trudne jest uszanowanie wszystkiego, co je otacza.
"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 analizuje sąsiednie route’y, identyfikuje faktycznie używany middleware, odnotowuje obecny format odpowiedzi, a następnie spójnie dodaje endpoint. To rozpoznanie zajęłoby Ci znacznie więcej czasu niż samo kodowanie i jest to dokładnie ta część, którą ludzie pomijają, gdy się spieszą.
Generowanie kodu na podstawie specyfikacji
W przypadku złożonych funkcji wejdź o poziom wyżej i napisz właściwą specyfikację. Każdy punkt staje się wymogiem, który agent traktuje jako taki.
"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"
Ta specyfikacja dostarcza wartości liczbowe, nazwę nagłówka, kod statusu HTTP, dostępną infrastrukturę oraz lokalizację pliku. Każdy szczegół eliminuje arbitralną decyzję, którą Codex podjąłby za Ciebie – decyzję, o której dowiedziałbyś się dopiero podczas przeglądu kodu.
Praca z wieloma plikami
Pojedyncze zadanie może słusznie obejmować wiele warstw aplikacji, pod warunkiem że wymienisz deliverables (elementy do dostarczenia).
"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 tworzy wszystkie cztery pliki w sposób spójny: serwis opiera się na modelu Prisma, route’y wywołują serwis, a testy pokrywają route’y. Osiągnięcie tej pionowej spójności jest trudne, jeśli podzielisz żądanie na cztery osobne zadania, gdzie każdy krok musi na nowo odkrywać to, co zdecydował poprzedni – a czasem nawet temu zaprzeczać.
Wskazówki dla optymalnych rezultatów
Po pierwsze, pamiętaj o sile odwoływania się do istniejącego kodu: „jak w auth.service.ts“ przekazuje w pięciu słowach wzorzec, którego opisanie zajęłoby Ci stronę. Nazywaj biblioteki wprost – „użyj Zod do walidacji“ zamiast „dodaj walidację“ – i określ format wyjścia, gdy ma to znaczenie, na przykład jednolity obiekt { success, data, error } w całym API. Wspomnij o przypadkach brzegowych, które Cię niepokoją, takich jak „obsłuż przypadek, gdy użytkownik nie istnieje“: pozostawiony sam sobie agent obsłuży tylko szczęśliwy scenariusz (happy path), a Tobie zostawi odkrywanie reszty. Na koniec, wszystko, co powtarzasz z zadania na zadanie, należy umieścić w pliku AGENTS.md, co pozwoli utrzymać Twoje instrukcje w zwięzłości.
Kluczowe wnioski
- Codex rozumie Twoją bazę kodu i szanuje Twoje istniejące konwencje
- Odwołuj się do istniejących plików, aby kierować stylem i wzorcami
- Szczegółowe specyfikacje przynoszą bardziej precyzyjne rezultaty
- Codex potrafi tworzyć i modyfikować wiele plików w ramach jednego zadania
- Plik AGENTS.md uzupełnia Twoje instrukcje o stałe reguły