Grimoire

Solicitarea recenziei de cod

2 min read

Solicitarea recenziei de cod

All guides

Ce face

Trimite un subagent specializat să-ți revizuiască codul înainte să se propage problemele. Subagentul primește doar contextul precis al schimbărilor, nu tot istoricul sesiunii tale. Asta îl ține concentrat pe produsul final și îți păstrează ție contextul intact pentru continuare. Principiul de bază: review devreme, review des.

Când îmi folosește

E obligatoriu după fiecare task în dezvoltarea cu subagenți, după implementarea unei funcționalități majore și înainte de merge pe main. E util și când ești blocat, înainte de refactorizare sau după fixarea unui bug complex. Nu sari peste el doar pentru că „e simplu”.

Cum îl invoc / declanșez

  1. Ia SHA-urile git:
BASE_SHA=$(git rev-parse HEAD~1)  # sau origin/main
HEAD_SHA=$(git rev-parse HEAD)
  1. Folosește tool-ul Task cu tipul general-purpose și completează template-ul din code-reviewer.md. Completează placeholder-ele: {DESCRIPTION} (sumar scurt), {PLAN_OR_REQUIREMENTS} (ce ar trebui să facă), {BASE_SHA} și {HEAD_SHA}.
  2. Aplică feedback-ul: rezolvă problemele Critical imediat, pe cele Important înainte de a continua, notează Minor-ele pentru mai târziu. Dacă reviewer-ul greșește, argumentează tehnic cu cod sau teste.

Exemplu practic

Tocmai ai terminat Task 2 (adaugă verifyIndex() și repairIndex()). Rulezi comenzile de mai sus, completezi template-ul cu „Added verifyIndex() and repairIndex() with 4 issue types” și trimiți subagentul. Acesta întoarce: Strengths – arhitectură curată, teste reale; Important – lipsesc indicatori de progres; Minor – număr magic 100. Corectezi indicatorii și treci la Task 3.

Output / unde aterizează

Primești un raport structurat cu Strengths, Issues (Critical/Important/Minor) și o evaluare finală. Rezultatul aterizează direct în chat-ul tău; tu decizi ce aplici și continui lucrul cu contextul tău original intact.

Limite / gotchas

Nu ignora niciodată problemele Critical sau Important. Nu argumenta feedback-ul valid fără dovezi tehnice. Dacă reviewer-ul e greșit, arată-i codul sau testele care demonstrează că funcționează și cere clarificări. Pentru pașii exacți de invocare sau template, verifică doctrina pentru detalii exacte. Folosește-l sistematic ca să nu-ți compună problemele mai târziu.

Graph View