Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Automatiseeritud koodiülevaade

Õppetund 11 / 20 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Paranda koodi kvaliteeti AI-ülevaadetega
  2. Käivita ülevaade PR-il
  3. Suuna ülevaated konkreetsele valdkonnale
  4. Automatiseeri ülevaated GitHubis
  5. Eneseülevaade enne PR-i avamist
  6. Määra oma standardid failis AGENTS.md
  7. Peamised punktid

Uuendatud 3. novembril 2026, tuginedes Codexi dokumentatsiooni ja CLI abi versiooni 0.166.0 lehtedele Code Review ja Use Codex in GitHub: ülevaated käivituvad käsuga @codex review või seadistustes lubatud automaatse ülevaatega, lokaalselt käsuga codex review --uncommitted või /review; AGENTS.md jaotis kannab pealkirja ## Code Review Rules. Käsk „Codex: Review Changes“ ja URL codex.openai.com on eemaldatud ning aruande näide on esitatud illustreeriva materjalina. Allikad: Code review · Use Codex in GitHub.

Paranda koodi kvaliteeti AI-ülevaadetega

Enamikes meeskondades on koodiülevaade muutunud tarneahela pudelikaelaks: tõmbe taotlused (pull requests) kuhjuvad, kuna oskuspärased ülevaatajad on hõivatud ise koodi kirjutamisega. Codex ei asenda inimülevaatajaid; see teeb esmase läbivaatuse – tabades ilmsed tähelepanematused, kõrvalekalded olemasolevast arhitektuurist ja testimata äärijuhtumid. Kui arendaja lõpuks PR-i avab, ei pea ta enam puuduvaid veateede teste välja tooma; ta saab keskenduda otsustele, mis nõuavad ärilist hinnangut.

Käivita ülevaade PR-il

GitHubis on kõige otsesem viis mainida Codexit tõmbe taotluse kommentaaris: @codex review. Codex reageerib (👀) ja postitab seejärel oma ülevaate PR-i. Töölauarakenduses kuvab moodul Code Review PR-i kirjelduse, muudetud failid, kommentaarid ja kontrollid, võimaldades sul Codexilt muudatuste kohta päringuid esitada. Mõlemal juhul sõltub aruande kvaliteet taotluse täpsusest: nimeta valdkonnad, mida tuleb käsitleda.

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

Codex analüüsib diffi, kuid loeb ka muudetud failide konteksti – mitte ainult muudetud ridu – ja esitab seejärel struktureeritud aruande. Siin on näide sellisest aruandest, mida võid oodata PR-ilt, mis lisab teavitussüsteemi:

## 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.

Pööra tähelepanu kommentaaride olemusele, mitte nende vormingule. userId haavatavus on täpselt see, mida kiirustav ülevaataja reede õhtul märkamata jätab: kood kompileerub, testid õnnestuvad, ometi saab iga kasutaja kirjutada teise nimel. Ettepanek kasutada Promise.allSettled peegeldab arusaamist oodatavast käitumisest – partii saatmine ei tohiks nurjuda sellepärast, et üks aadress viiekümnest põrkab tagasi – mitte stiilireegli mehaanilist rakendamist.

Suuna ülevaated konkreetsele valdkonnale

Üldised ülevaated hajutavad tähelepanu korraga viiele teemale. Tundliku tootmisväljalaske ettevalmistamisel taotle selle asemel spetsialiseeritud läbivaatust kitsale scope’ile. Turvalisuse jaoks näeb vihje välja selline:

"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 tunneb levinud haavatavusmustreid ja suudab need sinu koodis tuvastada, isegi kui need on peidetud kohandatud abstraktsioonikihi taha. Sama põhimõte kehtib jõudluse kohta, ainult et siin jahid sa hoopis teistsuguseid sümptomeid – mitte viga, vaid päringut, mis jookseb sada korda, kui üks kord piisaks:

"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"

Automatiseeri ülevaated GitHubis

Kui tava on meeskonnas juurdunud, tee sellest süsteemne protsess, mitte üksikute liikmete mälust sõltuv tegevus. Codexi dokumentatsioon kirjeldab seadistust järgmiselt:

  1. Ühenda oma GitHubi hoidla Codexiga (sul on vaja selle seadistustes push-õigusi või administraatori õigusi).
  2. Ava koodiülevaate seaded.
  3. Vali hoidla ja luba jaotises Review code valik Automatic review.

Igaüks saab lubada automaatse ülevaate oma isiklikes eelistustes ka omaenda PR-idele ja valida, millal see käivitub (Review trigger), ilma et peaks trükkima @codex review. See pilvepõhine ülevaade ei nõua Codex Cloudi keskkonna loomist. Kommentaarid ilmuvad otse GitHubi PR-i, samasse kohta kui inimülevaatajate kommentaarid – detail, mis soodustab kasutuselevõttu: märkus, mis sunnib inimesi avama teist tööriista, jääb lugemata. GitLab’i liitmistaotluse (merge request) ülevaade on samuti olemas, kuid eelvaaterežiimis.

Eneseülevaade enne PR-i avamist

Parim aeg probleemi lahendamiseks on enne, kui keegi teine seda näeb. IDE-st või CLI-st tehtud kinnitamata muudatuste eneseülevaade võtab sekundeid ja säästab sulle terve ülevaateringi:

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

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

Interaktiivses sessioonis teeb käsk /review sama asja sinu tööpuiduga; töölauarakenduses pakub Code Review samuti võimalust kohalikke muudatusi üle vaadata.

Proovi seda oma järgmises harus enne pushimist: sa avastad, et pooled kommentaarid, mida tavaliselt kolleegidelt saad, on juba lahendatud, ja ülevaatevestlus algab huvitavamal tasemel.

Määra oma standardid failis AGENTS.md

Ülevaadel on väärtust ainult siis, kui see rakendab sinu meeskonna kriteeriume, mitte mõne väljamõeldud projekti omi. Codex otsib hoidlast faile AGENTS.md ja järgib nende ülevaatereegleid: lisa failile, mis asub vastava koodi lähimal, jaotis ## Code Review Rules, kasutades kontrollide rühmitamiseks alampeatükke ###.

## 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 rakendab neid standardeid igas ülevaates järjepidevusega, mida ükski inimülevaataja ei suuda säilitada kolmesaja järjestikuse tõmbe taotluse vältel.

Peamised punktid

  • Codex teeb esmase läbivaatuse, et filtreerida ilmsed probleemid
  • Ülevaated võivad olla spetsialiseeritud: turvalisus, jõudlus, arhitektuur
  • GitHubi integratsioon võimaldab automaatseid ülevaateid igal PR-il
  • Kasuta ülevaadet enne PR-i loomist, et aega säästa
  • Dokumenteerige oma standardid failis AGENTS.md järjepidevate ülevaadete jaoks