Ako robiť code review cez agenta

Predstavte si stránku so zoznamom nákupov: otvára sa, položky pribúdajú, tlačidlá vyzerajú normálne. No hotová obrazovka ešte neznamená, že je v kóde všetko premyslené. Vývojári si preto kód osobitne prezerajú, aby našli prehliadnuté chyby a prediskutovali riešenia. Túto prácu môžete zveriť agentovi a zvládne ju výborne. Treba mu len vysvetliť úlohu.

1. Ako sa kód kontroluje v tíme

V malom tíme dostal vývojár úlohu: vytvoriť zoznam nákupov, do ktorého sa dajú pridávať položky a odstraňovať ich po jednej. Napísal kód, skúsil pridať chlieb a mlieko, odstránil chlieb. Všetko fungovalo. Predtým ako odovzdal prácu ďalej, si ešte raz prečítal svoje zmeny: odstránil zabudnutý kus kódu, opravil nezrozumiteľný názov. To je samokontrola.

Potom poprosil kolegu, aby sa na kód pozrel. Kolega pozná programovací jazyk a číta, ako funguje pridávanie, ako program vyberá záznam na odstránenie a čo sa stane so zvyškom zoznamu. Takémuto prezeraniu sa hovorí code review alebo revízia kódu a tomu, kto kontroluje, recenzent.

Kolega si všimne: program vyberá položku na odstránenie podľa názvu. Ak budú v zozname dva záznamy "Mlieko", kliknutie na jeden môže vymazať oba. Autor skúšal chlieb a mlieko. Na taký prípad jednoducho nenarazil.

Recenzent nechá komentár pri príslušnom úseku kódu: "Teraz sa odstraňujú všetky položky s týmto názvom. Povoľujeme rovnaké záznamy? Ak áno, treba odstrániť len vybraný". Autor spresní požiadavku: rovnaké záznamy sú povolené, veď ich mohli pridať pre rôznych ľudí. Po diskusii zmení spôsob výberu záznamu. Kolega sa na opravu pozrie ešte raz a presvedčí sa, že pripomienka je zapracovaná.

Schéma ukazuje priebeh review s pripomienkami: kód ide od autora ku kolegovi a potom sa vracia na opravu. Ak po opätovnom prezretí zostávajú otázky, diskusia a opravy sa opakujú. Keď už podstatné pripomienky nie sú, kolega zmenu schváli.

Toto je bežný pracovný cyklus: napísal, ukázal, dostal pripomienku, prediskutoval, opravil. Niekedy je pripomienok viac, niekedy žiadne. Stáva sa aj to, že autor svoje riešenie vysvetlí a kolega otázku stiahne. Review nevyžaduje súhlasiť s každým komentárom.

Pri takom prezeraní sa rieši aj zrozumiteľnosť kódu: vyzná sa v ňom ďalší vývojár, nemusí sa jedno pravidlo meniť na viacerých miestach? Kolega sa popritom dozvie, ako je nová časť programu usporiadaná. Znalosti o projekte sa tak postupne rozdeľujú medzi ľudí a nezostávajú len u autora.

Tu sa dá review ľahko zameniť s testovaním. Keď človek pridá dve položky a stlačí tlačidlo, overuje správanie bežiaceho programu. Keď číta kód odstraňovania a zisťuje, ktoré záznamy vyberie, robí review. Počas review sa dá program aj spustiť a overiť si domnienku. Tieto spôsoby sa navzájom dopĺňajú.

2. Ako delegovať review agentovi

Teraz si predstavte, že zoznam nákupov napísal Claude Code podľa vášho opisu. Viete vysvetliť, čo sa má na stránke diať, ale jej programovú logiku si prečítať neviete. Aj technickú časť review môžete zveriť agentovi: prečíta súbory a pripomienky vysvetlí bežnými slovami.

Roly z príbehu tímu zostávajú. Je tu autor kódu a je tu recenzent, ktorý dostal samostatnú úlohu. V Claude Code na to môžete použiť subagenta: pomocníka, ktorému hlavný agent zverí konkrétnu prácu. V našom prípade číta kód a vracia pripomienky.

Požiadať autora, aby svoju prácu ešte raz skontroloval, je tiež užitočné. Samostatný recenzent však prináša iný pohľad: jeho úlohou je výsledok posúdiť. Odovzdajte mu požiadavky, aby vedel, aké riešenia sú prípustné. Napríklad zákaz rovnakých položiek by problém s odstraňovaním formálne odstránil, ale zmenil by zamýšľané správanie stránky.

Odporúčania Claude Code k review navrhujú samostatného recenzenta a jasné kritériá. Radia tiež sústrediť sa na pripomienky, ktoré ovplyvňujú správnosť fungovania a splnenie požiadaviek. Použime to na malej časti projektu.

Na zorganizovanie review od vás stačí málo: opísať želané správanie a vybrať, ktoré potvrdené problémy opraviť. Čítanie programovej logiky, hľadanie príčiny a rozbor technických námietok môžete zveriť agentom.

Na schéme sú tri roly: vy zadávate požiadavky a vyberáte opravy, hlavný agent organizuje prácu a opravuje kód, recenzenti skúmajú kód a pripomienky. Hlavný agent im odovzdáva potrebné podklady a vám vracia výsledky. Ak potvrdené problémy nie sú, kroky opravy sa preskočia. Nižšie tento postup prejdeme tromi promptmi.

Výsledkom je zrozumiteľné vysvetlenie problému, výsledok jeho overenia a správa o oprave. A ak sa pripomienka ukáže ako chybná, aj to je užitočný výsledok: vyhli ste sa zbytočnej úprave.

Ak si chcete nastaviť stáleho pomocníka na takéto kontroly, poslúži vám článok o vytvorení a spustení subagenta. Ako mu pripraviť podrobnejšie zadanie, rozoberá článok o briefe a formáte výsledku.

Prompt 1. Skontrolovať napísaný kód

Spustite Claude Code v priečinku projektu. Nasledujúce tri prompty posielajte do hlavnej relácie: hlavný agent sám odovzdá prácu pomocníkom. Tu aj ďalej používame cvičný zoznam nákupov; pre vlastný projekt nahraďte opis správania.

Zver samostatnému subagentovi review kódu zoznamu nákupov
v aktuálnom projekte. Nech skontroluje pridávanie a odstraňovanie záznamov.
Požiadavky: rovnaké názvy sú povolené; odstraňuje sa iba
vybraný záznam; prázdnu položku pridať nemožno.

Prečítaj aktuálny kód a časti projektu, ktoré s ním súvisia.
Hľadaj chyby, ktoré tieto požiadavky porušujú.
Kód nemeň. Nepridávaj nové funkcie.
Pri každej pripomienke vysvetli jednoduchými slovami:
čo sa môže pokaziť, pri akej akcii a prečo si to myslíš.
Uveď miesto v kóde, aby ho mohol overiť ďalší agent.
Ak sa problémy nenašli, tak to napíš. Vymenuj, čo bolo skontrolované
a čo zostalo neznáme. Správu ulož do REVIEW_REPORT.md.
Nepoznám programovací jazyk: vysvetli výsledok tak, aby som nemusel čítať kód.

Súbor REVIEW_REPORT.md bude obyčajná textová správa. Názov sme zvolili sami, poslúži aj akýkoľvek iný: potrebujeme ho, aby bolo v ďalšom prompte jasné, ktoré pripomienky overiť. Pokyn "kód nemeň" oddeľuje prezeranie od opravy; zapísať správu pritom dovolené je.

Užitočná odpoveď by v našom príklade mohla znieť takto: "Ak pridáte dve položky s rovnakým názvom, odstránenie jednej odstráni obe. Kód vyberá záznamy podľa názvu, preto zasiahne obe zhody". Je to cvičný príklad odpovede, nie výsledok kontroly vášho projektu.

Dôsledok je vám jasný: človek príde o záznam, ktorý si chcel nechať. Názov súboru a miesto v kóde potrebuje ďalší agent, aby našiel príčinu. Sami tento úsek rozoberať nemusíte.

3. Ako overiť pripomienky

Aj agent-recenzent sa mýli. Napríklad napíše: "Do zoznamu sa dá pridať prázdna položka". Znie to presvedčivo. Lenže kontrola prázdneho vstupu už existuje v inej časti programu, ktorú nečítal. Pripomienka opisuje problém, ktorý neexistuje.

Takémuto sebaistému, ale vymyslenému tvrdeniu sa často hovorí halucinácia AI. V review je obzvlášť nepríjemná: agent môže navrhnúť opravu a vy strávite čas zmenou kódu, ktorý už fungoval správne. Preto sa oplatí overovať nielen samotný kód po napísaní, ale aj pripomienky k nemu.

Prvý krok už máme za sebou: prácu autora sme dali niekomu skontrolovať. Teraz dáme inému recenzentovi správu spolu s aktuálnym projektom. Jeho úloha: zistiť, či sa jednotlivé pripomienky potvrdzujú. S prvým recenzentom smie nesúhlasiť.

Prompt 2. Overiť správu recenzenta

Zver inému subagentovi overenie REVIEW_REPORT.md
podľa aktuálneho kódu projektu a požiadaviek z predchádzajúceho promptu.
Tieto požiadavky mu výslovne odovzdaj.

Pri každej pripomienke zisti, či opísaný problém existuje.
Skontroluj súvisiace časti kódu: potrebné ošetrenie už možno existuje.
Prvú správu neber ako dôkaz. Ak na záver treba
overenie spustením, urob ho dostupnými prostriedkami.
Kód projektu nemeň.

Pri každom bode uveď: potvrdené, vyvrátené
alebo zatiaľ sa nepodarilo zistiť. Zdôvodnenie vysvetli zrozumiteľne.
Oddeľ závery z čítania kódu od výsledkov vykonaných kontrol.
Nevydávaj nevykonanú kontrolu za vykonanú.
Výsledok ulož do REVIEW_CHECK.md a stručne mi ho vysvetli.

Potom budete mať REVIEW_CHECK.md s výsledkom overenia. V našom cvičnom prípade môže druhý agent problém s rovnakými názvami potvrdiť a pripomienku o prázdnom vstupe vyvrátiť: "Prázdny reťazec sa odmietne ešte pred pridaním záznamu. Prvý recenzent túto kontrolu prehliadol".

To už pomáha rozhodnúť sa, čo ďalej. Problém s odstraňovaním môžete poslať na opravu. Prázdny vstup kvôli tejto pripomienke meniť netreba. Ak agent napíše "zatiaľ sa nepodarilo zistiť", požiadajte ho, aby vysvetlil, aké údaje mu chýbali. Niekedy je to otázka na vás: napríklad či sa majú rovnaké záznamy počítať ako jeden nákup, alebo ako dva.

Opakovaná kontrola pomáha vyradiť vymyslené pripomienky, ale nezaručuje, že zmiznú úplne. Dvaja agenti môžu urobiť tú istú chybu. Preto odpoveď potrebuje zdôvodnenie: čo presne recenzent v projekte našiel alebo aký výsledok dostal pri spustení. Samotné "súhlasím s predchádzajúcim agentom" nestačí.

4. Oprava a opätovné review

Teraz vyberte, čo opraviť. Na to stačí pochopiť, ako problém ovplyvňuje zamýšľané fungovanie stránky. V našom príklade odstránenie nákupu navyše zjavne prekáža, preto berieme tento bod. Návrh pridať triedenie môže počkať. s opravou odstraňovania aj tak nesúvisí.

Odovzdajte agentovi vybranú pripomienku celú, aby nemusel hádať, čo ste mysleli pod "oprav prvú chybu". Požiadajte ho, aby po zmene výsledok znova skontroloval. To je pokračovanie príbehu tímu: kolega sa pozerá už na opravenú verziu.

Prompt 3. Opraviť a skontrolovať výsledok

Oprav potvrdený problém z REVIEW_CHECK.md:
pri odstránení jednej položky zmiznú všetky záznamy s rovnakým názvom.
Treba odstrániť iba vybraný záznam. Rovnaké názvy sú povolené.
Ostatné návrhy z review teraz nezavádzaj.

Po oprave skontroluj dostupnými prostriedkami pridávanie
a odstraňovanie nákupov vrátane dvoch s rovnakým názvom.
Potom zver samostatnému subagentovi opätovné review opraveného kódu:
či je príčina odstránená a či nie je narušené pridávanie a odstraňovanie.
Odovzdaj mu pôvodné požiadavky a opis opravovaného problému.

Vysvetli mi jednoduchými slovami, čo sa zmenilo, aké kontroly
prebehli a čo ukázalo opätovné review.
Ak sa niečo nepodarilo skontrolovať, uveď to zvlášť.
Nerozširuj úlohu o nové vylepšenia.

Pre vlastný projekt nahraďte odsek o nákupoch potvrdenou pripomienkou z vašej správy. Zvyšok postupu môžete ponechať: oprava, kontrola, samostatné prezretie výsledku.

Dobrý výsledok hlási niečo konkrétne: "Teraz sa každý záznam odstraňuje samostatne. Kontrola s dvoma rovnakými názvami nechala druhý záznam na mieste. Opätovné review pôvodnú príčinu chyby nenašlo". Tak sa dá napísať až po príslušných kontrolách. Ak agent len čítal kód, mal by to uviesť.

Stránku si môžete aj otvoriť a vyskúšať bežné akcie. Na to znalosť jazyka nepotrebujete. Je to doplnková kontrola viditeľného výsledku; technické review opravy aj naďalej robí agent. Ak mu na spustenie nestačili možnosti, v správe zostane zrozumiteľné obmedzenie, a nie sľub "všetko určite funguje".

Nie je nutné robiť z každého kola nekonečné dolaďovanie. Ak je vybraný problém odstránený, overený a opätovné prezretie neodhalilo súvisiace chyby, túto úlohu môžete uzavrieť. A to je všetko. Nové želania si zaslúžia samostatnú diskusiu.