Ako rozdeliť veľkú požiadavku na zrozumiteľné kroky

Požiadate Claude: "Pridaj zoznam lokalizácií, vyhľadávanie, filter podľa krajiny a uprav vzhľad". Agent zmení niekoľko súborov, oznámi, že je hotovo, a stránka na prvý pohľad vyzerá dobre. Po zadaní vyhľadávacieho výrazu však potrebný záznam zmizne. Vymažete obsah poľa, no záznam sa nevráti.

Čo sa pokazilo? Vyhľadávanie, filter alebo samotný zoznam? Všetko pribudlo naraz a ešte ste nevideli fungovať samostatne ani jednu časť. Požiadate o opravu vyhľadávania, dostanete ďalšie zmeny a znovu kontrolujete celú stránku. Práca pokračuje, no výsledkom ste si istí čoraz menej.

Aby ste nemuseli naraz rozmotávať viacero zmien, rozdeľte požiadavku na malé kroky, ktoré sa dajú skontrolovať. Najprv zobrazte zoznam a overte záznamy. Potom pridajte vyhľadávanie a otestujte ho na tomto zozname. Následne prejdite k filtru a zmenu vzhľadu nechajte na samostatný krok. Chyby sa môžu objaviť aj tak, no budete mať overený východiskový stav a jasný prehľad o posledných zmenách. Pozrime sa, ako také kroky vybrať a zadať ich agentovi.

Vľavo sú zmeny vykonané naraz. Vpravo vidno spoločný príznak, ktorý ešte neukazuje na konkrétnu príčinu. Ak budete kontrolovať jednotlivé časti postupne, ľahšie spojíte vznik chyby s poslednou úpravou.

Vyberte najbližší výsledok

Dekompozícia znamená rozdelenie úlohy na časti. Pri práci s agentom sa oplatí vyberať ich tak, aby sa dal výsledok každej skontrolovať samostatne. Napríklad najprv zobraziť zoznam, potom doň pridať vyhľadávanie a napokon filter.

Ak zoznam už funguje, netreba ho vytvárať znova. Začnite najbližším chýbajúcim správaním. Ak si nie ste istí, či funguje, najprv otvorte stránku a pozrite sa. Východiskový bod závisí od stavu projektu, nie od pekného plánu.

Aj veta "najprv napíš HTML, potom JavaScript" rozdeľuje prácu, no nie vždy pomáha kontrolovať výsledok. Funkčné vyhľadávanie môže vyžadovať zároveň vstupné pole v HTML aj obsluhu udalosti v JavaScripte. Je to jeden zrozumiteľný krok, hoci sa týka dvoch súborov.

Rozdeľte požiadavku podľa správania

V ukážkovom katalógu sú štyri záznamy. Kód lokalizácie, jazyk a krajina sú uvedené nižšie; tieto údaje použijeme pri kontrole.

Pri každom kroku teraz vieme pomenovať výsledok aj spôsob kontroly:

Šípka označuje prechod po kontrole. Vyhľadávanie a filter môžete pridať aj v opačnom poradí, no oboje potrebuje zoznam. Úplnú zmenu vzhľadu necháme na samostatný krok: jej výsledok sa ľahšie posúdi, keď už fungujú hlavné funkcie.

Vymedzte hranice kroku

Predstavme si, že zoznam je hotový. Požiadajte Claude, aby pridal vyhľadávanie, a jasne povedzte, čo sa má zatiaľ zachovať. V príklade sú údaje a správanie stránky v súbore app.js, značkovanie v index.html. Vo svojom projekte dosaďte skutočné cesty.

Prečítaj @index.html a @app.js.
Zoznam štyroch lokalizácií už funguje.
Pridaj vyhľadávacie pole podľa kódu lokalizácie alebo názvu jazyka.

Zachovaj pôvodné záznamy, ich polia aj vzhľad.
Môžeš pridať prvky potrebné na vyhľadávanie.
Filter podľa krajiny zatiaľ nerob.

Kontrola: German a de-DE nájdu de-DE;
zzz nenájde žiadny záznam; prázdny dopyt vráti všetky štyri.

Najprv vysvetli, čo zmeníš. Súbory zatiaľ nemeň.

Prečítajte si odpoveď. Ak sa v nej objavili nové údaje, zmena témy alebo filter, pred vykonaním spresnite hranice. Ak všetko zodpovedá požiadavke, nechajte agenta tento krok vykonať. Pokyny pomáhajú nasmerovať prácu, no dodržanie hraníc aj tak treba overiť podľa výsledku.

Nie každá činnosť navyše je zbytočná. Vstupné pole je na vyhľadávanie potrebné. Úplná zmena farieb je už samostatná požiadavka. Užitočná otázka: dá sa zvolený výsledok dosiahnuť aj bez tejto úpravy?

Keď neviete, kde začať

V cudzom projekte môže byť najprv potrebné čítať. Nežiadajte o pridanie vyhľadávania, ak ešte neviete, odkiaľ záznamy pochádzajú a ktorý súbor zobrazuje zoznam.

Nájdi, odkiaľ stránka získava záznamy a kde zobrazuje zoznam.
Prečítaj dva či tri kľúčové súbory, ak to stačí.
Uveď nájdené cesty a navrhni prvý malý krok.
Ak chýbajú údaje, povedz, čo ešte treba prečítať.
Súbory zatiaľ nemeň.

Výsledkom takého kroku sú nájdené súbory a vysvetlenie ich úlohy. Porovnajte odpoveď s uvedenými úryvkami. Číslo "dva či tri" je tu len orientačný bod na začiatok, nie zákaz prečítať potrebný kód.

Pred ďalším krokom všetko skontrolujte

Hlásenie "vyhľadávanie je hotové" ešte nehovorí, čo sa vlastne skontrolovalo. Otvorte stránku a vyskúšajte príklady z požiadavky: nájdený záznam, žiadne zhody a vymazanie obsahu poľa. Zároveň overte, že pôvodné záznamy aj ich polia zostali zachované.

Ak po vymazaní vidno iba tri riadky, zostaňte pri vyhľadávaní. Povedzte agentovi, čo ste urobili a aký bol očakávaný a skutočný výsledok: "Vymazal som obsah poľa. Čakal som štyri záznamy, vidím tri". Pridanie filtra by teraz sťažilo hľadanie príčiny.

Niekedy treba krok ešte zmenšiť. Ak sa napríklad záznamy vôbec nezobrazujú, najprv obnovte zoznam a skontrolujte ho. Nový nápad na triedenie si môžete zapísať ako samostatný bod, aby sa nestratil a nerozšíril aktuálnu úpravu.

Ľavá vetva vedie späť k vyhľadávaniu, kým jeho správanie nezodpovedá požiadavke. Pravá pokračuje po úspešnej kontrole. Keď pridáte filter, skontrolujte ho aj jeho spoluprácu s vyhľadávaním: nový krok môže ovplyvniť už fungujúce správanie.

V spojení s Claude Code

Pred ďalšou úpravou si ujasnite tri veci: aký výsledok má vzniknúť teraz, čo sa má zachovať a ako výsledok overíte. Poskytnite agentovi potrebné súbory, dohodnite najbližší krok a požiadajte ho, aby ho vykonal. Po kontrole pokračujte ďalej alebo spresnite aktuálnu úpravu.

Jeden krok môže zabrať niekoľko správ. Dôležité je, aby ste kedykoľvek vedeli povedať: "Teraz pridávame vyhľadávanie. Zoznam už máme skontrolovaný. Filter zatiaľ počká".