Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Automatisēta koda apskate

Nodarbība 11 no 20 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Uzlabo koda kvalitāti ar AI apskatēm
  2. Veic apskati PR
  3. Mērķē apskates uz konkrētu domēnu
  4. Automatizē apskates GitHub vidē
  5. Pašapskate pirms PR atvēršanas
  6. Nostiprini savus standartus failā AGENTS.md
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Code Review un Use Codex in GitHub lapām Codex dokumentācijā un CLI palīdzības versijā 0.166.0: apskates tiek aktivizētas, izmantojot @codex review vai automātisko apskati, kas iespējota iestatījumos; lokāli tās veic ar codex review --uncommitted vai /review; sadaļa AGENTS.md ir nosaukta ## Code Review Rules. Komanda “Codex: Review Changes” un URL adrese codex.openai.com ir noņemtas, un ziņojuma piemērs ir sniegts kā ilustrācija. Avoti: Code review · Use Codex in GitHub.

Uzlabo koda kvalitāti ar AI apskatēm

Lielākajā daļā komandu koda apskate ir kļuvusi par piegādes cauruļvada „pudeles kaklu”: vilkšanas pieprasījumi (pull requests) krājas, jo kvalificēti apskatītāji ir aizņemti, rakstot kodu paši. Codex neaizstāj cilvēku apskatītājus; tas veic pirmo pārbaudi — atklāj acīmredzamas kļūdas, novirzes no esošās arhitektūras un netestētus robežgadījumus. Kad izstrādātājs beidzot atver PR, viņam vairs nav jānorāda uz trūkstošajiem kļūdu ceļu testiem; viņš var koncentrēties uz lēmumiem, kuriem nepieciešams biznesa vērtējums.

Veic apskati PR

GitHub vidē vistiešākais veids ir pieminēt Codex vilkšanas pieprasījuma komentārā: @codex review. Codex reaģē (👀) un pēc tam publicē savu apskati PR. Darbvirsmas lietotnē modulis Code Review parāda PR aprakstu, mainītos failus, komentārus un pārbaudes, ļaujot tev jautāt Codex par izmaiņām. Abos gadījumos ziņojuma kvalitāte ir atkarīga no pieprasījuma precizitātes: nosauc jomas, kas jāaptver.

"Apskati PR #142. Pārbaudi:
- Atbilstību esošajai arhitektūrai
- Iespējamos drošības jautājumus
- Testu pārklājumu
- TypeScript koda kvalitāti
- Neapstrādātus robežgadījumus"

Codex analizē atšķirības (diff), taču tas arī lasa modificēto failu kontekstu — ne tikai izmainītās rindas — un pēc tam sagatavo strukturētu ziņojumu. Lūk, piemērs tādam ziņojumam, ko vari sagaidīt PR, kas pievieno paziņojumu sistēmu:

## Apskate PR #142 — Paziņojumu sistēmas pievienošana

### Drošība
⚠️ src/api/routes/notifications.ts:34
  Parametrs userId nāk no pieprasījuma ķermeņa bez 
  validācijas. Lietotājs varētu sūtīt paziņojumus cita 
  vārdā. Izmanto req.user.id no autentifikācijas starpniekprogrammatūras.

### Arhitektūra
✅ Serviss ievēro to pašu modeli kā citi servisi
⚠️ Fails notification.service.ts jau ir 200 rindas garš.
  Apsver kanālu (e-pasts, webhook) atdalīšanu 
  atsevišķos failos.

### Testi
❌ Nav testa gadījumam, kad e-pasta serviss ir 
   nepieejams (noildze/tīkla kļūda)
⚠️ Testi imitē DB, bet ne e-pasta servisu

### Koda kvalitāte
💡 Funkcija sendBatch varētu izmantot Promise.allSettled 
   Promise.all vietā, lai izvairītos no kļūmes, ja viens 
   no 50 paziņojumiem neizdodas.

Pievērs uzmanību komentāru būtībai, nevis to formatējumam. Ievainojamība ar userId ir tieši tas, ko steigā esošs apskatītājs palaiž garām piektdienas vakarā: kods kompilējas, testi iziet, taču jebkurš lietotājs var rakstīt cita vārdā. Ieteikums izmantot Promise.allSettled atspoguļo izpratni par paredzamo uzvedību — sūtīšana partijā nedrīkst izgāzties tikai tāpēc, ka viena adrese no piecdesmit atsaka — nevis mehānisku stila noteikuma piemērošanu.

Mērķē apskates uz konkrētu domēnu

Vispārīgas apskates izkliedē uzmanību piecām tēmām vienlaicīgi. Sagatavojot sensitīvu ražošanas laidenu, tā vietā piepras specializētu pārbaudi šaurākā tvērumā. Drošības nolūkos uzvedne izskatās šādi:

"Drošības apskate failiem, kas modificēti 
src/api/ pēdējo 5 commitu laikā. Meklē:
- SQL injekcijas
- Iespējamo XSS
- Trūkstošu autentifikāciju
- Atklātus sensitīvus datus
- Nepārbaudītas atļaujas"

Codex pazīst biežākās ievainojamību shēmas un spēj tās pamanīt tavā kodā, pat ja tās ir paslēptas aiz pielāgota abstrakcijas slāņa. Tas pats princips attiecas uz veiktspēju, tikai šeit tu meklē pavisam citus simptomus — nevis kļūdu, bet vaicājumu, kas tiek izpildīts simt reižu, kad pietiktu ar vienu:

"Analizē src/services/report.service.ts veiktspēju.
Identificē:
- N+1 datubāzes vaicājumus
- Cilpas, ko varētu paralēlizēt
- Ielādētus, bet neizmantotus datus
- Aprēķinus, ko varētu kešot"

Automatizē apskates GitHub vidē

Kad prakse komandā ir iedibināta, padari to sistemātisku, nevis atkarīgu no individuālas atmiņas. Codex dokumentācija apraksta iestatīšanu šādi:

  1. Savieno savu GitHub repozitoriju ar Codex (tev ir nepieciešamas push vai administratora tiesības tā iestatījumos).
  2. Atver koda apskates iestatījumus.
  3. Izvēlies repozitoriju, pēc tam iespējo Automatic review sadaļā Review code.

Ikviens var arī iespējot automātisko apskati saviem PR personīgajās preferencēs un izvēlēties, kad tā tiek aktivizēta (Review trigger), bez nepieciešamības rakstīt @codex review. Šī mākoņa apskate neprasa Codex Cloud vides izveidi. Komentāri parādās tieši GitHub PR, tajā pašā vietā, kur cilvēku apskatītāju komentāri — detaļa, kas veicina pieņemšanu: piezīme, kas liek cilvēkiem atvērt citu rīku, netiks izlasīta. Pastāv arī GitLab sapludināšanas pieprasījumu (merge request) apskate, kas ir priekšskatījuma režīmā.

Pašapskate pirms PR atvēršanas

Labākais brīdis problēmas novēršanai ir pirms to redz kāds cits. No IDE vai CLI pašapskate neapstiprinātām izmaiņām aizņem sekundes un ietaupa tev pilnu apskates ciklu:

# No CLI, neinteraktīvi: apskati neapstiprinātās izmaiņas
codex review --uncommitted

# Vai apskati zaru pret main
codex review --base main

Interaktīvā sesijā komanda /review dara to pašu ar tavu darba koku; darbvirsmas lietotnē Code Review arī piedāvā apskatīt lokālās izmaiņas.

Izmēģini to savā nākamajā zarā pirms publicēšanas: tu atklāsi, ka puse komentāru, ko parasti saņem no kolēģiem, jau ir novērsti, un apskates saruna sākas interesantākā līmenī.

Nostiprini savus standartus failā AGENTS.md

Apskatei ir vērtība tikai tad, ja tā piemēro tavas komandas kritērijus, nevis kāda iedomāta projekta noteikumus. Codex meklē failus AGENTS.md repozitorijā un ievēro to apskates noteikumus: pievieno sadaļu ## Code Review Rules failam, kas atrodas vistuvāk attiecīgajam kodam, izmantojot apakšvirsrakstus ###, lai grupētu pārbaudes.

## Code Review Rules

### API
- Katram API maršrutam ir jāpārbauda autentifikācija
- Lietotāja dati ir jāvalidē ar Zod
- Nav TypeScript any (izmanto unknown + tipa sargu)
- Kļūdas ir jāreģistrē ar kontekstu
- Funkcijas, kas garākas par 50 rindām, ir jāsadala
- TODO komentāriem ir jābūt saistītiem ar biļeti

Codex piemēro šos standartus katrā apskatē ar tādu konsekvenci, kādu cilvēks apskatītājs nespēj uzturēt trīs simtu secīgu vilkšanas pieprasījumu garumā.

Galvenās atziņas

  • Codex veic pirmās kārtas apskati, lai filtrētu acīmredzamas problēmas
  • Apskates var būt specializētas: drošība, veiktspēja, arhitektūra
  • GitHub integrācija ļauj veikt automātiskas apskates katram PR
  • Izmanto apskati pirms PR izveides, lai ietaupītu laiku
  • Dokumentē savus standartus failā AGENTS.md, lai nodrošinātu konsekventas apskates