Koodin kirjoittaminen Codexilla
Tällä sivulla
Ideasta koodiksi yhdellä käskyllä
Koodin kirjoittaminen on tehtävä, jonka annat Codexille useimmiten, ja juuri siinä ero Codexin ja yksinkertaisen koodinpätkien generaattorin välillä käy kaikkein selvimmin. Agentti ei vain tuota eristettyä koodinpätkää, jota sinun pitäisi myöhemmin muokata. Sen sijaan se lukee koodikantasi, päättelee käyttämäsi käytännöt ja kirjoittaa jotain, joka istuu saumattomasti olemassa olevaan arkkitehtuuriisi. Tehtäväsi on siis vähemmän koodin kuvaamista ja enemmän järjestelmässä olevan paikan määrittämistä.
Uuden tiedoston tai moduulin luominen
Kun generoit täysin uutta koodia, tarkkuus on yhtä tärkeää kontekstin kuin odotetun toiminnallisuudenkin kannalta.
"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 lukee tiedoston auth.service.ts ymmärtääkseen nykyisen mallin, analysoi projektin tuonnit ja riippuvuudet, luo tiedoston samalla rakenteella, lisää sopivat TypeScript-tyypit ja vie funktiot projektin käytäntöjen mukaisesti. Tulos näyttää tältä:
// 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
}
Yksi yksityiskohta ansaitsee huomion: kukaan ei pyytänyt Zod-validointia. Codex lisäsi sen, koska se huomasi projektin käyttävän Zodía kaikkialla muualla. Siksi mallitiedostoon viittaaminen kannattaa – kymmenen sanan fraasi säästää sinut kokonaiselta määrittelykappaleelta.
Olemassa olevan koodin laajentaminen
Agentit tuottavat eniten arvoa olemassa olevalle koodille, ei siksi, että rivien kirjoittaminen olisi vaikeaa, vaan siksi, että niiden ympärillä olevien asioiden kunnioittaminen on.
"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 analysoi viereiset reitit, tunnistaa käytössä olevan välivaraston (middleware), huomaa nykyisen vastausmuodon ja lisää päätepisteen johdonmukaisesti. Tämä tiedustelutyö veisi sinulta paljon enemmän aikaa kuin varsinainen koodaus, ja juuri tämä on se osa, josta ihmiset tinkivät kiireessä.
Koodin generointi määritelmän perusteella
Monimutkaisten ominaisuuksien kohdalla nosta tasoa ylemmäs ja kirjoita kunnollinen määritelmä. Jokaisesta kohdasta tulee vaatimus, jota agentti kohtelee sellaisena.
"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"
Tämä määritelmä tarjoaa numeeriset arvot, otsikon nimen, HTTP-tilakoodin, käytettävissä olevan infrastruktuurin ja tiedoston sijainnin. Jokainen yksityiskohta poistaa mielivaltaisen päätöksen, jonka Codex muuten tekisi puolestasi – päätöksen, jonka huomaisit vasta koodikatselmuksen aikana.
Työskentely useiden tiedostojen kanssa
Yksi tehtävä voi perustellusti kattaa useita sovelluskerroksia, kunhan luettelet tuotokset.
"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 tuottaa kaikki neljä tiedostoa johdonmukaisesti: palvelu nojaa Prisma-malliin, reitit kutsuvat palvelua ja testit kattavat reitit. Tämän pystysuoran johdonmukaisuuden saavuttaminen on vaikeaa, jos pilkot pyynnön neljäksi erilliseksi tehtäväksi, joissa jokaisen vaiheen on löydettävä uudelleen, mitä edellinen päätti – ja joskus oltava sitä vastaan.
Vinkkejä optimaalisiin tuloksiin
Muista ensin olemassa olevaan koodiin viittaamisen voima: “kuten tiedostossa auth.service.ts” välittää viidellä sanalla mallin, jonka kuvaamiseen sinulta menisi sivukaupalla tekstiä. Nimeä kirjastot eksplisiittisesti – käytä “Zodia validointiin” äläkä vain “lisää validointi” – ja määritä tulostemuoto, kun sillä on väliä, kuten yhtenäinen { success, data, error } -objekti koko rajapinnassasi. Mainitse huolestuttavat reunatapaukset, kuten “käsittele tilanne, jossa käyttäjää ei ole olemassa”: omilleen jätettynä agentti hoitaa vain onnellisen polun ja jättää loput sinun löydettäväksesi. Lopuksi, kaikki mitä toistat tehtävästä toiseen, kuuluu tiedostoon AGENTS.md, mikä pitää ohjeesi lyhyinä.
Keskeiset asiat
- Codex ymmärtää koodikantasi ja kunnioittaa olemassa olevia käytäntöjäsi
- Viittaa olemassa oleviin tiedostoihin ohjataksesi tyyliä ja malleja
- Yksityiskohtaiset määritelmät tuottavat tarkempia tuloksia
- Codex voi luoda ja muokata useita tiedostoja yhdessä tehtävässä
- AGENTS.md täydentää ohjeitasi pysyvillä säännöillä