AI ilə code review — nə tapır, nəyi tapmır
Agent code review-da faydalıdır, amma insan review-unu əvəz etmir — çünki hər ikisi fərqli səhv növlərini tutur.
Agent yaxşı tutur:
- Pattern pozuntuları: layihənin konvensiyalarına uyğun olmayan kod.
- Unudulmuş hallar: null yoxlaması, xəta idarəsi, boş kolleksiya.
- Mexaniki problemlər: resurs sızması, açıq qalan Cursor, close() çağırılmayan axın.
- Ardıcıllıq: eyni şeyin layihənin başqa yerində necə edildiyi.
- Həcm: 40 fayllıq PR-ı yorulmadan sona qədər oxuyur.
Agent zəif tutur: - Biznes məntiqinin doğruluğu — kod "düzgün" işləyir, amma tələb başqa idi. - Arxitektura qərarları — bu abstraksiya doğrudurmu, bu modul burada yerindədirmi. - Kontekstual risk — bu dəyişikliyin production-a təsiri, miqrasiya ehtiyacı. - Prioritet — hansı tapıntı bloklayıcıdır, hansı sonraya qala bilər.
| Review növü | Kim edir | Nəyi tutur |
|---|---|---|
| Avtomatik (lint, compile, test) | CI | Sintaksis, tip, məlum anti-pattern-lər, reqressiya |
| Agent review | Claude Code (lokal və ya CI) | Konvensiya pozuntuları, unudulmuş hallar, ardıcıllıq |
| İnsan review | Komanda yoldaşı | Biznes məntiqi, arxitektura, risk, prioritet |
Ən çox rast gəlinən səhv — agent review-unu insan review-unun əvəzi kimi qoymaqdır. Doğru quruluş: agent review insan review-dan əvvəl gəlir və mexaniki tapıntıları təmizləyir. Nəticədə insan review-u daha dəyərli suallara fokuslanır: "bu tələbi doğru başa düşmüsən?", "bu abstraksiya lazımdırmı?"
Praktiki qurulma variantları:
1. Lokal, PR açmazdan əvvəl — developer öz dəyişikliyini agentə review etdirir. Ən sürətli geribildirim, ən ucuz düzəliş.
2. CI-də, PR-a şərh kimi — hər PR üçün avtomatik review. Ardıcıllıq təmin edir, amma səs-küy riski var.
3. Skill kimi, tələb üzrə — /compose-review tipli, developer istədikdə.
Səs-küy riski ciddiyə alınmalıdır: agent hər PR-da 30 kiçik tapıntı verirsə, komanda onları oxumağı dayandırır və mexanizm ölür. Ona görə review skill-ində prioritet tələbi olmalıdır: "yalnız bloklayıcı və orta səviyyəli problemləri göstər; üslub qeydlərini yazma".
📚 Mənbələr və sənədlər
- Claude Code — code reviewrəsmicode.claude.com
- GitHub Actions inteqrasiyasırəsmicode.claude.com
PR-da avtomatik review və issue triage-ın qurulması.