Reviżjoni Awtomatizzata tal-Kodiċi
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026 abbażi tal-paġni Code Review u Use Codex in GitHub fid-dokumentazzjoni ta’ Codex u l-għajnuna tal-CLI verżjoni 0.166.0: ir-reviżjonijiet jiġu attivati permezz ta’
@codex reviewjew reviżjoni awtomatika attivata fil-settings, lokalment permezz ta’codex review --uncommittedjew/review; it-taqsima AGENTS.md hija intitolata## Code Review Rules. Il-kmand tal-estensjoni “Codex: Review Changes” u l-URL codex.openai.com tneħħew, u l-eżempju tar-rapport huwa ppreżentat bħala illustrazzjoni. Sorsi: Code review · Use Codex in GitHub.
Tejjeb il-Kwalità tal-Kodiċi b’Reviżjonijiet AI
Fil-biċċa l-kbira tat-timijiet, ir-reviżjoni tal-kodiċi saret il-kolli tal-flixkun fil-pipeline tal-konsenja: il-pull requests jakkumulaw għax ir-reviżuri kkwalifikati huma okkupati jiktbu l-kodiċi huma stess. Codex ma jissostitwixxix lir-reviżuri umani; jimmaniġġja l-ewwel pass—jaqbad in-nuqqasijiet ovvji, id-devjazzjonijiet mill-arkitettura eżistenti, u l-każijiet limitu mhux ittestjati. Meta żviluppatur finalment jiftaħ il-PR, m’għadux jeħtieġ li jindika testijiet nieqsa għal mogħdijiet ta’ żball; jista’ jiffoka l-attenzjoni tiegħu fuq deċiżjonijiet li jeħtieġu ġudizzju tan-negozju.
Mexxi Reviżjoni fuq PR
Fuq GitHub, l-aktar approċċ dirett huwa li ssemmi lil Codex f’kumment ta’ pull request: @codex review. Codex jirreaġixxi (👀), imbagħad jippubblika r-reviżjoni tiegħu fil-PR. Fl-app tad-desktop, il-modulu Code Review juri d-deskrizzjoni tal-PR, il-fajls mibdula, il-kummenti u ċ-checks, u jħalliek tistaqsi lil Codex dwar il-bidla. Fiż-żewġ każijiet, il-kwalità tar-rapport tiddependi fuq il-preċiżjoni tat-talba: semmi l-oqsma li trid tkopri.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
Codex janalizza d-diff, iżda jaqra wkoll il-kuntest tal-fajls mibdula—mhux biss il-linji mibdula—imbagħad iwassal rapport strutturat. Hawnhekk hemm eżempju tat-tip ta’ rapport li tista’ tistenna għal PR li żżid notifiki:
## 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.
Agħti attenzjoni lin-natura tal-kummenti aktar milli l-iffurmar tagħhom. Il-vulnerabbiltà userId hija eżattament dak li reviżur mgħaġġel jitlifha filgħaxija ta’ Ġimgħa: il-kodiċi jikkompila, it-testijiet jgħaddu, madankollu kwalunkwe utent jista’ jikteb f’isem ieħor. Is-suġġeriment Promise.allSettled jirrifletti fehim tal-imġiba mistennija—batch send m’għandux ifalli għax indirizz wieħed minn ħamsin jerġa’ lura—mhux applikazzjoni mekkanika ta’ regola ta’ stil.
Immira r-Reviżjonijiet lejn Dominju Speċifiku
Reviżjonijiet ġenerali jdilwu l-attenzjoni fuq ħames suġġetti f’daqqa. Meta tkun qed tħejji rilaxx sensittiv tal-produzzjoni, itlob pass speċjalizzat fuq ambitu dejjaq minflok. Għas-sigurtà, il-prompt jidher hekk:
"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"
Codex jaf mudelli komuni ta’ vulnerabbiltà u jista’ jindunahom fil-kodiċi tiegħek, anke meta jkunu moħbija wara saff ta’ astrazzjoni personalizzat. L-istess prinċipju japplika għall-prestazzjoni, ħlief li qed tfittex sintomi differenti ħafna—mhux difett, iżda query li qed tiġi esegwita mitt darba fejn waħda biżżejjed:
"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"
Awtomatizza r-Reviżjonijiet f’GitHub
Ladarba l-prattika tiġi stabbilita fit-tim, agħmilha sistematika minflok ma tiddependi fuq il-memorja individwali. Id-dokumentazzjoni ta’ Codex tiddeskrivi l-installazzjoni hekk:
- Qabbad ir-repożitorju GitHub tiegħek ma’ Codex (għandek bżonn drittijiet ta’ push jew amministratur fuq is-settings tiegħu).
- Iftaħ is-settings tar-reviżjoni tal-kodiċi.
- Agħżel ir-repożitorju, imbagħad attiva Automatic review taħt Review code.
Kulħadd jista’ wkoll jattiva reviżjoni awtomatika għall-PRs tiegħu stess fil-preferenzi personali tiegħu u jagħżel meta tiġi attivata (Review trigger), mingħajr ma jkollok bżonn tikteb @codex review. Din ir-reviżjoni cloud ma teħtieġx li toħloq ambjent Codex Cloud. Il-kummenti jidhru direttament fil-PR ta’ GitHub, fl-istess post bħall-kummenti tar-reviżur uman—detall li jmexxi l-adozzjoni: kumment li jfurza lin-nies jiftħu għodda oħra ma jiġix moqri. Ir-reviżjoni tal-merge request ta’ GitLab teżisti wkoll, f’verżjoni preview.
Awtoreviżjoni Qabel ma Tiftaħ il-PR
L-aħjar ħin biex issolvi problema huwa qabel ma xi ħadd ieħor jaraha. Mill-IDE jew mill-CLI, awtoreviżjoni fuq bidliet mhux imwettqa (uncommitted) tieħu sekondi u tiffrankalek ċiklu sħiħ ta’ reviżjoni:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
F’sessjoni interattiva, il-kmand /review jagħmel l-istess ħaġa fuq is-siġra tax-xogħol (working tree) tiegħek; fl-app tad-desktop, Code Review joffri wkoll li jirrevedi bidliet lokali.
Ippruvah fuq il-branch li jmiss tiegħek qabel ma timbottah: se ssib li nofs il-kummenti li ġeneralment tirċievi mill-kollegi tiegħek diġà ġew indirizzati, u l-konversazzjoni tar-reviżjoni tibda f’livell aktar interessanti.
Stabbilixxi l-Istandards Tiegħek f’AGENTS.md
Reviżjoni għandha valur biss jekk tapplika l-kriterji tat-tim tiegħek, mhux dawk ta’ xi proġett immaġinarju. Codex ifittex fajls AGENTS.md fir-repożitorju u jsegwi r-regoli tar-reviżjoni tagħhom: żid taqsima ## Code Review Rules fil-fajl l-aktar qrib il-kodiċi rilevanti, b’sottotitli ### biex tiggruppja ċ-checks.
## 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
Codex japplika dawn l-istandards għal kull reviżjoni, b’konsistenza li l-ebda reviżur uman ma jżomm matul tliet mitt pull request konsekuttivi.
Punti Ewlenin
- Codex iwettaq reviżjoni ta’ ewwel pass biex jiffiltra kwistjonijiet ovvji
- Ir-reviżjonijiet jistgħu jkunu speċjalizzati: sigurtà, prestazzjoni, arkitettura
- L-integrazzjoni ma’ GitHub tippermetti reviżjonijiet awtomatiċi fuq kull PR
- Uża r-reviżjoni qabel ma toħloq il-PR biex tiffranka l-ħin
- Iddokumenta l-istandards tiegħek f’AGENTS.md għal reviżjonijiet konsistenti