📖 Den 6 — Reference: sub-agenti hands-on

Reference — Den 6 (sub-agenti hands-on)

🤖 Task / Agent tool — základ

Tool name: Task (starší) / Agent (od Claude Code v2.1.63). Oba fungují (zpětně kompatibilní).

Tři built-in subagent_types

Typ	Model	Schopnosti	Kdy použít
`general-purpose`	Sonnet/Opus	Plný — všechny tools, write, kreativita	Universální. Default volba.
`Explore`	Haiku	Read-only — hledání, orientace, agregace	Rychlejší + levnější. „Vypiš všechny X…”
`Plan`	Haiku	Read-only — research v plan-mode	Pre-implementation research.

Lze definovat vlastní subagenty s libovolnými jmény (advanced, mimo scope kurzu).

UI indikátor

⏺ Task(subagent_type: general-purpose, description: "...")
  ⎿ Running...
  ⎿ Done
  ⎿ Result: ...

Bez tohoto indikátoru sub-agent nebyl spuštěn — CC odpověděl přímo.

⚠️ Klíčový gotcha: context isolation

Sub-agent NEVIDÍ:

Tvou aktuální konverzaci s hlavním CC
Memory MCP
Global CLAUDE.md
Project CLAUDE.md
Předchozí tool calls

Sub-agent VIDÍ pouze:

To, co napíšeš v description parametru Task/Agent volání
Své vlastní system prompt (per subagent_type)

Důsledek pro promptování

Pokud chceš personalizovaný výstup, vše předat v promptu:

✅ EXPLICITNÍ:
"Najdi 3 fakta o Třicetileté válce. Pro maturitního studenta v ČR.
Max 4 věty na fakt. Cílová znalost: česká státní maturita."

❌ NAIVNÍ:
"Najdi mi fakta k mému tématu pro maturitu."
(Sub-agent neví, kdo jsi, jaké téma, jaká maturita.)

Pattern předávání Memory dat

Pokud potřebuješ Memory data pro sub-agenta:

1. Hlavní CC zavolá list_memories tool
2. CC vezme relevantní fakta
3. CC zavolá Task tool a v description PŘEDÁ fakta jako součást promptu

V SKILL.md to vypadá takto:

## Postup
1. ZAVOLEJ list_memories — najdi slabá místa studenta.
2. ZAVOLEJ Task tool s general-purpose. V description napiš:
   - téma daného úkolu
   - "Z Memory víme, že student má slabost v: [data z kroku 1]"
   - úroveň + formát + omezení
3. Vrácený výsledek vlož do souboru.

🔧 Agent-augmented skill — template

Rozšíření existujícího skillu (z Dne 5) o auto-volání sub-agenta:

---
name: <jméno>
description: ...existující...
---

# Instrukce
... existující kroky 1-6 z Dne 5 ...

## Postup (rozšíření z Dne 6)

7. **Pro každý den/jev v plánu**, zavolej Task tool s general-purpose subagentem.
   V `description` parametru EXPLICITNĚ uveď:
   - téma / gramatický jev / oblast
   - úroveň studenta (z Memory MCP, jinak natvrdo)
   - mateřštinu (z Memory nebo "čeština")
   - formát výstupu (počet, struktura, max délka)

   Pokud máš Memory MCP, ZAVOLEJ list_memories PŘED Task voláním a osobní
   data předej jako součást description.

8. Po každém Task volání: vlož výstup do plan-*.md pod sekci „Den N — bonus material".

⚠️ Pravidla v SKILL.md jsou hint, ne garance. Stejný non-determinism jako Memory list_memories v Dne 4-5. Připrav 15-min kontrolní bod a light path.

🛟 Troubleshooting

Symptom	Pravděpodobná příčina	Řešení
CC neudělal tool call (žádný `⏺ Task(...)`)	CC se rozhodl odpovědět přímo	Explicit: „Použij Task tool, ne odpovídej sám.”
`Explore` neexistuje (`unknown subagent_type`)	Stará CC verze	Nahraď za `general-purpose` ve všech příkladech
Sub-agent vrátil generika / halucinace	Naivní prompt — sub-agent nemá kontext	Doplň do description: téma, úroveň, formát, omezení
Sub-agent ignoroval část úkolu	Moc dlouhý / nejasný prompt	Zúži, jeden cíl, čistá struktura
SKILL.md krok 7 (Task) se nedrží	Non-determinism CC interpretace	Light path — manuální volání po skillu
Memory data nepředávají se sub-agentu	Skill nezavolal `list_memories`	Explicitně v SKILL.md kroku 7: „PŘED Task ZAVOLEJ list_memories”
Vysoké náklady	Příliš mnoho zbytečných sub-agent volání	Použít sub-agent jen na velké oddělitelné úkoly, ne na 1-2 věty

💰 Cost reference

Sub-agent volání = plnohodnotný API request (1× tokeny per call)
Free tier / přísný limit → omez na ~5 sub-agent volání/den
Placený plán → sleduj /cost v CC, sub-agenti se počítají
Pravidlo: sub-agent stojí za to u velkých oddělitelných úkolů, ne u 1-2větých odpovědí

📚 Externí zdroje

Zdroj	URL	Co tam je
Sub-agents docs (oficiální)	code.claude.com/docs/en/sub-agents	Custom subagenty, configuration
Subagents in SDK	code.claude.com/docs/en/agent-sdk/subagents	API přístup
Tech With Tim — Subagents kapitola	youtube.com/watch?v=uogzSxOw4LU&t=1544s	Video z Dne 5 (25:44–33:08)

💡 Jedna věta k zapamatování pro Den 6

Sub-agent je tvůj specialista, kterého posíláš s úkolem do druhé místnosti — vidí jen list úkolu (description), nic víc. Pokud chceš dobrý výstup, dej mu na list všechno potřebné.