Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Reviżjoni Awtomatizzata tal-Kodiċi

Lezzjoni 11 / 20 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Tejjeb il-Kwalità tal-Kodiċi b’Reviżjonijiet AI
  2. Mexxi Reviżjoni fuq PR
  3. Immira r-Reviżjonijiet lejn Dominju Speċifiku
  4. Awtomatizza r-Reviżjonijiet f’GitHub
  5. Awtoreviżjoni Qabel ma Tiftaħ il-PR
  6. Stabbilixxi l-Istandards Tiegħek f’AGENTS.md
  7. Punti Ewlenin

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 review jew reviżjoni awtomatika attivata fil-settings, lokalment permezz ta’ codex review --uncommitted jew /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:

  1. Qabbad ir-repożitorju GitHub tiegħek ma’ Codex (għandek bżonn drittijiet ta’ push jew amministratur fuq is-settings tiegħu).
  2. Iftaħ is-settings tar-reviżjoni tal-kodiċi.
  3. 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