Gitea Pull Request áttekintés

Ha a szervezeted Gitea-t használ forráskezelésre, az asszisztens csevegésből is meg tudja nézni a pull requesteket, el tudja olvasni a diffjüket és a hozzászólásaikat, és — a jóváhagyásoddal — vissza tud írni Gitea-ra review megjegyzéseket.

Ez a funkció nem feltétlenül érhető el minden környezetben. Egy olyan kiegészítő bővítmény része, amelyet nem minden Codumentor-kiadás tartalmaz, és az adminisztrátornak kell bekapcsolnia és beállítania egy Gitea szervert, mielőtt megjelenne. Ha nálad nem működik, lehet, hogy az adminisztrátorod nem engedélyezte.

A Gitea-fiókod összekapcsolása

Mindenki a saját Gitea hozzáférési tokenjét használja, így az asszisztens mindig a te nevedben jár el — nincs megosztott fiók.

1. A Gitea-ban menj a Settings → Applications → Generate New Token menüpontra. Adj repository read jogosultságot a kereséshez; ha megjegyzéseket is szeretnél írni, add hozzá az issue/PR write jogosultságot is.
2. A Codumentorban menj a Beállítások → Bővítmények → Felhasználói titkok → Hozzáadás menüpontra, nevezd el a titkot gitea_api_token néven (előfordulhat, hogy az adminisztrátorod más nevet állított be), és illeszd be a tokent.

Ha a token beállítása előtt kérdezel rá egy pull requestre, az asszisztens jelzi, hogy hiányzik, ahelyett hogy némán megpróbálná és elbukna.

Kérdezés egy pull requestről

A kapcsolat után egyszerűen kérdezz rá egy sima üzenetben:

"Listázd ki a nyitott pull requesteket a backend repóban."

"Mit változtat a #42-es PR? Foglald össze a diffet."

"Ki kommentelt a #17-es PR-en, és mit írt?"

Ezek az olvasások soha nem kérnek jóváhagyást — az asszisztens szabadon kilistázhatja a pull requesteket, lekérheti egy PR részleteit, diffjét, megváltozott fájljait, commitjait és meglévő hozzászólásait, és ahol hasznos, össze is veti őket a betöltött kódbázissal. Nagy pull requestnél inkább az egyes megváltozott fájlokat kéri le, nem a teljes diffet.

Megjegyzések és review-k írása

Kérd meg az asszisztenst, hogy kommentelje vagy vizsgálja át a pull requestet, és az a tényleges diffsorokra alapozott észrevételeket fogalmaz meg:

"Vizsgáld át a #42-es PR-t, és írj megjegyzést mindenre, ami kockázatos."

"Írj összefoglaló megjegyzést a #17-es PR-re, hogy szerinted mergelhető."

Egy megjegyzés, egy sorhoz kötött megjegyzés vagy egy teljes review-verdikt (megjegyzés / jóváhagyás / változtatás kérése) elküldése is átmegy a szokásos jóváhagyási ablakon, mielőtt bármi felkerülne a Gitea-ra — semmi nem kerül ki anélkül, hogy előbb ne látnád. Ha az asszisztens később újra átnézi ugyanazt a pull requestet (például egy újabb push után), kihagyja a már korábban kiposztolt megjegyzéseket, hogy ne ismételje önmagát.

Automatikus review webhookra

A csevegéstől függetlenül egy adminisztrátor úgy is beállíthatja a Gitea webhookokat, hogy egy pull request megnyitása, egy meglévőre érkező új commit, vagy egy review kérése (egy /review hozzászólás, vagy a Gitea saját "review kérése" művelete) automatikusan elindítson egy review-beszélgetést — anélkül, hogy bárkinek meg kellene nyitnia a Codumentort és rá kellene kérdeznie.

Ez az automatikus útvonal alapértelmezetten ki van kapcsolva, és az adminisztrátornak kifejezetten be kell állítania és be kell kapcsolnia — a legtöbb környezet csak a fent leírt, csevegésből indított review-t kínálja.

Ahol be van kapcsolva, az automatikus review továbbra is csak megjegyzéseket tud írni — összefoglalhatja az észrevételeket és írhat sorhoz kötött megjegyzéseket, de saját magától soha nem küld jóváhagyó vagy változtatást kérő verdiktet. Egy pull request jóváhagyása vagy változtatásának kérése mindig azt igényli, hogy valaki interaktívan, csevegésben nézze át, és a jóváhagyási ablakon keresztül erősítse meg.