Popis PR od AI agenta: podstatné dej nahoru, detaily sbal

TL;DR

• Popis změny od AI agenta může být přesný a přesto únavný. Na začátek dej krátké vysvětlení problému a výsledku, které jsi sám zkontroloval.
• GitHub podporuje rozbalovací blok <details><summary>. Podrobný agentský popis v něm zůstane dostupný, aniž by zabral celou úvodní obrazovku.
• Vyzkoušej to u příštího návrhu změny: přečti jen úvod a ověř, zda z něj kolega pochopí, co se mění a proč.

Otevřeš návrh změny kódu a před sebou máš několik odstavců o řešení, upravených souborech a testech. Potřebuješ přitom nejdřív zjistit, jaký problém změna řeší. Když popisy připravuje AI agent, vyplatí se oddělit krátký úvod pro orientaci od podkladů pro podrobnou kontrolu.

Pull request, zkráceně PR, je návrh na začlenění změn do projektu. Jeho popis pomáhá člověku, který změnu kontroluje, pochopit účel i způsob ověření. Krátký úvod a rozbalovací podrobnosti umožňují zachovat obojí, aniž by čtenář musel nejdřív projít celý výklad.

Úvod má vysvětlit, proč změna vznikla

Simon Willison ve svém příspěvku z 9. listopadu 2026 popisuje, že většina změn v jeho projektech přichází přes PR připravené pomocí Claude Code nebo Codexu. Jejich popisy považuje za přesné a důkladné, ale množství textu ho odrazuje od čtení. Začal proto nechávat nahoře krátký, pečlivě vybraný úvod a zbytek schovávat do rozbalovacího bloku.

Dobrý úvod pojmenuje konkrétní potíž a výsledné chování. Jeden z jeho příkladů se týká stránkování tabulek: popis rovnou vysvětluje, že stránka nově ukazuje, kterou část tabulky si prohlížíš, a nabízí navigaci nahoře i dole. Čtenář tak zná přínos ještě před seznamem technických změn.

U vizuální úpravy může podobnou službu udělat snímek obrazovky. Pokud agent mění rozložení stránky, krátké vysvětlení doplněné obrázkem může kolegovi usnadnit orientaci před kontrolou kódu.

GitHub umí podrobnosti sbalit přímo v popisu

Značky <details> a <summary> fungují v Markdownu na GitHubu, včetně popisů PR a komentářů. První obaluje celý rozbalovací blok, druhá určuje jeho viditelný, klikací nadpis. Podrobnosti se zobrazí po rozbalení.

Pro vlastní PR můžeš použít tuto kostru. Text v hranatých závorkách nahraď skutečnými údaji:

[Krátce vysvětli původní problém a výslednou změnu.]

<details>
<summary>Podrobný popis od AI agenta</summary>

### Řešení
[Popis změn a důvody zvoleného řešení.]

### Ověření
[Skutečně provedené kontroly, jejich výsledky a co zůstalo neověřené.]

</details>

Willison do klikacího nadpisu uvádí název použitého modelu a často i úroveň jeho uvažování. Dává tím najevo, odkud podrobný text pochází. Pokud tyto údaje znáš, můžeš je doplnit také. Pro samotné rozbalování nejsou potřeba.

Krátký úvod potřebuje tvůj úsudek

Úvod nemusíš pokaždé napsat od nuly. I ve vygenerovaném popisu může být věta, která vystihuje změnu dobře. Vyber ji, případně uprav a ověř, že odpovídá tomu, co PR skutečně obsahuje. Takto postupuje i autor popsaného přístupu.

Pro malý vývojový tým z toho plyne jednoduché rozdělení práce: agent připraví podklady a návrh vysvětlení, člověk odesílající PR rozhodne, co má kolega vědět jako první. Při výběru úvodu se ptej, zda popisuje změnu z pohledu jejího dopadu. Výčet upravených souborů obvykle patří až do podrobností.

Doporučujeme přitom nechat nahoře i informaci, která zásadně mění rozhodnutí o přijetí změny. Pokud například oprava zatím neprošla potřebnou kontrolou, čtenář by se to neměl dozvědět teprve po rozbalení. Úplný záznam ověření může zůstat uvnitř bloku.

Vyzkoušej jeden PR očima kolegy

Rozbalovací blok mění způsob čtení popisu. Sám neověřuje správnost kódu ani pravdivost agentova tvrzení o testech. Zdroj popisuje osobní zkušenost s přehledností PR, nikoli měřenou úsporu času při jejich kontrole.

U příštího PR proto nech podrobnosti sbalené a přečti si jen úvod. Dokážeš z něj říct, jaký problém se řeší, co bude fungovat jinak a zda něco podstatného brání přijetí? Pokud ano, předej návrh kolegovi. Podrobný popis mu zůstane po ruce pro samotnou kontrolu.

Zdroj

Simon Willison: Hide agent-written PR details behind details/summary, 9. listopadu 2026