Automaattinen koodikatselmus
Tällä sivulla
Päivitetty 3. marraskuuta 2026 perustuen Code Review ja Use Codex in GitHub -sivuihin Codex-dokumentaatussa sekä CLI-ohjeen versiossa 0.166.0: katselmukset käynnistyvät komennolla
@codex reviewtai asetuksista kytketyllä automaattisella katselmuksella; paikallisesti käytössäcodex review --uncommittedtai/review; AGENTS.md-osion otsikko on## Code Review Rules. “Codex: Review Changes” -laajennuskomento ja codex.openai.com-osoite on poistettu, ja raporttiesimerkki esitetään havainnollistuksena. Lähteet: Code review · Use Codex in GitHub.
Paranna koodin laatua tekoälykatselmuksilla
Useimmissa tiimeissä koodikatselmuksesta on tullut toimitusputken pullonkaula: vetopyynnöt kasautuvat, koska kokeneet katselmoijat ovat kiireisiä kirjoittaessaan itse koodia. Codex ei korvaa ihmiskatselmoijia; se hoitaa ensimmäisen läpikäynnin – huomaten ilmeiset huolimattomuudet, poikkeamat nykyisestä arkkitehtuurista ja testaamattomat reunatapaukset. Kun kehittäjä lopulta avaa vetopyynnön, hänen ei tarvitse enää merkitä puuttuvia virhepolkutestejä; hän voi keskittää huomionsa liiketoiminnallista harkintaa vaativiin päätöksiin.
Suorita katselmus vetopyynnölle
GitHubissa suoraviivaisin tapa on mainita Codex vetopyynnön kommentissa: @codex review. Codex reagoi (👀) ja julkaisee katselmuksensa vetopyyntöön. Työpöytäsovelluksessa Code Review -moduuli näyttää vetopyynnön kuvauksen, muutetut tiedostot, kommentit ja tarkistukset, jolloin voit kysyä Codexilta muutoksista. Molemmissa tapauksissa raportin laatu riippuu pyynnön tarkkuudesta: nimeä käsiteltävät alueet.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
Codex analysoi erotuksen, mutta se lukee myös muutettujen tiedostojen kontekstin – ei pelkästään muuttuneita rivejä – ja toimittaa sitten jäsennellyn raportin. Tässä esimerkki raportista, jonka voit odottaa saavasi vetopyynnölle, joka lisää ilmoitusjärjestelmän:
## 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.
Kiinnitä huomiota kommenttien luonteeseen äläkä niiden muotoiluun. userId-haavoittuvuus on juuri se, mitä kiireinen katselmoija ei huomaa perjantai-iltana: koodi kääntyy, testit menevät läpi, silti kuka tahansa käyttäjä voi kirjoittaa toisen puolesta. Promise.allSettled-ehdotus heijastaa odotetun käyttäytymisen ymmärtämistä – erälähetys ei saisi epäonnistua, koska yksi osoite viidestäkymmenestä palautuu – eikä tyylisäännön mekaanista soveltamista.
Kohdenna katselmukset toimialueelle
Yleiset katselmukset hajauttavat huomion viiteen aiheeseen kerralla. Kun valmistelet herkkää tuotantoreleaseä, pyydä sen sijaan erikoistunutta läpikäyntiä kapeammalle alueelle. Tietoturvan osalta kehote näyttää tältä:
"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 tuntee yleiset haavoittuvuuskuviot ja osaa havaita ne koodistasi, vaikka ne olisi piilotettu mukautetun abstraktiokerroksen taakse. Sama periaate pätee suorituskykyyn, paitsi että etsit hyvin erilaisia oireita – et virhettä, vaan kyselyä, joka suoritetaan sata kertaa, vaikka yksi riittäisi:
"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"
Automatisoi katselmukset GitHubissa
Kun käytäntö on vakiintunut tiimissä, tee siitä systemaattinen yksilöiden muistin varassa olemisen sijaan. Codex-dokumentaatio kuvaa asennuksen seuraavasti:
- Yhdistä GitHub-varastosi Codexiin (tarvitset push-oikeudet tai ylläpitäjäoikeudet sen asetuksiin).
- Avaa koodikatselmuksen asetukset.
- Valitse varasto ja ota käyttöön Automatic review kohdassa Review code.
Jokainen voi myös ottaa automaattisen katselmuksen käyttöön omille vetopyynnöilleen henkilökohtaisissa asetuksissaan ja valita, milloin se laukeaa (Review trigger), ilman että tarvitsee kirjoittaa @codex review. Tämä pilvikatselmus ei vaadi Codex Cloud -ympäristön luomista. Kommentit ilmestyvät suoraan GitHub-vetopyyntöön samaan paikkaan kuin ihmiskatselmoijien kommentit – yksityiskohta, joka edistää käyttöönottoa: huomautus, joka pakottaa ihmiset avaamaan toisen työkalun, jää lukematta. Gitlab-yhdistämispyyntöjen katselmus on myös olemassa esikatseluvaiheessa.
Itsekatselmus ennen vetopyynnön avaamista
Paras aika korjata ongelma on ennen kuin kukaan muu näkee sen. IDE:stä tai komentoriviltä suoritetuilla sitomattomien muutosten itsekatselmuksella säästät kokonaisen katselmuskierroksen muutamassa sekunnissa:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
Vuorovaikutteisessa istunnossa /review-komento tekee saman työpuiden muutoksille; työpöytäsovelluksessa Code Review tarjoaa myös paikallisten muutosten katselmoimista.
Kokeile sitä seuraavassa haarassasi ennen pushaamista: huomaat, että puolet kollegoiltasi yleensä saamistasi kommenteista on jo käsitelty, ja katselmuskeskustelu alkaa kiinnostavammalta tasolta.
Määritä standardisi AGENTS.md-tiedostoon
Katselmuksella on arvoa vain, jos se soveltaa tiimisi kriteereitä, ei jonkin kuvitteellisen projektin sääntöjä. Codex etsii varastosta AGENTS.md-tiedostoja ja noudattaa niiden katselmuksessa käytettäviä sääntöjä: lisää tiedostoon, joka on lähimpänä asiaankuuluvaa koodia, osio ## Code Review Rules ja ryhmittele tarkistukset ###-alaotsikoilla.
## 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 soveltaa näitä standardeja jokaiseen katselmukseen johdonmukaisuudella, jota yksikään ihmiskatselmoija ei ylläpitäisi kolmensadan peräkkäisen vetopyynnön ajan.
Keskeiset asiat
- Codex suorittaa ensimmäisen läpikäynnin ilmeisten ongelmien seulomiseksi
- Katselmukset voidaan erikoistaa: tietoturva, suorituskyky, arkkitehtuuri
- GitHub-integraatio mahdollistaa automaattiset katselmukset jokaiselle vetopyynnölle
- Käytä katselmusta ennen vetopyynnön luomista säästääksesi aikaa
- Dokumentoi standardisi AGENTS.md-tiedostoon johdonmukaisten katselmusten varmistamiseksi