AI popisy PR jsou užitečné, dokud je někdo zkrátí

Simon Willison používá pull request jako základní jednotku práce s Claude Code a Codexem. Dlouhý strojový popis nově nesmazal. Schoval ho do rozbalovacího prvku a před něj postavil pár vět, za které ručí člověk.

GitHub umí dlouhý strojový text schovat bez ztráty informací

GitHub Markdown podporuje HTML značky details a summary přímo v popisu pull requestu i komentáři. Willison do nich ukládá podrobný text od agenta. Viditelný zůstává krátký úvod, případně obrázek, a označení použitého modelu či úrovně úsilí.

Ukazuje pět konkrétních pull requestů. V jednom úvod vysvětluje problém tabulky se 46 sloupci, v jiném zbytečné načítání souboru o velikosti přibližně 220 KB. Podrobný záznam o řešení a ověření zůstává po rozkliknutí dostupný.

Úzkým místem už není výroba textu, ale jeho čtení

Coding agent dokáže vyrobit přesný a úplný popis skoro bez nákladů pro autora. Reviewer však platí časem. Když každý pull request přijde s několika odstavci stejně důkladného textu, úplnost začne překážet orientaci.

Willison proto odděluje dvě funkce dokumentace. Krátký úvod odpovídá na otázku, zda změna stojí za pozornost. Rozbalená část uchovává trasu rozhodnutí, implementace a testů pro chvíli, kdy ji někdo skutečně potřebuje. Lidská práce se přesouvá od psaní ke kurátorství.

Skládací značka nenahradí úsudek ani kvalitní review

Tento postup nezaručí správnost kódu ani popisu. Špatně zvolený úvod může schovat riziko stejně snadno jako vatu. A příliš dlouhý text uvnitř zůstává příliš dlouhým textem, jen už neblokuje první pohled.

Vzorec také funguje hlavně tam, kde tým přijme jasnou dohodu: viditelný odstavec je lidsky schválená priorita, nikoli další automatické shrnutí. Bez této odpovědnosti se z rozbalovacího prvku stane digitální skříň, do které všichni ukládají a nikdo se nevrací.

Kvalitu ukáže rychlejší rozhodnutí, ne delší popis

Smysluplný signál bude kratší doba k prvnímu review a méně přehlédnutých rizik, nikoli počet slov schovaných pod šipkou. Týmy by měly sledovat, zda krátký úvod opravdu pojmenuje účel změny, její rozsah a nejdůležitější riziko.

Jestli se tento vzorec uchytí, proměna bude nenápadná. Agent dodá úplný spis, člověk vybere titulní stranu a reviewer se rozhodne, zda má otevřít zbytek.

Lilithin verdikt

Agent přinese k review celý karton spisu. Člověk musí na víko napsat, proč ho má kolega vůbec otevřít.