Kod rəyini agent vasitəsilə necə aparmaq olar

Alış-veriş siyahısı olan bir səhifə təsəvvür edin: açılır, maddələr əlavə olunur, düymələr qaydasında görünür. Amma hazır ekran hələ kodda hər şeyin düşünüldüyünü demir. Proqramçılar gözdən qaçmış xətaları tapmaq və həlləri müzakirə etmək üçün kodu ayrıca nəzərdən keçirirlər. Bu işi agentə tapşırmaq olar və o, bunun öhdəsindən yaxşı gələcək. Sadəcə ona tapşırığı izah etmək lazımdır.

1. Komandada kodu necə yoxlayırlar

Kiçik bir komandada proqramçıya tapşırıq verilib: qeydlər əlavə etmək və onları bir-bir silmək mümkün olan alış-veriş siyahısı hazırlamaq. O, kodu yazdı, çörək və süd əlavə etməyi yoxladı, çörəyi sildi. Hər şey alındı. İşi növbəti mərhələyə ötürməzdən əvvəl proqramçı dəyişikliklərini bir daha oxudu: unudulmuş parçanı sildi, anlaşılmaz adı düzəltdi. Bu, özünü yoxlamadır.

Sonra o, həmkarından koda baxmağı xahiş etdi. Həmkar proqramlaşdırma dilini bilir və əlavə etmənin necə qurulduğunu, proqramın silinəcək qeydi necə seçdiyini, siyahının qalan hissəsi ilə nə baş verdiyini oxuyur. Belə baxışa kod rəyi, yaxud code review deyilir, yoxlayana isə rəyçi deyirlər.

Həmkar fərqinə varır: proqram silinəcək alış-verişi adına görə seçir. Siyahıda iki "Süd" qeydi olsa, birinə basmaq hər ikisini silə bilər. Müəllif çörəyi və südü yoxlamışdı. Belə hal sadəcə onun qarşısına çıxmamışdı.

Rəyçi müvafiq kod hissəsinin yanında şərh yazır: "İndi bu adda olan bütün alış-verişlər silinir. Eyni qeydlərə icazə veririkmi? Əgər bəli, yalnız seçiləni silmək lazımdır". Müəllif tələbi dəqiqləşdirir: eyni qeydlərə icazə verilir, axı onları müxtəlif adamlar üçün əlavə edə bilərdilər. Müzakirədən sonra o, qeydin seçilmə üsulunu dəyişir. Həmkar düzəlişə bir daha baxır və şərhin nəzərə alındığına əmin olur.

Sxemdə şərhli rəyin gedişi göstərilib: kod müəllifdən həmkara keçir, sonra düzəliş üçün geri qayıdır. Təkrar baxışdan sonra suallar qalırsa, müzakirə və düzəlişlər təkrarlanır. Ciddi şərh qalmayanda həmkar dəyişikliyi təsdiqləyir.

Adi iş dövrü belədir: yazdı, göstərdi, şərh aldı, müzakirə etdi, düzəltdi. Bəzən şərh bir neçə olur, bəzən heç olmur. Elə də olur ki, müəllif həllini izah edir, həmkar isə sualını geri götürür. Rəy hər şərhlə razılaşmağı tələb etmir.

Belə baxışda kodun aydınlığı da müzakirə olunur: növbəti proqramçı onu başa düşə biləcəkmi, bir qaydanı bir neçə yerdə dəyişmək lazım gəlmirmi. Həmkar eyni zamanda proqramın yeni hissəsinin necə qurulduğunu öyrənir. Layihə haqqında bilik tədricən insanlar arasında paylanır, yalnız müəllifdə qalmır.

Burada rəyi testləşdirmə ilə qarışdırmaq asandır. İnsan iki alış-veriş əlavə edib düyməni basanda işləyən proqramın davranışını yoxlayır. Silmə kodunu oxuyub onun hansı qeydləri seçəcəyini araşdıranda isə rəy aparır. Rəy zamanı ehtimalı yoxlamaq üçün proqramı işə salmaq da olar. Bu üsullar bir-birini tamamlayır.

2. Rəyi agentə necə tapşırmaq olar

İndi təsəvvür edin ki, alış-veriş siyahısını Claude Code sizin təsvirinizə görə yazıb. Siz səhifədə nə baş verməli olduğunu izah edə bilirsiniz, amma onun proqram məntiqini oxuya bilmirsiniz. Rəyin texniki hissəsini də agentə ötürmək olar: o, faylları oxuyacaq və şərhləri sadə sözlərlə izah edəcək.

Komanda hekayəsindəki rollar qalır. Kodun müəllifi var, bir də ayrıca tapşırıq verilmiş yoxlayan var. Claude Code-da bunun üçün subagent istifadə etmək olar: əsas agentin konkret işi tapşırdığı köməkçi. Bizim halda o, kodu oxuyur və şərhləri qaytarır.

Müəllifdən öz işini bir daha yoxlamağı xahiş etmək də faydalıdır. Ayrıca rəyçi isə başqa baxış bucağı gətirir: onun tapşırığı nəticəni qiymətləndirməkdir. Ona tələbləri verin ki, hansı həllərin məqbul olduğunu başa düşsün. Məsələn, eyni alış-verişləri qadağan etmək silmə problemini formal olaraq aradan qaldırar, amma səhifənin nəzərdə tutulmuş davranışını dəyişər.

Claude Code-un rəy üzrə tövsiyələrində ayrıca yoxlayan və aydın meyarlar təklif olunur. Orada həm də işin düzgünlüyünə və tələblərə təsir edən şərhlərə diqqət yetirməyi məsləhət görürlər. Bunu layihənin kiçik bir hissəsinə tətbiq edək.

Rəyi təşkil etmək üçün sizdən az şey tələb olunur: istədiyiniz davranışı təsvir etmək və hansı təsdiqlənmiş problemlərin düzəldiləcəyini seçmək. Proqram məntiqini oxumağı, səbəbi axtarmağı və texniki etirazları araşdırmağı agentlərə tapşırmaq olar.

Sxemdə üç rol var: siz tələbləri müəyyən edir və düzəlişləri seçirsiniz, əsas agent işi təşkil edir və kodu düzəldir, yoxlayanlar kodu və şərhləri öyrənir. Əsas agent onlara lazımi materialları ötürür və nəticələri sizə qaytarır. Təsdiqlənmiş problem yoxdursa, düzəliş addımları buraxılır. Aşağıda bu ardıcıllığı üç sorğu ilə yerinə yetirəcəyik.

Sonda əlinizdə problemin aydın izahı, onun təkrar yoxlanmasının nəticəsi və düzəliş haqqında hesabat olur. Şərh səhv çıxsa belə, faydalı nəticə var: siz lazımsız düzəlişdən yayındınız.

Belə baxışlar üçün daimi köməkçi qurmaq istəyirsinizsə, subagentin yaradılması və işə salınması haqqında material faydalı olacaq. Ona daha ətraflı tapşırığı necə hazırlamaq brif və nəticə formatı haqqında məqalədə izah olunub.

Sorğu 1. Yazılmış kodu yoxlamaq

Claude Code-u layihə qovluğunda işə salın. Növbəti üç sorğunu əsas sessiyaya göndərin: əsas agent işi köməkçilərə özü ötürür. Burada və bundan sonra tədris məqsədli alış-veriş siyahısından istifadə edirik; öz layihəniz üçün davranış təsvirini dəyişin.

Cari layihədəki alış-veriş siyahısı kodunun rəyini ayrıca subagentə tapşır.
Qeydlərin əlavə edilməsini və silinməsini yoxla.
Tələblər: eyni adlara icazə verilir; yalnız seçilmiş qeyd silinir;
boş alış-veriş əlavə etmək olmaz.

Cari kodu və layihənin onunla bağlı hissələrini oxu.
Bu tələbləri pozan xətaları axtar.
Kodu dəyişmə. Yeni imkanlar əlavə etmə.
Hər şərh üçün sadə sözlərlə izah et:
nə səhv gedə bilər, hansı hərəkətdə və niyə belə qərara gəldin.
Başqa agentin sonrakı yoxlaması üçün koddakı yeri göstər.
Problem tapılmasa, elə də yaz. Nəyin yoxlandığını
və nəyin məlum olmadığını sadala. Hesabatı REVIEW_REPORT.md faylına yaz.
Mən proqramlaşdırma dilini bilmirəm: nəticəni kod oxumağı tələb etmədən izah et.

REVIEW_REPORT.md faylı adi mətn hesabatı olacaq. Adı özümüz seçdik, istənilən başqa ad da uyğundur: o, növbəti sorğuda hansı şərhlərin təkrar yoxlanacağı aydın olsun deyə lazımdır. "Kodu dəyişmə" tələbi baxışı düzəlişdən ayırır; hesabatın yazılmasına isə icazə var.

Bizim nümunədə faydalı cavab belə səslənə bilərdi: "Eyni adlı iki alış-veriş əlavə etsəniz, birini silmək hər ikisini siləcək. Kod qeydləri adına görə seçir, ona görə də hər iki uyğunluğa təsir edir". Bu, cavabın tədris nümunəsidir, sizin layihənizin yoxlanma nəticəsi deyil.

Nəticə sizə aydındır: insan saxlamaq istədiyi qeydi itirəcək. Fayl adı və koddakı yer növbəti agentə səbəbi tapmaq üçün lazımdır. Bu hissəni özünüz araşdırmalı deyilsiniz.

3. Şərhləri necə təkrar yoxlamaq olar

Rəyçi agent də səhv edir. Məsələn, o yazır: "Siyahıya boş alış-veriş əlavə etmək olar". İnandırıcı səslənir. Amma boş girişin yoxlanması proqramın onun oxumadığı başqa hissəsində artıq var. Şərh mövcud olmayan problemi təsvir edir.

Belə əminliklə deyilmiş, amma uydurulmuş iddiaya çox vaxt süni intellektin hallüsinasiyası deyirlər. Rəydə o xüsusilə narahatlıq yaradır: agent düzəliş təklif edə bilər, siz isə artıq düzgün işləyən kodu dəyişməyə vaxt itirəcəksiniz. Ona görə də yazıldıqdan sonra həm kodun özünü, həm də ona dair şərhləri təkrar yoxlamaq faydalıdır.

İlk addımı artıq atmışıq: müəllifin işinə baxmağı tapşırmışıq. İndi hesabatı cari layihə ilə birlikdə başqa yoxlayana verəcəyik. Onun tapşırığı: hər şərhin təsdiqlənib-təsdiqlənmədiyini aydınlaşdırmaq. Birinci rəyçi ilə razılaşmamağa onun icazəsi var.

Sorğu 2. Rəyçinin hesabatını yoxlamaq

REVIEW_REPORT.md faylını layihənin cari koduna və əvvəlki
sorğudakı tələblərə görə təkrar yoxlamağı başqa subagentə tapşır.
Bu tələbləri ona açıq şəkildə ötür.

Hər şərh üzrə təsvir olunan problemin həqiqətən olub-olmadığını aydınlaşdır.
Kodun əlaqəli hissələrini yoxla: bəlkə lazımi emal artıq var.
Birinci hesabatı sübut hesab etmə. Nəticə üçün işə salmaqla
yoxlama lazımdırsa, onu mövcud vasitələrlə yerinə yetir.
Layihənin kodunu dəyişmə.

Hər bənd üçün göstər: təsdiqlənib, təkzib olunub
və ya hələlik müəyyən etmək alınmayıb. Əsası sadə dillə izah et.
Kodu oxumaqdan çıxan nəticələri və aparılmış yoxlamaların nəticələrini ayır.
Aparılmamış yoxlamanı aparılmış kimi göstərmə.
Nəticəni REVIEW_CHECK.md faylına yaz və mənə qısaca izah et.

Bundan sonra əlinizdə təkrar yoxlamanın nəticəsi olan REVIEW_CHECK.md faylı olacaq. Bizim tədris nümunəmizdə ikinci agent eyni adlar problemini təsdiqləyə, boş giriş haqqında şərhi isə təkzib edə bilər: "Boş sətir qeyd əlavə olunmazdan əvvəl rədd edilir. Birinci rəyçi bu yoxlamanı gözdən qaçırıb".

Bu, növbəti addımı seçməyə artıq kömək edir. Silmə problemini düzəlişə vermək olar. Boş girişi bu şərhə görə dəyişmək lazım deyil. Agent "hələlik müəyyən etmək alınmayıb" yazırsa, ona hansı məlumatın çatmadığını izah etməsini xahiş edin. Bəzən bu, sizə ünvanlanmış sualdır: məsələn, eyni qeydlər bir alış-veriş sayılmalıdır, yoxsa iki.

Təkrar yoxlama uydurulmuş şərhləri süzgəcdən keçirməyə kömək edir, amma onların tam yox olmasına zəmanət vermir. İki agent eyni səhvi təkrarlaya bilər. Ona görə də cavabda əsaslar lazımdır: yoxlayan layihədə konkret nə tapdı və ya işə salanda hansı nəticə aldı. Təkcə "əvvəlki agentlə razıyam" azdır.

4. Düzəliş və təkrar rəy

İndi nəyi düzəldəcəyinizi seçin. Bunun üçün problemin səhifənin nəzərdə tutulmuş işinə təsirini başa düşmək kifayətdir. Bizim nümunədə artıq alış-verişin silinməsi açıq-aydın mane olur, ona görə də bu bəndi götürürük. Çeşidləmə əlavə etmək təklifini sonraya saxlamaq olar. silmənin düzəldilməsinə onsuz da aidiyyəti yoxdur.

Seçilmiş şərhi agentə tam şəkildə ötürün ki, "birinci xətanı düzəlt" dedikdə nəyi nəzərdə tutduğunuzu təxmin etməli olmasın. Dəyişiklikdən sonra nəticəni yenidən yoxlamağı xahiş edin. Bu, komanda hekayəsinin davamıdır: həmkar artıq düzəldilmiş versiyaya baxır.

Sorğu 3. Düzəltmək və nəticəni yoxlamaq

REVIEW_CHECK.md faylındakı təsdiqlənmiş problemi düzəlt:
bir alış-verişi siləndə eyni adlı bütün qeydlər yox olur.
Yalnız seçilmiş qeyd silinməlidir. Eyni adlara icazə verilir.
Rəydəki digər təklifləri hələlik tətbiq etmə.

Düzəlişdən sonra mövcud vasitələrlə alış-verişlərin əlavə edilməsini
və silinməsini yoxla, o cümlədən eyni adlı iki alış-verişi.
Sonra düzəldilmiş kodun təkrar rəyini ayrıca subagentə tapşır:
səbəb aradan qalxıbmı və əlavə etmə ilə silmənin işi pozulmayıbmı.
Ona ilkin tələbləri və düzəldilən problemin təsvirini ötür.

Mənə sadə sözlərlə izah et: nə dəyişdi, hansı yoxlamalar
aparıldı və təkrar rəy nə göstərdi.
Nəyisə yoxlamaq alınmadısa, bunu ayrıca qeyd et.
Tapşırığı yeni təkmilləşdirmələrlə genişləndirmə.

Öz layihəniz üçün alış-verişlər haqqındakı abzası öz hesabatınızdakı təsdiqlənmiş şərhlə əvəz edin. Ardıcıllığın qalan hissəsini saxlamaq olar: düzəliş, yoxlama, nəticəyə ayrıca baxış.

Yaxşı yekun konkret bir şey bildirir: "İndi hər qeyd ayrıca silinir. İki eyni adla yoxlama ikinci qeydi yerində saxladı. Təkrar rəy xətanın əvvəlki səbəbini tapmadı". Belə yazmaq yalnız müvafiq yoxlamalardan sonra olar. Agent yalnız kodu oxuyubsa, bunu qeyd etməlidir.

Siz də səhifəni açıb tanış hərəkətləri sınaya bilərsiniz. Bunun üçün dil bilmək lazım deyil. Bu, görünən nəticənin əlavə yoxlamasıdır; düzəlişin texniki rəyini yenə də agent aparır. İşə salmaq üçün onun imkanları çatmayıbsa, hesabatda "hər şey mütləq işləyir" vədi yox, aydın bir məhdudiyyət qalacaq.

Hər keçidi sonsuz təkmilləşdirməyə çevirmək vacib deyil. Seçilmiş problem aradan qalxıbsa, yoxlanıbsa və təkrar baxış əlaqəli xətalar aşkar etməyibsə, bu tapşırığı bitirmək olar. Vəssalam. Yeni istəklər ayrıca müzakirəyə layiqdir.