Автоматизиран преглед на код
На тази страница
Обновено на 3 ноември 2026 г. въз основа на страниците Code Review и Use Codex in GitHub от документацията на Codex и помощта за CLI версия 0.166.0: прегледите се задействат чрез
@codex reviewили чрез активиране на автоматичен преглед в настройките, локално чрезcodex review --uncommittedили/review; секцията в AGENTS.md е озаглавена## Code Review Rules. Командата за разширение “Codex: Review Changes” и URL адресът codex.openai.com са премахнати, а примерът за отчет е представен като илюстрация. Източници: Code review · Use Codex in GitHub.
Подобряване на качеството на кода с AI прегледи
В повечето екипи прегледът на кода се превърна в тясно място в процеса на доставка: заявките за сливане (pull requests) се натрупват, защото опитните рецензенти са заети да пишат код сами. Codex не замества човешките рецензенти; той извършва първия преглед – откривайки очевидни пропуски, отклонения от съществуващата архитектура и нетествани крайни случаи. Когато разработчикът най-накрая отвори заявката за сливане, той вече не трябва да сигнализира за липсващи тестове за пътеките на грешки; може да насочи вниманието си към решения, изискващи бизнес преценка.
Извършване на преглед на заявка за сливане (PR)
В GitHub най-директният подход е да споменете Codex в коментар към заявката за сливане: @codex review. Codex реагира (👀) и след това публикува своя преглед в PR. В десктоп приложението модулът Code Review показва описанието на PR, променените файлове, коментарите и проверките, позволявайки Ви да задавате въпроси на Codex относно промяната. И в двата случая качеството на отчета зависи от точността на заявката: посочете областите, които трябва да бъдат обхванати.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
Codex анализира разликите (diff), но също така чете контекста на модифицираните файлове – не само променените редове – и след това предоставя структуриран отчет. Ето пример за вида отчет, който можете да очаквате за PR, добавящ система за известия:
## 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.
Обърнете внимание на същността на коментарите, а не на тяхното форматиране. Уязвимостта на userId е точно това, което един бързащ рецензент пропуска в петък вечер: кодът се компилира, тестовете минават, но всеки потребител може да пише от името на друг. Предложението за Promise.allSettled отразява разбиране за очакваното поведение – пакетното изпращане не трябва да се проваля, защото един адрес от петдесет се върне – а не механично прилагане на правило за стил.
Насочване на прегледите към конкретна област
Общите прегледи разпръскват вниманието върху пет теми едновременно. Когато подготвяте чувствително производствено издание, поискайте специализиран преглед с по-тесен обхват. За сигурност подканата изглежда така:
"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 познава общите модели на уязвимости и може да ги открие във Вашия код, дори когато са скрити зад слой от персонализирани абстракции. Същият принцип важи и за производителността, с тази разлика, че търсите съвсем различни симптоми – не дефект, а заявка, която се изпълнява сто пъти, когато една би била достатъчна:
"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"
Автоматизиране на прегледите в GitHub
След като практиката се утвърди в екипа, направете я системна, вместо да зависи от индивидуалната памет. Документацията на Codex описва настройката по следния начин:
- Свържете Вашето GitHub хранилище с Codex (трябва да имате права за push или администраторски права върху неговите настройки).
- Отворете настройките за преглед на код.
- Изберете хранилището, след което активирайте Automatic review под Review code.
Всеки може също да активира автоматичен преглед за собствените си PR в личните си предпочитания и да избере кога да се задейства (Review trigger), без да се налага да въвеждате @codex review. Този облачен преглед не изисква създаване на Codex Cloud среда. Коментарите се появяват директно в GitHub PR, на същото място като коментарите на човешките рецензенти – детайл, който стимулира внедряването: забележка, която принуждава хората да отварят друг инструмент, няма да бъде прочетена. Прегледът на заявките за сливане (merge request) в GitLab също съществува, но е в предварителен преглед.
Самопреглед преди отваряне на PR
Най-подходящото време за отстраняване на проблем е преди някой друг да го види. От IDE или CLI, самопреглед на непроменените (uncommitted) промени отнема секунди и Ви спестява цял цикъл на преглед:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
В интерактивна сесия командата /review прави същото нещо върху Вашето работно дърво; в десктоп приложението Code Review също предлага преглед на локалните промени.
Изпробвайте го във Вашата следваща ветка преди публикуване: ще откриете, че половината от коментарите, които обикновено получавате от колегите си, вече са адресирани, а разговорът за прегледа започва на по-интересно ниво.
Задаване на Вашите стандарти в AGENTS.md
Един преглед има стойност само ако прилага критериите на Вашия екип, а не тези на някакъв въображаем проект. Codex търси файлове AGENTS.md в хранилището и следва техните правила за преглед: добавете секция ## Code Review Rules към файла, най-близък до съответния код, с подзаглавия ### за групиране на проверките.
## 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 прилага тези стандарти към всеки преглед с постоянство, което никой човешки рецензент не може да поддържа през триста последователни заявки за сливане.
Ключови изводи
- Codex извършва преглед от първи ред, за да филтрира очевидните проблеми
- Прегледите могат да бъдат специализирани: сигурност, производителност, архитектура
- Интеграцията с GitHub позволява автоматични прегледи за всяка PR
- Използвайте прегледа преди създаването на PR, за да спестите време
- Документирайте Вашите стандарти в AGENTS.md за последователни прегледи