Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Automatizált kódellenőrzés

11. lecke 20 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Javítsd a kódminőséget AI-alapú ellenőrzésekkel
  2. Ellenőrzés futtatása egy PR-en
  3. Ellenőrzések célzott szűkítése egy domainre
  4. Ellenőrzések automatizálása GitHubon
  5. Önellenőrzés a PR megnyitása előtt
  6. Állítsd be a szabványaidat az AGENTS.md fájlban
  7. Főbb megállapítások

Frissítve: 2026. november 3. a Codex dokumentációjának Code Review és Use Codex in GitHub oldalai, valamint a 0.166.0-s verziójú CLI súgó alapján: az ellenőrzés a @codex review említéssel vagy a beállításokban engedélyezett automatikus ellenőrzéssel indul; helyben a codex review --uncommitted vagy a /review parancsokkal indítható; az AGENTS.md szakasz címe ## Code Review Rules. A „Codex: Review Changes“ bővítményparancsot és a codex.openai.com URL-t eltávolítottuk, a jelentéspélda pedig illusztrációként szolgál. Források: Code review · Use Codex in GitHub.

Javítsd a kódminőséget AI-alapú ellenőrzésekkel

A legtöbb csapatnál a kódellenőrzés vált a szállítási folyamat szűk keresztmetszetévé: a pull requestek felhalmozódnak, mert a hozzáértő ellenőrök maguk is kódírással vannak elfoglalva. A Codex nem helyettesíti az emberi ellenőröket; az első kört végzi el – kiszűri a nyilvánvaló figyelmetlenségeket, a meglévő architektúrától való eltéréseket és a teszteletlen perem eseteket. Amikor a fejlesztő végül megnyitja a PR-t, már nem kell a hiányzó hibakezelési teszteket keresnie; a figyelmét azokra a döntésekre összpontosíthatja, amelyek üzleti megítélést igényelnek.

Ellenőrzés futtatása egy PR-en

GitHubon a legközvetlenebb módszer, ha említed a Codexet egy pull request megjegyzésben: @codex review. A Codex reagál (👀), majd közzéteszi az ellenőrzését a PR-ben. Az asztali alkalmazásban a Code Review modul megjeleníti a PR leírását, a módosított fájlokat, a megjegyzéseket és a ellenőrzéseket, így kérdezhetsz a Codextől a változásról. Mindkét esetben a jelentés minősége a kérés pontosságától függ: nevezd meg a lefedendő területeket.

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

A Codex elemzi a diffet, de elolvassa a módosított fájlok kontextusát is – nemcsak a megváltozott sorokat –, majd strukturált jelentést készít. Íme egy példa arra a típusú jelentésre, amit egy értesítéseket hozzáadó PR esetén várhatsz:

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

Figyeld a megjegyzések jellegét, ne a formázásukat. A userId sebezhetőség pontosan az, amit egy kapkodó ellenőr elmulaszt egy péntek este: a kód lefordul, a tesztek sikeresek, mégis bármelyik felhasználó írhat egy másik nevében. A Promise.allSettled javaslat az elvárt működés megértését tükrözi – egy kötegelt küldésnek nem szabad meghiúsulnia, mert ötven címből egy visszapattan –, nem pedig egy stílusszabály mechanikus alkalmazását.

Ellenőrzések célzott szűkítése egy domainre

Az általános ellenőrzések szétforgácsolják a figyelmet öt téma között egyszerre. Érzékeny élesítés előkészítésekor kérj specializált átvizsgálást egy szűkebb hatókörre. Biztonsági szempontból a prompt így néz ki:

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

A Codex ismeri a gyakori sebezhetőségi mintákat, és képes észrevenni őket a kódodban, még akkor is, ha egyedi absztrakciós réteg mögé vannak rejtve. Ugyanez az elv vonatkozik a teljesítményre is, csak itt egészen más tüneteket keresel – nem egy hibát, hanem egy lekérdezést, ami százszor fut le, amikor egyszer is elég lenne:

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

Ellenőrzések automatizálása GitHubon

Ha a gyakorlat meghonosodik a csapatnál, tedd rendszerré, ne az egyéni memóriától függjön. A Codex dokumentációja a következőképpen írja le a beállítást:

  1. Kösd össze a GitHub tárolódat a Codexszel (ehhez push vagy admin jog szükséges a beállításokhoz).
  2. Nyisd meg a kódellenőrzési beállításokat.
  3. Válaszd ki a tárolót, majd a Review code alatt engedélyezd az Automatic review lehetőséget.

Mindenki engedélyezheti az automatikus ellenőrzést a saját PR-jeihez a személyes beállításaiban, és kiválaszthatja, mikor induljon el (Review trigger), anélkül, hogy be kellene gépelnie a @codex review parancsot. Ehhez a felhőalapú ellenőrzéshez nem szükséges Codex Cloud környezetet létrehozni. A megjegyzések közvetlenül a GitHub PR-ben jelennek meg, ugyanott, ahol az emberi ellenőrök megjegyzései – ez a részlet hajtja el a terjedést: egy olyan észrevétel, ami miatt másik eszközt kell megnyitni, olvasatlan marad. GitLab merge request ellenőrzés is létezik, előzetes verzióban.

Önellenőrzés a PR megnyitása előtt

A legjobb időpont egy probléma javítására az, mielőtt bárki más látná. Az IDE-ből vagy a CLI-ből az el nem küldött változtatások önellenőrzése másodpercekbe telik, és megspórol egy teljes ellenőrzési kört:

# CLI-ből, nem interaktív mód: el nem küldött változások ellenőrzése
codex review --uncommitted

# Vagy egy branch ellenőrzése a mainhez képest
codex review --base main

Interaktív munkamenetben a /review parancs ugyanezt teszi a munkakönyvtáradon; az asztali alkalmazásban a Code Review szintén felajánlja a helyi változások ellenőrzését.

Próbáld ki a következő branch-eden pusholás előtt: rájössz, hogy a kollégáidtól általában kapott megjegyzések felét már kezelted, és az ellenőrzési beszélgetés egy érdekesebb szinten indul.

Állítsd be a szabványaidat az AGENTS.md fájlban

Egy ellenőrzés csak akkor értékes, ha a te csapatod kritériumait alkalmazza, nem pedig valami képzeletbeli projektét. A Codex keresi az AGENTS.md fájlokat a tárolóban, és követi azok ellenőrzési szabályait: adj hozzá egy ## Code Review Rules szakaszt a releváns kódhoz legközelebbi fájlhoz, ahol a ### alszakcímekkel csoportosítod az ellenőrzéseket.

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

A Codex ezeket a szabványokat alkalmazza minden ellenőrzésnél, olyan következetességgel, amit egyetlen emberi ellenőr sem tartana fenn háromszáz egymást követő pull request során.

Főbb megállapítások

  • A Codex egy első körös ellenőrzést végez a nyilvánvaló problémák szűrésére
  • Az ellenőrzések specializálhatók: biztonság, teljesítmény, architektúra
  • A GitHub integráció lehetővé teszi az automatikus ellenőrzést minden PR-en
  • Használd az ellenőrzést a PR létrehozása előtt az idő megtakarítása érdekében
  • Dokumentáld a szabványaidat az AGENTS.md fájlban a következetes ellenőrzésekért