Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Athbhreithniú Cód Uathoibrithe

Ceacht 11 as 20 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Feabhas a Chur ar Chaighdeán an Chóid le hAthbhreithnithe AI
  2. Athbhreithniú a Rith ar PR
  3. Athbhreithnithe a Dhíriú ar Fhearann
  4. Athbhreithnithe a Uathoibriú in GitHub
  5. Féin-Athbhreithniú Sula nOsclaítear an PR
  6. Do Chaidéil a Shocrú in AGENTS.md
  7. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar na leathanaigh Code Review agus Use Codex in GitHub i ndoiciméadú Codex agus sa chabhair CLI leagan 0.166.0: spreagtar athbhreithnithe trí @codex review nó athbhreithniú uathoibrithe a chumasú sna socruithe, go logánta trí codex review --uncommitted nó /review; tá an chuid AGENTS.md dar teideal ## Code Review Rules. Baineadh an t-ordú leathanaigh “Codex: Review Changes” agus an tURL codex.openai.com, agus cuirtear sampla na tuairisce i láthair mar léaráid. Foincí: Code review · Use Codex in GitHub.

Feabhas a Chur ar Chaighdeán an Chóid le hAthbhreithnithe AI

I bhformhór na bhfoirne, tá an t-athbhreithniú cóid tar éis éirí ina bhac ar an bpíobán seachadta: carnann iarraidh tarraingthe (pull requests) toisc go bhfuil athbhreithneoirí oilte gnóthach ag scríobh cóid iad féin. Ní chuireann Codex athbhreithneoirí daonna ar ceal; déanann sé an chéad pas—ag gabháil dearmad soiléir, dialltaí ón ailtireacht atá ann cheana, agus cásanna imeallacha gan tástáil. Nuair a osclaíonn forbróir an PR sa deireadh, ní gá dó lipéid a chur ar thástálacha atá in easnamh ar chonairí earráide; is féidir leis aird a dhíriú ar chinntí a éilíonn breithiúnas gnó.

Athbhreithniú a Rith ar PR

Ar GitHub, is é an cur chuige is díreach ná Codex a lua i dtuairim ar iarraidh tarraingthe: @codex review. Freagraíonn Codex (👀), ansin foilsíonn sé a athbhreithniú sa PR. Sa bhfeidhmchlár deisce, taispeánann an modúl Code Review cur síos an PR, na comhaid athraithe, tuairimí, agus seiceálacha, rud a ligeann duit ceisteanna a chur ar Codex faoin athrú. Sa dá chás, braitheann cáilíocht na tuairisce ar chruinneas an iarratais: ainmnigh na réimsí le clúdach.

"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"

Déanann Codex anailís ar an dif, ach léann sé comhthéacs na gcomhad modhnaithe freisin—ní hamháin na línte athraithe—ansin seachadann sé tuairisc struchtúrtha. Seo sampla den chineál tuairisce ar féidir leat súil a bheith agat leis do PR a chuireann fógraí leis:

## Review PR #142 — Notification System Addition

### Security
⚠️ src/api/routes/notifications.ts:34
  The userId parameter comes from the request body without 
  validation. A user could send notifications on behalf of 
  another. Use req.user.id from the authentication middleware.

### Architecture
✅ The service follows the same pattern as other services
⚠️ The notification.service.ts file is already 200 lines.
  Consider separating channels (email, webhook) into 
  distinct files.

### Tests
❌ No test for when the email service is 
   unavailable (timeout/network error)
⚠️ Tests mock the DB but not the email service

### Code quality
💡 The sendBatch function could use Promise.allSettled 
   instead of Promise.all to avoid failing if one 
   notification out of 50 fails.

Tabhair aird ar nádúr na dtuairimí seachas a bhformáidiú. Is é an leochaileacht userId go díreach an rud a dhéanann athbhreithneoir faoi dhruim a dhearmad tráthnóna Aoine: tiomsaíonn an cód, rithann na tástálacha, ach is féidir le haon úsáideoir scríobh thar ceann duine eile. Léiríonn an moladh Promise.allSettled tuiscint ar an iompar a bhfuiltear ag súil leis—níor chóir go dteipfeadh ar sheoladh baisce toisc go dteipeann ar sheoladh amháin as caoga—seachas cur i bhfeidhm meicniúil ar riail stíle.

Athbhreithnithe a Dhíriú ar Fhearann

Caolaíonn athbhreithnithe ginearálta an aird ar chúig ábhar ag an am céanna. Ag ullmhú scaoileadh táirgeachta íogair, iarr pas speisialaithe ar scóip cúng ina ionad sin. Don tslándáil, breathnaíonn an leid mar seo:

"Security review on files modified in 
src/api/ over the last 5 commits. Look for:
- SQL injections
- Potential XSS  
- Missing authentication
- Exposed sensitive data
- Unchecked permissions"

Tá a fhios ag Codex patrúin leochaileachta choitianta agus is féidir leis iad a bhrath i do chód, fiú nuair a bhíonn siad i bhfolach taobh thiar de shraitheanna teibíochta saincheaptha. Baineann an prionsabal céanna le feidhmíocht, ach tá tú ag seilg ar chomharthaí an-difriúil—ní locht, ach ceist a ritheann céad uair nuair a bheadh ceann amháin leordhóthanach:

"Analyze performance of src/services/report.service.ts.
Identify:
- N+1 database queries
- Loops that could be parallelized
- Loaded but unused data
- Calculations that could be cached"

Athbhreithnithe a Uathoibriú in GitHub

Nuair a bhíonn an cleachtas bunaithe sa fhoireann, déan é a dhéanamh córasach seachas bheith ag brath ar chuimhne indibhidiúil. Déanann doiciméadú Codex cur síos ar an socrú mar a leanas:

  1. Ceangail do stór GitHub le Codex (teastaíonn cearta push nó riarthóra uait ar a shocruithe).
  2. Oscail na socruithe athbhreithnithe cóid.
  3. Roghnaigh an stór, ansin cumasaigh Automatic review faoi Review code.

Is féidir le gach duine athbhreithniú uathoibrithe a chumasú dá chuid PRanna féin ina roghanna pearsanta freisin agus a roghnú cathain a spreagtar é (Review trigger), gan gá le @codex review a chlóscríobh. Ní éilíonn an t-athbhreithniú scamall seo timpeallacht Codex Cloud a chruthú. Feictear tuairimí go díreach sa PR GitHub, san áit chéanna le tuairimí athbhreithneora dhaonna—mionsonraí a spreagann glacadh: ní léifear trácht a éilíonn ar dhaoine uirlis eile a oscailt. Tá athbhreithniú iarraidh cumaisc GitLab ann freisin, i réamhamharc.

Féin-Athbhreithniú Sula nOsclaítear an PR

Is é an t-am is fearr fadhb a shocrú ná sula bhfeiceann aon duine eile í. Ón IDE nó ón CLI, tógann féin-athbhreithniú ar athruithe gan tiomantú soicind agus sábhálann sé turas iomlán athbhreithnithe ort:

# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted

# Or review a branch against main
codex review --base main

I seisiún idirghníomhach, déanann an t-ordú /review an rud céanna ar do chrann oibre; san fheidhmchlár deisce, tairgeann Code Review athbhreithniú a dhéanamh ar athruithe logánta freisin.

Bain triail as ar do chéad chraobh eile sula ndéanann tú brú: gheobhaidh tú amach go bhfuil leath na dtuairimí a gheobhádá de ghnáth ó chomhghleacaithe tugtha faoi deara cheana, agus tosaíonn an comhrá athbhreithnithe ag leibhéal níos suimiúla.

Do Chaidéil a Shocrú in AGENTS.md

Níl luach ar bith ag athbhreithniú mura gcuireann sé critéir do fhoirne i bhfeidhm, ní critéir tionscadail shamhaltaigh. Déanann Codex cuardach ar chomhaid AGENTS.md sa stór agus leanann sé a rialacha athbhreithnithe: cuir alt ## Code Review Rules leis an gcomhad is gaire don chód ábhartha, le focheanntais ### chun seiceálacha a ghrúpáil.

## Code Review Rules

### API
- Every API route must verify authentication
- User data must be validated with Zod
- No TypeScript any (use unknown + type guard)
- Errors must be logged with context
- Functions > 50 lines must be broken down
- TODO comments must have an associated ticket

Cuirann Codex na caighdeáin seo i bhfeidhm ar gach athbhreithniú, le comhsheasmhacht nach gcoinníonn aon athbhreithneoir daonna ar thrí chéad iarraidh tarraingthe as a chéile.

Príomhphointí

  • Déanann Codex athbhreithniú céad pas chun fadhbanna soiléire a scagadh
  • Is féidir athbhreithnithe a bheith speisialaithe: slándáil, feidhmíocht, ailtireacht
  • Cuireann comhtháthú GitHub athbhreithnithe uathoibrithe ar chumas ar gach PR
  • Bain úsáid as an athbhreithniú roimh an PR a chruthú chun am a shábháil
  • Doiciméadaigh do chaighdeáin in AGENTS.md le haghaidh athbhreithnithe comhsheasmhacha