Çelësi është t'i japësh AI-t materialin e papërpunuar — diff-in ose kodin aktual — dhe të kërkosh një format të caktuar, konvencional. AI është i mirë në shndërrimin e një ndryshimi në tekst të qartë, por vetëm nëse mund të shohë se çfarë u ndryshua.
git diff --staged | <your AI tool>.feat:, fix:, docs:), ose stilin e changelog-ut tuaj.Një mesazh commit dembel:
fixed stuff
Pas ushqimit të diff-it dhe kërkimit të stilit Conventional Commit:
fix(auth): reject expired tokens in session middleware
The middleware only checked token signature, not expiry, so expired
sessions stayed valid. Added an `exp` claim check that returns 401.
Versioni i dytë i tregon një reviewer-i çfarë ndryshoi dhe pse — shumë më i dobishëm në git log gjashtë muaj më vonë.
Gjithmonë lexoni rezultatin kundër ndryshimit aktual. AI nuk e di qëllimin tuaj — vetëm kodin që i u tregua — kështu që mund t'i etiketojë gabimisht një fix si feat ose të pretendojë një efekt anësor që nuk është real.
Mesazhet e mirë të commit-it dhe dokumentacioni janë se si ju në të ardhmen dhe kolegët e juaj kuptojnë pse ekziston kodi. AI e heq frikën e shkrimit të tyre mirë, por saktësia varet nga ju: një changelog gabim me siguri është më i keq se asgjë. I jepni atij të dhëna reale, kërkoni një konvencione reale, dhe verifikoni para se të bëni commit.