4. Šablony a práce po krocích

Odděl stálá pravidla od proměnlivých údajů

Pokud děláš stejný typ práce opakovaně, nemusíš pokaždé psát celé zadání znovu. Šablona obsahuje stálé instrukce a místa, kam doplníš měnící se údaje. Proměnná může být například název akce, datum, podkladový text nebo cílové publikum. Její význam musí být jasný člověku, který šablonu příště použije.

Pro běžnou šablonu nepotřebuješ programovat. Stačí text s označenými poli, třeba {název_akce} a {ověřené_údaje}. Před spuštěním ověř, že byla vyplněna všechna povinná pole a že v zadání nezůstal zástupný text. Jinak se může objevit přímo ve výstupu nebo jej model nahradí odhadem. Šablona je pomůcka, nikoli kontrola správnosti dat.

Některé úkoly je vhodné rozdělit: nejdřív získat údaje z podkladu, potom je zkontrolovat a až nakonec napsat text. Takové řetězení zadání dovoluje zachytit chybu v okamžiku, kdy vzniká. Pokud rovnou požádáš o všechno, bývá obtížnější poznat, zda je problém ve čtení podkladu, výběru informací nebo stylistické úpravě.

Více kroků však nezaručuje lepší výsledek. Chybný mezivýsledek se může přenést do dalších kroků a působit jako potvrzený fakt. Urči proto, co se mezi kroky ověřuje a kdy se postup zastaví. Pro naše cvičení platí jednoduché pravidlo: text pro veřejnost vznikne až z údajů, které člověk porovnal s původním zadáním.

Vlastní šablona pro oznámení

Krok 1: Z {podklad} vypiš název, datum, čas a místo.
Chybějící pole označ CHYBÍ. Nevymýšlej je.
Krok 2: Člověk zkontroluje tato pole proti podkladu.
Krok 3: Z {zkontrolované_údaje} napiš oznámení pro {publikum}.
Formát: nadpis do 8 slov a odstavec do 60 slov.
Pokud chybí datum nebo místo, oznámení nevytvářej;
vypiš, který údaj potřebuješ doplnit.

V tomto příkladu není „zkontrolované“ automaticky vlastností textu. Někdo jej musí opravdu projít. Název proměnné může připomenout potřebný krok, ale sám o sobě nedokládá jeho provedení. Při týmové práci se hodí zaznamenat, kdo a kdy kontrolu provedl, místo pouhého kopírování slovíčka „ověřeno“.

Cvičení: dva různé vstupy do stejné šablony

1. Vytvoř dva fiktivní podklady o veřejných akcích. První má všechny údaje, druhý záměrně nemá místo.
2. Vyplň šablonu pro první akci. U každého kroku ulož výsledek a označ, co jsi zkontrolovala.
3. Stejnou šablonu použij na druhou akci. Sleduj, zda se postup zastaví před napsáním hotového oznámení.
4. Pokud nezastaví, uprav pravidlo zacházení s chybějícími údaji a vyzkoušej oba vstupy znovu.

Zvaž, zda je strukturovaný seznam pro první krok užitečnější než volný odstavec. Pole název, datum, čas a místo usnadní porovnání. Jestli později použiješ JSON, jeho syntaxi a povinná pole musí ověřovat i běžný programový validátor; pouhý pokyn modelu „vrať platný JSON“ není zárukou.

Výsledkem lekce má být jedna čitelná šablona a popis kontrolních bodů. Nezačínej automatizací odesílání nebo publikování. Nejprve zjisti, zda postup pomáhá při ručním použití. Teprve potom řeš další nástroje, oprávnění a odpovědnost za skutečné akce. Dobrá šablona šetří práci hlavně tím, že omezuje opakované nejasnosti.