Salt la conținutul principal
Română— Alege o limbă
Meniu

Revizuire automată a codului

Lecția 11 din 20 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Îmbunătățiți calitatea codului cu revizuiri AI
  2. Executarea unei revizuiri pentru un PR
  3. Targetarea revizuirilor pe un domeniu specific
  4. Automatizarea revizuirilor în GitHub
  5. Auto-revizuire înainte de deschiderea PR-ului
  6. Stabiliți-vă standardele în AGENTS.md
  7. Puncte cheie

Actualizat la 3 noiembrie 2026 pe baza paginilor Code Review și Use Codex in GitHub din documentația Codex și a ajutorului pentru CLI versiunea 0.166.0: revizuirile se declanșează prin @codex review sau prin activarea revizuirii automate în setări, local prin codex review --uncommitted sau /review; secțiunea AGENTS.md este intitulată ## Code Review Rules. Comanda de extensie „Codex: Review Changes“ și URL-ul codex.openai.com au fost eliminate, iar exemplul de raport este prezentat ca o ilustrare. Surse: Code review · Use Codex in GitHub.

Îmbunătățiți calitatea codului cu revizuiri AI

În majoritatea echipelor, revizuirea codului a devenit gâtul de sticlă al fluxului de livrare: cererile de extragere (pull requests) se acumulează deoarece revizuitorii calificați sunt ocupați să scrie ei înșiși cod. Codex nu înlocuiește revizuitorii umani; acesta gestionează prima trecere – identificând scăpările evidente, abaterile de la arhitectura existentă și cazurile limită netestate. Când un dezvoltator deschide în final cererea de extragere (PR), nu mai trebuie să semnaleze lipsa testelor pentru căile de eroare; își poate concentra atenția asupra deciziilor care necesită judecată de afaceri.

Executarea unei revizuiri pentru un PR

Pe GitHub, cea mai directă abordare este menționarea lui Codex într-un comentariu al cererii de extragere: @codex review. Codex reacționează (👀), apoi postează revizuirea sa în PR. În aplicația desktop, modulul Code Review afișează descrierea PR, fișierele modificate, comentariile și verificările, permițându-vă să interogați Codex cu privire la modificare. În ambele cazuri, calitatea raportului depinde de precizia solicitării: numiți zonele care trebuie acoperite.

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

Codex analizează diferențele (diff), dar citește și contextul fișierelor modificate – nu doar liniile schimbate – livrând apoi un raport structurat. Iată un exemplu de raport pe care l-ați putea primi pentru un PR care adaugă un sistem de notificări:

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

Acordați atenție naturii comentariilor, nu formatării lor. Vulnerabilitatea userId este exact ceea ce un revizuitor grăbit ratează într-o vineri seara: codul se compilează, testele trec, totuși orice utilizator poate scrie în numele altuia. Sugestia Promise.allSettled reflectă o înțelegere a comportamentului așteptat – o trimitere în lot nu ar trebui să eșueze deoarece o singură adresă din cincizeci este invalidă – și nu o aplicare mecanică a unei reguli de stil.

Targetarea revizuirilor pe un domeniu specific

Revizuirile generale diluează atenția asupra a cinci subiecte simultan. Atunci când pregătiți o lansare sensibilă în producție, solicitați în schimb o trecere specializată pe un scop restrâns. Pentru securitate, promptul arată astfel:

"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 cunoaște tiparele comune de vulnerabilitate și le poate identifica în codul dumneavoastră, chiar și atunci când sunt ascunse în spatele unui strat de abstractizare personalizat. Același principiu se aplică performanței, doar că vânați simptome foarte diferite – nu o defecțiune, ci o interogare care rulează de o sută de ori când una ar fi suficientă:

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

Automatizarea revizuirilor în GitHub

Odată ce practica este stabilită în echipă, faceți-o sistematică, nu dependentă de memoria individuală. Documentația Codex descrie configurarea după cum urmează:

  1. Conectați repository-ul GitHub la Codex (aveți nevoie de drepturi de push sau de administrator asupra setărilor acestuia).
  2. Deschideți setările de revizuire a codului.
  3. Selectați repository-ul, apoi activați Automatic review sub Review code.

Toată lumea poate activa, de asemenea, revizuirea automată pentru propriile PR-uri în preferințele personale și poate alege când se declanșează (Review trigger), fără a fi nevoie să tasteze @codex review. Această revizuire în cloud nu necesită crearea unui mediu Codex Cloud. Comentariile apar direct în PR-ul GitHub, în același loc ca și comentariile revizuitorilor umani – un detaliu care favorizează adoptarea: o remarcă care obligă oamenii să deschidă un alt instrument nu va fi citită. Revizuirea cererilor de îmbinare (merge request) GitLab există, de asemenea, în versiune preview.

Auto-revizuire înainte de deschiderea PR-ului

Cel mai bun moment pentru a remedia o problemă este înainte ca altcineva să o vadă. Din IDE sau CLI, o auto-revizuire a modificărilor neconfirmate durează câteva secunde și vă scutește de o rundă completă de revizuire:

# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted

# Or review a branch against main
codex review --base main

Într-o sesiune interactivă, comanda /review face același lucru asupra arborelui de lucru; în aplicația desktop, Code Review oferă, de asemenea, opțiunea de a revizui modificările locale.

Încercați acest lucru pe următoarea ramură înainte de a face push: veți constata că jumătate din comentariile pe care le primiți de obicei de la colegi sunt deja abordate, iar conversația de revizuire începe la un nivel mai interesant.

Stabiliți-vă standardele în AGENTS.md

O revizuire are valoare doar dacă aplică criteriile echipei dumneavoastră, nu ale unui proiect imaginar. Codex caută fișiere AGENTS.md în repository și urmează regulile lor de revizuire: adăugați o secțiune ## Code Review Rules în fișierul cel mai apropiat de codul relevant, cu subtitluri ### pentru a grupa verificările.

## 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 aplică aceste standarde la fiecare revizuire, cu o consistență pe care niciun revizuitor uman nu o menține pe parcursul a trei sute de cereri de extragere consecutive.

Puncte cheie

  • Codex efectuează o revizuire de primă instanță pentru a filtra problemele evidente
  • Revizuirile pot fi specializate: securitate, performanță, arhitectură
  • Integrarea GitHub permite revizuiri automate la fiecare PR
  • Utilizați revizuirea înainte de a crea PR-ul pentru a economisi timp
  • Documentați-vă standardele în AGENTS.md pentru revizuiri consistente