Lekce 03.2: Správa sezení v CLI harnessu (Managing Your Session: agy & claude)

⏱️ 3 min čtení • Lekce 03.2

🧠 Mentální model & teoretický rozbor

Práce v agentickém CLI probíhá v rámci sezení (Session). Sezení je časově ohraničený stavový prostor, který akumuluje historii zpráv a stav kontextového okna.

PŘÍKAZY PRO OVLÁDÁNÍ STAVU SEZENÍ V ANTIGRAVITY CLI (`agy`):
┌────────────────┬─────────────────────────────────────────────────────────┐
│ /clear         │ Tvrdý reset: Smaže historii chatu, vrátí kontext na nulu│
├────────────────┼─────────────────────────────────────────────────────────┤
│ Ctrl + C       │ Okamžitá brzda: Přeruší právě běžící generování či bash │
├────────────────┼─────────────────────────────────────────────────────────┤
│ /help          │ Rychlá nápověda: Zobrazí všechny dostupné systémové akce│
├────────────────┼─────────────────────────────────────────────────────────┤
│ /grill-me      │ Výslech požadavků před zahájením implementace           │
├────────────────┼─────────────────────────────────────────────────────────┤
│ /goal          │ Autonomní smyčka směřující k deterministickému cíli     │
├────────────────┼─────────────────────────────────────────────────────────┤
│ Ctrl+D Ctrl+D  │ Ukončení sezení a návrat do běžného shellu              │
└────────────────┴─────────────────────────────────────────────────────────┘

PŘÍKAZY V CLAUDE CODE (`claude`):
┌────────────────┬─────────────────────────────────────────────────────────┐
│ /clear         │ Tvrdý reset kontextového okna                           │
├────────────────┼─────────────────────────────────────────────────────────┤
│ /compact       │ Měkká komprese: Vytvoří ztrátové shrnutí dosavadní práce│
├────────────────┼─────────────────────────────────────────────────────────┤
│ /rewind        │ Návrat v čase: Interaktivní menu (kód, konverzace, obojí│
│ (nebo 2x Esc)  │ *Pozor: starší návody mylně uvádějí /undo, to neexistuje│
├────────────────┼─────────────────────────────────────────────────────────┤
│ /context       │ Diagnostika: Zobrazí přesný grafický rozpad tokenů      │
├────────────────┼─────────────────────────────────────────────────────────┤
│ /cost          │ Diagnostika spotřebovaných tokenů a nákladů             │
└────────────────┴─────────────────────────────────────────────────────────┘

Ovládání těchto zkratek a příkazů je rozdíl mezi inženýrem, který má situaci plně pod kontrolou, a bezradným uživatelem, který pasivně čeká, až agent dokončí nechtěnou operaci.

🏢 Realistický scénář z praxe

Agent dostal zadání refaktorovat utility soubor. Během generování si vývojář v terminálu všimne, že agent omylem začal přepisovat tsconfig.json a mazat nastavené cesty:

Místo čekání na dokončení okamžitě stiskne Ctrl + C.
Akce je přerušena dříve, než agent stihne poškodit další soubory.
Vývojář napíše: „Nesahej na tsconfig.json, pracuj výhradně v src/utils/format.ts.“

💻 Konkrétní ukázky kódu & promptů

Kdy použít `/clear` vs. Handoff:

Použijte /clear: Dokončili jste ticket, testy prošly a provedli jste git commit. Začínáte nový úkol. Vždy začínejte nový úkol s 0 tokeny historie!
Použijte Handoff protokol: Řešíte dlouhý úkol, kontext se blíží hranici Smart Zone, ale potřebujete navázat v dalším kroku. Necháte agenta vygenerovat HANDOFF.md, zadáte /clear a v čerstvém kontextu pokračujete.

⚠️ Analýza selhání & Anti-patterns

Chyba: Spoléhání na to, že komprese (/compact) zachová všechny nuance

Při kompakci model provádí ztrátovou kompresi. Pokud jste před 10 minutami specifikovali jemnou okrajovou podmínku (např. „Pro uživatele z Kanady musí být PSČ validováno alfanumericky“), toto pravidlo se v souhrnu může ztratit.

Doporučení: Klíčová pravidla zapisujte do testů nebo do AGENTS.md / CLAUDE.md, nikoliv jen do konverzace.

🛠️ Inženýrský postup krok za krokem (Playbook)

Začněte úkol: Spusťte agy (nebo claude).
Při zmatení agenta: Okamžitě stiskněte Ctrl + C.
Po dokončení úkolu: Proveďte git commit a následně nekompromisní /clear.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Vyzkoušejte si řízení sezení pomocí lomítkových příkazů a klávesových zkratek.

Kroky:

Spusťte agy (nebo claude).
Nechte agenta vygenerovat 2 různé textové soubory (a.txt, b.txt).
Vyzkoušejte přerušení generování pomocí Ctrl + C.
Zadejte /clear a ověřte, že kontext byl zcela vymazán.
V Claude Code vyzkoušejte stisknout dvakrát Esc pro otevření nabídky /rewind.