Премини към основното съдържание
Български— Изберете език
Меню

Автоматизиран преглед на код

Урок 11 от 20 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Подобряване на качеството на кода с AI прегледи
  2. Извършване на преглед на заявка за сливане (PR)
  3. Насочване на прегледите към конкретна област
  4. Автоматизиране на прегледите в GitHub
  5. Самопреглед преди отваряне на PR
  6. Задаване на Вашите стандарти в AGENTS.md
  7. Ключови изводи

Обновено на 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 описва настройката по следния начин:

  1. Свържете Вашето GitHub хранилище с Codex (трябва да имате права за push или администраторски права върху неговите настройки).
  2. Отворете настройките за преглед на код.
  3. Изберете хранилището, след което активирайте 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 за последователни прегледи