Zkontrolujte první pull request

Co budeš mít hotové

Na konci tohohle tutoriálu budeš mít:

• Otevřený pull request na pracovní ploše PR v Control Center
• Přečtený diff a řádkový komentář
• Odeslaný verdikt kontroly
• Sloučený PR

Předpoklady: tutoriál Odešlete prvního agenta máš hotový a v repozitáři registrovaném v tomhle pracovním prostoru je jeden otevřený pull request. Pro kroky kontroly vyber PR, který jsi neotevřel. Tlačítko Kontrola je na vlastních PR skryté. Sloučit jde i PR, jehož jsi autorem.

Krok 1: Otevři pull request

1. V postranním panelu klikni na Pull requesty
2. Najdi svůj PR a klikni na něj

Kontrolní bod. PR se otevře jako pracovní plocha se záložkami Přehled, Diff, Správa zdrojového kódu, Chat a Akce, zaměřená na Přehled: název a akce, popis, časová osa aktivity a postranní panel se stavem, recenzenty, přiřazením, kontrolami a změněnými soubory. Kliknutí na soubor tam skočí na něj v záložce Diff. Záložka Kontrola PR se neotevře, dokud někdo nepožádá o AI kontrolu.

Prázdná fronta s výzvou „Připojte GitHub a načtěte pull requesty“

Ten stav znamená, že server žádný token GitHubu nemá. Klient ho nikdy nedrží. Token nastavíš v Nastavení → Pracovní prostor → Profil a identita → Hostování kódu, pak seznam obnov.

Krok 2: Přečti diff

Otevři záložku Diff. Vlevo je sbalitelný strom souborů. Pruh nad diffem nese výběr rozsahu commitů, kterým diff zúžíš na jeden commit nebo na jejich úsek, a k tomu počet souborů a průběžný součet přidaných a smazaných řádků.

Tlačítko nastavení v liště diffu určuje, jak se vykreslí:

• Pohled Rozdělený nebo Jednotný
• Zalamovat řádky, nebo dlouhé řádky posouvat
• Ligatury písma kódu

Soubor označ jako prohlédnutý, ať ve velkém diffu vidíš, jak daleko jsi. Ovládání z klávesnice popisují Klávesové zkratky.

Krok 3: Nech řádkový komentář

1. Najeď na řádek v diffu. V okraji se objeví malá kapsle +
2. Klikni na ni a okomentuj ten řádek, nebo ji nejdřív svisle přetáhni a vyber rozsah
3. Napiš zpětnou vazbu. Editor nabízí dvě odeslání:
   • Zahájit kontrolu (nebo Přidat ke kontrole, když kontrola už probíhá) komentář zařadí do fronty. Vlákno ukazuje Čekající kontrola, dokud v kroku 4 neodešleš verdikt.
   • Přidat jeden komentář ho na GitHub odešle hned. Vlákno ukáže Odesílání…, pak Synchronizováno, a když odeslání selže, nabídne Zopakovat.

V tomhle tutoriálu použij Zahájit kontrolu, ať komentář odejde spolu s verdiktem.

Zařazený komentář na GitHubu ještě není

Zahájit kontrolu / Přidat ke kontrole drží komentář lokálně, dokud neodešleš verdikt. Hned odchází jen Přidat jeden komentář. Tělo kontroly, které napíšeš v kroku 4, je samostatný koncept.

Krok 4: Odešli kontrolu

1. Klikni na Kontrola v řádku akcí na Přehledu. Stejné tlačítko je i v liště záložky Diff. Na PR, které jsi vytvořil, a na zavřeném nebo sloučeném PR je skryté.
2. Do editoru napiš shrnutí. Ukládá se samo jako koncept, takže překryv můžeš zavřít a vrátit se.
3. Vyber verdikt:
   • Vyžádat změny
   • Komentář
   • Schválit

Verdikt je to tlačítko. Po Schválit nebo Vyžádat změny se přejmenuje na Schváleno, respektive Vyžádané změny. Verdikt Komentář nechá popisek Kontrola.

Kontrolní bod. Když jsi zvolil jedno z těch dvou, tlačítko ukazuje „Schváleno“ nebo „Vyžádané změny“.

Krok 5: Slouč

Tlačítko Sloučit je k dispozici, kdykoli GitHub hlásí, že se PR dá sloučit. Vlastní schválení ho nepodmiňuje. Barva hlásí připravenost, ne oprávnění: primární, když jsou požadovaná schválení a kontroly zelené, sekundární, dokud nějaká kontrola ještě běží, a destruktivní, když vyžádaný recenzent neschválil nebo kontrola selhává.

1. Klikni na Sloučit
2. Vyber způsob: Squash a sloučení, Vytvořit merge commit nebo Rebase a sloučení
3. U prvních dvou uprav předvyplněný název a zprávu commitu
4. Potvrď

Nevyřešené problémy, „Kontroly selhávají“ a „Některé kontroly čekají“, se vypíšou ve vysouvacím panelu ještě před potvrzením.

Sloučení je nevratné

Sloučení posílá commity na GitHub. Do zásobníku vrácení zpět v Control Center se nikdy nedostane a odsud ho nejde vrátit.

Po sloučení vystřelí doménová událost PrMerged. Analytika a oznámení ji spotřebují. Co dalšího ji poslouchá, je v Doménové události.

Kontrola pomocí AI

Control Center umí na otevřený PR nasadit pipeline recenzentů, ale jen když o to požádáš. Šablona pr_review má jen ruční spouštěč.

1. V řádku akcí na Přehledu otevři rozbalovací nabídku a zvol Zeptat se AI. Control Center spustí běh a otevře záložku Kontrola PR, takže uvidíš, jak specialisté pracují.
2. Agenti recenzenti zapisují zjištění jako uzly kontroly do prostoru daného PR. Poslední krok je složí do jedné zprávy.

Pipeline na GitHub schválně nic neposílá a skončí po složení. Zveřejnění je samostatný krok, který uděláš sám tlačítkem Zveřejnit na GitHub na záložce Kontrola PR. Viz Používejte AI kontrolu.

Shrnutí

Otevřel jsi PR na pracovní ploše, přečetl diff se zvýrazněním syntaxe, nechal řádkový komentář, odeslal verdikt a sloučil. Z aplikace jsi přitom neodešel.

Další: Vytvořte první pipeline a zautomatizuj vícekrokové postupy.