Subagenti Claude Code

Co tato dovednost pokrývá

Stavba subagenta Claude Code — izolovaného workera s vlastním kontextovým oknem, system promptem, oprávněními k nástrojům a modelem, kterému hlavní session deleguje samostatnou úlohu a dostane zpět shrnutí. Důraz je na rozhodnutích, díky kterým je subagent spolehlivý: rozsah nástrojů, úroveň modelu a spouštěcí popis. Pro psaní persony agenta (těla system promptu) viz System prompty a AI persony.

Kdy ji použít

• Při vytváření specializovaného workera (recenzent kódu, spouštěč testů, výzkumník, autor dokumentace), kterého budete opakovaně používat
• Při převodu role nebo persony na něco, čemu může hlavní session delegovat práci
• Když chcete opakovatelného agenta podle týmových standardů místo jednorázového — pro rychlého obecného agenta je jednodušší vestavěný příkaz /agents
• Když chcete zamknout konkrétní model a minimální sadu nástrojů, aby se každé volání chovalo předvídatelně

Nejprve zvažte vestavěné řešení

Claude Code obsahuje vestavěné subagenty (Explore, Plan, general-purpose) a interaktivní tvůrce /agents. Pokud je potřeba obecná, použijte je. Vlastního agenta stavte, když chcete konvence specifické pro projekt, zamčený model, promyšlenou politiku nástrojů nebo standard pojmenování/validace sdílený celým týmem.

Definujte roli

Napište tělo system promptu: kdo agent je, co dělá při vyvolání a co vrací. Držte se jedné úlohy — subagent je dobrý na samostatnou úlohu, jejíž výstup lze shrnout. (Pro kvalitní napsání viz System prompty a AI persony.)

Vyberte nástroje — nejmenší oprávnění

Omezení nástrojů je klíčovou výhodou subagentů. Udělte jen to, co úloha potřebuje:

• Read-only worker (recenzent, průzkumník): Read, Grep, Glob
• Potřebuje spouštět příkazy: přidejte Bash
• Potřebuje upravovat soubory: přidejte Edit / Write

Neudělujte příliš. Recenzent, který umí jen číst, je bezpečnější a předvídatelnější než ten, který umí i zapisovat.

Vyberte úroveň modelu

Přizpůsobte náklady úloze a zamkněte úroveň ve frontmatteru, aby bylo každé volání předvídatelné:

• Haiku — lehká práce nebo náročná na čtení
• Sonnet — standardní úlohy
• Opus — složité uvažování

Napište silný description

Toto je nejdůležitější pole — je to, co hlavní session přiměje skutečně delegovat práci agentovi. Buďte konkrétní ohledně toho, kdy ho použít a na jaký typ úlohy. Vágní popisy vedou k ignorování agenta; příliš široké ho spouštějí u nesouvisející práce.

Vyberte rozsah a cestu

• Projekt: .claude/agents/<name>.md — commitnuto do repozitáře, sdíleno s týmem.
• Uživatel: ~/.claude/agents/<name>.md — dostupné napříč všemi vašimi projekty.

Sestavte soubor

---
name: <kebab-case-name>
description: <co dělá + konkrétní spouštěč KDY použít>
tools: Read, Grep, Glob
model: sonnet
---

You are <role>. When invoked, <what to do>.
Return <what the summary should contain>.

Před nasazením ověřte

Ověřte, že se frontmatter parsuje, name je unikátní a v kebab-case, tools je minimální sada, model je nastaven a description je dost konkrétní, aby se spouštěl správně. Poté agenta otestujte na reálné úloze, než se na něj spolehnete — subagenti běží v izolovaném kontextu a vracejí pouze svůj finální výsledek, takže slabý popis nebo chybějící nástroj se projeví až při skutečném vyvolání.