Automatizált kódellenőrzés
Ezen az oldalon
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 reviewemlítéssel vagy a beállításokban engedélyezett automatikus ellenőrzéssel indul; helyben acodex review --uncommittedvagy a/reviewparancsokkal 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:
- Kösd össze a GitHub tárolódat a Codexszel (ehhez push vagy admin jog szükséges a beállításokhoz).
- Nyisd meg a kódellenőrzési beállításokat.
- 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