Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Codebeoordeling automatiseren

Les 11 van 20 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Verbeter de codekwaliteit met AI-beoordelingen
  2. Een beoordeling uitvoeren op een PR
  3. Beoordelingen richten op een specifiek domein
  4. Beoordelingen automatiseren in GitHub
  5. Zelfbeoordeling voordat u de PR opent
  6. Leg uw standaarden vast in AGENTS.md
  7. Belangrijkste punten

Bijgewerkt op 3 november 2026 op basis van de pagina’s Code Review en Use Codex in GitHub in de Codex-documentatie en CLI-help versie 0.166.0: beoordelingen worden geactiveerd via @codex review of door automatische beoordeling in te schakelen in de instellingen, lokaal via codex review --uncommitted of /review; de AGENTS.md-sectie heeft als titel ## Code Review Rules. De extensieopdracht “Codex: Review Changes” en de URL codex.openai.com zijn verwijderd; het rapportvoorbeeld wordt gepresenteerd als illustratie. Bronnen: Code review · Use Codex in GitHub.

Verbeter de codekwaliteit met AI-beoordelingen

In de meeste teams is codebeoordeling een flessenhals geworden in de leveringspijplijn: pull requests stapelen zich op omdat ervaren reviewers zelf druk bezig zijn met het schrijven van code. Codex vervangt menselijke reviewers niet; het voert de eerste screening uit—het signaleert voor de hand liggende vergissingen, afwijkingen van de bestaande architectuur en niet-geteste randgevallen. Wanneer een ontwikkelaar uiteindelijk de PR opent, hoeft deze geen ontbrekende tests voor foutafhandeling meer aan te stippen; u kunt uw aandacht richten op beslissingen die zakelijk inzicht vereisen.

Een beoordeling uitvoeren op een PR

Op GitHub is de meest directe aanpak om Codex te vermelden in een commentaar bij een pull request: @codex review. Codex reageert (👀) en plaatst vervolgens de beoordeling in de PR. In de desktop-app toont de module Code Review de PR-beschrijving, gewijzigde bestanden, opmerkingen en checks, zodat u Codex kunt bevragen over de wijziging. In beide gevallen hangt de kwaliteit van het rapport af van de precisie van uw verzoek: benoem de gebieden die moeten worden gecontroleerd.

"Beoordeel PR #142. Controleer:
- Consistentie met bestaande architectuur
- Potentiële beveiligingsproblemen
- Testdekking
- TypeScript-codekwaliteit
- Niet-afgehandelde randgevallen"

Codex analyseert de diff, maar leest ook de context van de gewijzigde bestanden—niet alleen de gewijzigde regels—en levert vervolgens een gestructureerd rapport op. Hier volgt een voorbeeld van het type rapport dat u kunt verwachten voor een PR die meldingen toevoegt:

## Beoordeling PR #142 — Toevoeging meldingssysteem

### Beveiliging
⚠️ src/api/routes/notifications.ts:34
  De parameter userId komt uit de request body zonder 
  validatie. Een gebruiker zou namens een ander 
  meldingen kunnen versturen. Gebruik req.user.id uit 
  de authenticatiemiddleware.

### Architectuur
✅ De service volgt hetzelfde patroon als andere services
⚠️ Het bestand notification.service.ts is al 200 regels lang.
  Overweeg kanalen (e-mail, webhook) onder te brengen in 
  aparte bestanden.

### Tests
❌ Geen test voor wanneer de e-mailservice niet 
   beschikbaar is (time-out/netwerkfout)
⚠️ Tests mocken de DB maar niet de e-mailservice

### Codekwaliteit
💡 De functie sendBatch zou Promise.allSettled kunnen 
   gebruiken in plaats van Promise.all om te voorkomen 
   dat alles faalt als één van de 50 meldingen mislukt.

Let op de aard van de opmerkingen, niet op de opmaak. De userId-kwetsbaarheid is precies wat een gehaaste reviewer op een vrijdagavond over het hoofd ziet: de code compileert, tests slagen, toch kan elke gebruiker namens een ander schrijven. De suggestie voor Promise.allSettled getuigt van inzicht in het verwachte gedrag—een batchverzending mag niet falen omdat één van de vijftig adressen bounce—en is geen mechanische toepassing van een stijlregel.

Beoordelingen richten op een specifiek domein

Algemene beoordelingen verdunnen de aandacht over vijf onderwerpen tegelijk. Wanneer u een gevoelige productierelease voorbereidt, vraagt u in plaats daarvan om een gespecialiseerde controle met een beperkte reikwijdte. Voor beveiliging ziet de prompt er als volgt uit:

"Beveiligingsbeoordeling van bestanden gewijzigd in 
src/api/ over de laatste 5 commits. Zoek naar:
- SQL-injecties
- Potentiële XSS  
- Ontbrekende authenticatie
- Blootgelegde gevoelige gegevens
- Niet-gecontroleerde rechten"

Codex kent veelvoorkomende kwetsbaarheidspatronen en kan deze in uw code signaleren, zelfs wanneer ze verscholen gaan achter een eigen abstractielaag. Hetzelfde principe geldt voor prestaties, alleen jaagt u dan op heel andere symptomen—geen fout, maar een query die honderd keer wordt uitgevoerd waar één keer volstaan zou:

"Analyseer de prestaties van src/services/report.service.ts.
Identificeer:
- N+1 databasequeries
- Lussen die parallel kunnen worden uitgevoerd
- Geladen maar ongebruikte gegevens
- Berekeningen die kunnen worden gecachet"

Beoordelingen automatiseren in GitHub

Zodra de praktijk binnen het team is ingeburgerd, maakt u deze systematisch in plaats van afhankelijk van het geheugen van individuen. De Codex-documentatie beschrijft de installatie als volgt:

  1. Verbind uw GitHub-repository met Codex (u hebt push-rechten of beheerdersrechten op de instellingen nodig).
  2. Open de instellingen voor codebeoordeling.
  3. Selecteer de repository en schakel vervolgens Automatische beoordeling in onder Code beoordelen.

Iedereen kan ook automatische beoordeling inschakelen voor eigen PR’s in de persoonlijke voorkeuren en kiezen wanneer deze wordt geactiveerd (Review trigger), zonder dat u @codex review hoeft te typen. Voor deze cloudbeoordeling is het niet nodig een Codex Cloud-omgeving aan te maken. Opmerkingen verschijnen direct in de GitHub-PR, op dezelfde plek als opmerkingen van menselijke reviewers—een detail dat de adoptie bevordert: een opmerking die mensen dwingt een ander tool te openen, wordt niet gelezen. Beoordeling van GitLab merge requests bestaat ook, in preview.

Zelfbeoordeling voordat u de PR opent

Het beste moment om een probleem op te lossen, is voordat iemand anders het ziet. Vanuit de IDE of CLI kost een zelfbeoordeling van niet-gecommitte wijzigingen enkele seconden en bespaart u een volledige reviewronde:

# Vanuit CLI, niet-interactief: beoordeel niet-gecommitte wijzigingen
codex review --uncommitted

# Of beoordeel een branch ten opzichte van main
codex review --base main

In een interactieve sessie doet de opdracht /review hetzelfde op uw working tree; in de desktop-app biedt Code Review ook de mogelijkheid om lokale wijzigingen te beoordelen.

Probeer het bij uw volgende branch voordat u pusht: u zult merken dat de helft van de opmerkingen die u gewoonlijk van collega’s krijgt, al is afgehandeld, en dat het reviewgesprek op een interessanter niveau begint.

Leg uw standaarden vast in AGENTS.md

Een beoordeling heeft alleen waarde als deze uw teamcriteria toepast, niet die van een denkbeeldig project. Codex zoekt naar AGENTS.md-bestanden in de repository en volgt de daarin opgenomen beoordelingsregels: voeg een sectie ## Code Review Rules toe aan het bestand dat het dichtst bij de betreffende code ligt, met ###-subkoppen om checks te groeperen.

## Code Review Rules

### API
- Elke API-route moet authenticatie verifiëren
- Gebruikersgegevens moeten worden gevalideerd met Zod
- Geen TypeScript any (gebruik unknown + type guard)
- Fouten moeten met context worden gelogd
- Functies > 50 regels moeten worden opgesplitst
- TODO-opmerkingen moeten een gekoppeld ticket hebben

Codex past deze standaarden toe op elke beoordeling, met een consistentie die geen menselijke reviewer volhoudt over driehonderd opeenvolgende pull requests.

Belangrijkste punten

  • Codex voert een eerste screening uit om voor de hand liggende problemen te filteren
  • Beoordelingen kunnen worden gespecialiseerd: beveiliging, prestaties, architectuur
  • GitHub-integratie maakt automatische beoordelingen mogelijk bij elke PR
  • Gebruik beoordeling voor het aanmaken van de PR om tijd te besparen
  • Documenteer uw standaarden in AGENTS.md voor consistente beoordelingen