Přeskočit na obsah

Hands-on 1: Explore agent v ~/.claude/skills/

⏱ Odhadovaný čas 45 min
📍 Pozice Den 6, blok 3 / 7
🎯 Po tomto bloku budeš umět
  • Spustil(a) jsi Explore subagent na konkrétní úkol (read-only, rychlejší)
  • Iteroval(a) jsi 3× — každé volání s jiným zadáním
  • Vidíš, jak se Explore liší od general-purpose v praxi

🎯 Co je Explore subagent

Sekce “🎯 Co je Explore subagent”

Explore je read-only specialista na hledání a orientaci ve struktuře (typicky kód, ale i jakékoli soubory). Běží na Haiku modelu = rychlejší + levnější než general-purpose.

Use case dnes: prozkoumat tvou vlastní ~/.claude/skills/ složku. Po 6-12 měsících budeš mít víc skillů a zapomeneš, co tam je. Explore agent ti rychle vrátí přehled.


🧪 Experiment 1: Vypiš všechny skilly (10 min)

Sekce “🧪 Experiment 1: Vypiš všechny skilly (10 min)”
  1. V CC napiš:

    Spusť Task tool s subagent_type: Explore. Úkol pro něj:
    "Projdi složku ~/.claude/skills/, vypiš všechny skilly, u každého
    stručně řekni: jméno (ze složky), k čemu slouží (z 'description' v YAML
    frontmatteru SKILL.md), kdy se má volat. Vrať přehled jako Markdown tabulku."
  2. Sleduj v UI:

    • ⏺ Task(subagent_type: Explore, ...) — pokud Explore funguje
    • Nebo ⏺ Task(subagent_type: general-purpose, ...) — pokud CC fallback
    • ⎿ Done + tabulka tvých 2 skillů
  3. Očekávaný výstup:

    | Jméno | K čemu | Kdy volat |
    |---|---|---|
    | otestuj-me | Spustí test/kvíz na téma | /otestuj-me, „vyzkoušej mě z..." |
    | pripravny-plan | Sestaví plán studia | /pripravny-plan, „plán na X dní" |

    (Pro Student B: vysvetli-gramatiku + tyden-anglictiny.)

  4. Pokud jeden skill chybí v tabulce — zkontroluj, že SKILL.mdsprávný frontmatter (name: a description: mezi ---).


🧪 Experiment 2: Zúžení (10 min)

Sekce “🧪 Experiment 2: Zúžení (10 min)”

Teď ho zavoláš znovu, ale s užším zadáním:

  1. V CC napiš:

    Spusť znovu Task tool s subagent_type: Explore. Tento úkol je užší:
    "Projdi ~/.claude/skills/. Vypiš JEN ten skill, který má v 'description'
    slovo 'plán' (case-insensitive). Vrať jméno + plnou description."
  2. Očekávaný výstup: 1 skill (pripravny-plan / tyden-anglictiny).

  3. Pozoruj:

    • Explore skutečně prošel jen složky, nepřinesl info odjinud (read-only fíčura)
    • Hledání bylo rychlé (Haiku model)

🧪 Experiment 3: Porovnání pravidel (15 min)

Sekce “🧪 Experiment 3: Porovnání pravidel (15 min)”

Trochu náročnější — Explore má najít a porovnat strukturu:

  1. V CC napiš:

    Spusť Task tool s subagent_type: Explore. Úkol:
    "Projdi všechny SKILL.md soubory v ~/.claude/skills/. V sekci 'Pravidla'
    každého skillu vypiš všechna pravidla typu **VŽDY** a **NIKDY**.
    Vrať to jako Markdown:
    - sekce 'VŽDY' — sjednocený seznam pravidel napříč skilly
    - sekce 'NIKDY' — sjednocený seznam
    - sekce 'Konflikty' — pravidla, která si protiřečí (pokud jaké)"
  2. Očekávaný výstup: 3 sekce. Konflikty by neměly být — pokud ano, máš co řešit ve vlastních skillech.

  3. Pozoruj:

    • Explore agreguje napříč soubory
    • Vrací strukturovaný výstup (ne volný text)
    • Není kreativní — pouze hledá to, co je tam

Do zaznamy.md:

Které tvé Experimenty 1-3 by zvládl general-purpose? Které líp Explore?

Vzorová odpověď
  • Všechny 3 by zvládl general-purpose — má všechny tools.
  • Ale Experiment 1+2 (orientace) je Explore lepší volba — read-only + rychlejší + levnější.
  • Experiment 3 (analýza konfliktů) je hraniční — Explore to zvládne, ale general-purpose může víc spekulovat / analyzovat. Pokud chceš jen vypsat fakta, Explore. Pokud chceš vyhodnocení s návrhy, general-purpose.

Kdy bys Explore reálně použil/a mimo ~/.claude/?

Příklady
  • Documents/ — „prozkoumej moje dokumenty z minulého roku, vypiš témata podle počtu souborů”
  • Maturitní složka (Student A) — „projdi moje poznámky, vypiš témata, ke kterým mám nejvíc materiálu”
  • Recepty / Kuchařka — „projdi moje recepty, vypiš ingredience, které se opakují u 3+ jídel”
  • Excel/CSV exporty — Explore umí číst soubory, takže může extrahovat klíčové info

Společný pattern: „mám hodně souborů, chci přehled / agregaci / hledání podle pravidla”.


  • CC nezavolal Task tool / vrátil odpověď přímo → přidej do promptu „Použij Task tool, ne odpovídej sám.”
  • Explore neexistuje (unknown subagent_type) → nahraď za general-purpose ve všech experimentech
  • Sub-agent vrátil prázdný výsledek → zkontroluj, že ~/.claude/skills/ opravdu obsahuje SKILL.md soubory (pre-flight check z Bloku 00)
  • Explore vrátil odpověď s halucinacemi (např. skill, který nemáš) → restart, zúži úkol, řekni přesně „jen reálné soubory ve složce, nic neumýšlej”

🧪 Checkpoint 75 min (od začátku dne)

Sekce “🧪 Checkpoint 75 min (od začátku dne)”
  • 3 spuštění Explore (nebo general-purpose), 3 různé úkoly, 3 různé výstupy
  • Vidíš v UI tool call indikátor pro každé volání
  • Rozumíš, kdy Explore (orientace, hledání) vs general-purpose (kreativita, analýza s návrhy)
  • Reflexe v zaznamy.md (2 otázky)

Pokračovat na blok 03: Research agent →