Opisy PR od AI działają lepiej, gdy człowiek skraca wejście

Simon Willison traktuje pull request jako podstawową jednostkę pracy z Claude Code i Codexem. Długiego opisu od agenta nie usuwa. Chowa go w rozwijanym elemencie, a na początku zostawia kilka zdań zatwierdzonych przez człowieka.

GitHub pozwala ukryć szczegóły bez wyrzucania informacji

GitHub Markdown obsługuje elementy HTML details i summary w opisach pull requestów oraz komentarzach. Willison umieszcza w nich tekst wygenerowany przez agenta. Na wierzchu pozostaje krótki wstęp, czasem również obraz i nazwa modelu lub poziomu wysiłku.

Autor pokazuje pięć konkretnych pull requestów. Jeden wstęp tłumaczy problem tabeli z 46 kolumnami, inny wskazuje zbędne ładowanie pliku o wielkości około 220 KB. Pełny zapis implementacji i testów nadal można rozwinąć.

Pisanie staniało, więc wąskim gardłem stało się czytanie

Coding agent potrafi przygotować dokładny i kompletny opis niemal bez kosztu dla autora. Osoba robiąca review nadal płaci własnym czasem. Gdy każdy pull request przynosi kilka równie szczegółowych akapitów, kompletność utrudnia orientację.

Willison rozdziela dwa zadania. Krótki wstęp odpowiada, czy zmiana zasługuje na uwagę. Rozwijana część zachowuje decyzje, szczegóły implementacji i testy na moment, gdy będą potrzebne. Praca człowieka przesuwa się z pisania na selekcję.

Rozwijany element nie zastąpi osądu ani review

Ten wzorzec nie gwarantuje poprawnego kodu ani wiernego opisu. Źle dobrany wstęp może ukryć ryzyko równie skutecznie jak watę. Długi tekst wewnątrz nadal pozostaje długi, tylko nie blokuje pierwszego spojrzenia.

Rozwiązanie działa wtedy, gdy zespół przyjmie jasną zasadę: widoczny akapit pokazuje priorytety zatwierdzone przez człowieka, a nie kolejne automatyczne streszczenie. Bez tej odpowiedzialności rozwijany element stanie się cyfrową szafą, którą wszyscy zapełniają i nikt nie otwiera.

Szybsza decyzja będzie ważniejsza niż dłuższy opis

Liczyć powinna się krótsza droga do pierwszego review i mniej przeoczonych ryzyk, a nie liczba słów ukrytych pod strzałką. Zespoły powinny sprawdzać, czy wstęp konsekwentnie podaje cel, zakres i najważniejsze ryzyko zmiany.

Jeśli wzorzec się przyjmie, zmiana będzie dyskretna. Agent dostarczy pełne akta, człowiek wybierze stronę tytułową, a reviewer zdecyduje, czy otworzyć resztę.

Werdykt Lilith

Agent przynosi do review całe pudło akt. Człowiek nadal musi napisać na wieku, dlaczego ktoś ma je otworzyć.