Cód a Scríobh le Codex
Ar an leathanach seo
Ó Smaoineamh go Cód in Aon Treoir Amháin
Is é scríobh cóid an tasc a thabharfaidh tú do Codex is minice, agus is ansin a fheictear an difríocht idir Codex agus gineadóir blúirí cód simplí go soiléir. Ní tháirgeann an gníomhaire blúire cód aonair ar chóir duit oiriúnú ina dhiaidh sin. Ina ionad sin, léann sé do bhunús cód, déanann sé do choinbhinsiúin a thuiscint, agus scríobhann sé rud a oireann gan uaim d’ailtireacht atá ann cheana. Mar sin, is lú atá do phost faoi chód a chur síos agus níos mó faoi áit laistigh de chóras a chur síos.
Comhad nó Modúl Nua a Chruthú
Nuair a ghintear cód go hiomlán nua, tá an chruinneas chomh tábhachtach don chomhthéacs agus atá sé don fheidhmiúlacht a bhfuiltear ag súil leis.
"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)."
Léann Codex auth.service.ts chun an patrún reatha a thuiscint, déanann sé anailís ar iompórtálacha agus ar spleáchais an tionscadail, cruthaíonn sé an comhad leis an struchtúr céanna, cuireann sé cineálacha TypeScript cuí leis, agus easpórálann sé na feidhmeanna de réir choinbhinsiúin an tionscadail. Seo mar a bheidh an toradh:
// 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
}
Tá mionsonra amháin ar chóir aird a thabhairt air: níor iarr aon duine bailíochtú Zod. Chuir Codex leis é toisc gur thug sé faoi deara go n-úsáideann an tionscadal Zod i ngach áit eile. Sin an fáth a mbíonn luach saothair ag baint le comhad samhaltach a lua – sábhálann frása deich bhfocal paragraf iomlán sonraithe duit.
Gnéithe a Chur le Cód Atá Ann Cheana
Seachadann gníomhairí an luach is mó ar chód atá ann cheana, ní toisc go bhfuil sé deacair na línte a scríobh, ach toisc go bhfuil sé deacair gach rud timpeall orthu a urramú.
"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."
Déanann Codex anailís ar bhealaí cóngaracha, aithníonn sé an meánearra fíor atá in úsáid, tugann sé faoi deara an fhormáid freagartha reatha, agus ansin cuireann sé an críochphointe leis go comhsheasmhach. Thógfadh an obair fiosrúcháin seo i bhfad níos faide ort ná an códú iarbhír, agus is é go díreach an chuid sin a dhéanann daoine gearrthacha air nuair a bhíonn siad i mbiaith.
Cód a Ghiniúint ó Shonraíocht
Do ghnéithe casta, téigh céim níos airde agus scríobh sonraíocht cheart. Déantar riachtanas de gach pointe a chaitheann an gníomhaire mar sin.
"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"
Soláthraíonn an tsonraíocht seo luachanna uimhriúla, ainm an cheanntáisc, an cód stádais HTTP, an bonneagar atá ar fáil, agus suíomh an chomhaid. Baineann gach mionsonra cinneadh treallach ar dhéanfadh Codex é ar do shon ar shlí eile – cinneadh nach dtabharfá faoi deara ach le linn athbhreithnithe cóid.
Ag Obair le Comhaid Iolracha
Is féidir le tasc amháin síneadh go dlisteanach thar sraitheanna iolracha feidhmchláir, ar choinníoll go liostaíonn tú na seachadtaí.
"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"
Táirgeann Codex na ceithre chomhad go léir go comhleanúnach: braitheann an tseirbhís ar an tsamhail Prisma, glaonn na bealaí ar an tseirbhís, agus clúdaíonn na tástálacha na bealaí. Tá sé deacair an chomhsheasmhacht ingearach seo a bhaint amach má bhriseann tú an t-iarratas ina cheithre thasc ar leith, áit ar chóir do gach céim a fháil amach arís cad a shocraigh an ceann roimhe – agus uaireanta contradh a dhéanamh leis.
Leideanna do Thorthaí Optamacha
Ar dtús, cuimhnigh ar chumhacht cód atá ann cheana a lua: léiríonn “mar atá in auth.service.ts” i gcúig fhocal patrún a thógfadh leathanach ort a chur síos. Ainmnigh leabharlanna go sainráite – “úsáid Zod le haghaidh bailíochtaithe” seachas “cuir bailíochtú leis” – agus sonraigh an fhormáid aschuir nuair a bhíonn tábhacht leis, mar shampla oibiacht aonfhoirmeach { success, data, error } ar fud do API ar fad. Luigh cásanna imealla a bhfuil imní ort fúthu, cosúil le “láimhseáil an cás nach bhfuil an t-úsáideoir ann”: má fhágtar leis féin é, láimhseálann an gníomhaire an cosán sona agus fágann sé leatsa an chuid eile a fháil amach. Ar deireadh, is é AGENTS.md an t-áit ar chóir aon rud a dhéanann tú athrá air ó thasc go tasc a chur, rud a choinníonn do threoracha gairid.
Príomhphointí
- Tuigeann Codex do bhunús cód agus urramaíonn sé do choinbhinsiúin atá ann cheana
- Tagairt do chomhaid atá ann cheana chun stíl agus patrúin a threorú
- Cruthaíonn sonraíochtaí mionsonraithe torthaí níos cruinne
- Is féidir le Codex comhaid iolracha a chruthú agus a mhodhnú in aon tasc amháin
- Forlíonann AGENTS.md do threoracha le rialacha buan