Back to PodcastsClaude
Claude Code subagents
Designing effective subagents
Now that you know how to create sub aents, let's look at patterns that lead to effective sub aents.
Da Sie nun wissen, wie Sie Subagenten erstellen, schauen wir uns Muster an, die zu effektiven Subagenten führen.
First, let's get a better idea of how subit data in the sub aent config file is used.
Zunächst wollen wir besser verstehen, wie die Daten in der Konfigurationsdatei des Subagenten verwendet werden.
Whenever you send a message to the main context window agent, the name and description of each sub aent is included in the system prompt.
Wenn Sie dem Hauptagenten eine Nachricht senden, werden Name und Beschreibung jedes Subagenten in den system prompt aufgenommen.
So, if you want to better control when the main agent launches a sub agent automatically, you should modify the name and description.
Um besser zu steuern, wann der Hauptagent einen Subagenten automatisch startet, sollten Sie Name und Beschreibung anpassen.
Next, remember that when a sub agent is launched, the main agent writes an input prompt.
Denken Sie daran: Wenn ein Subagent gestartet wird, erstellt der Hauptagent einen Eingabe-Prompt.
When writing this input prompt, it uses the description as guidance.
Beim Verfassen dieses Eingabe-Prompts nutzt er die Beschreibung als Orientierung.
So, if you want to better control when the main agent launches a sub agent automatically, you should modify the name and description.
Um besser zu steuern, wann der Hauptagent einen Subagenten automatisch startet, sollten Sie Name und Beschreibung anpassen.
Let's consider our review sub aent again.
Schauen wir uns unseren Review-Subagenten noch einmal an.
Right now, when the main agent runs this sub agent, the sub aent is given an input prompt telling it to use get diff to find the current changes.
Derzeit erhält der Subagent, wenn ihn der Hauptagent ausführt, einen Eingabe-Prompt, der ihn anweist, get diff zu verwenden, um die aktuellen Änderungen zu finden.
If we wanted the main agent to more reliably tell the sub agent exactly which files to review, we would update the description.
Wenn wir möchten, dass der Hauptagent dem Subagenten zuverlässiger mitteilt, welche Dateien er reviewen soll, würden wir die Beschreibung aktualisieren.
You must tell the agent precisely which files you want it to review.
Sie müssen dem Agenten genau angeben, welche Dateien er reviewen soll.
Now, if we ask claw to run the code reviewer agent, we'll see a different input.
Wenn wir Claude nun bitten, den Code-Review-Agenten auszuführen, sehen wir eine andere Eingabe.
You can also influence what the main thread tells a sub agent through the description.
Sie können auch über die Beschreibung beeinflussen, was der Hauptthread einem Subagenten mitteilt.
So adding return sources that can be cited to a web search sub aents description causes the main thread to include that instruction when delegating the task.
Das Hinzufügen von zitierbare Quellen zurückgeben in die Beschreibung eines Web-Such-Subagenten bewirkt, dass der Hauptthread diese Anweisung beim Delegieren der Aufgabe einbezieht.
The most important improvement that you can make is defining an output format in the system prompt.
Die wichtigste Verbesserung ist die Definition eines Ausgabeformats im system prompt.
This creates natural stopping points for the sub aent.
Das schafft natürliche Haltepunkte für den Subagenten.
Without a defined output format, sub aents struggle to decide when enough research has been done and they tend to run much much longer than sub agents that are given an output format.
Ohne definiertes Ausgabeformat haben Subagenten Schwierigkeiten zu entscheiden, wann genug recherchiert wurde, und sie neigen dazu, viel länger zu laufen als Subagenten mit einem Ausgabeformat.
When a sub agent discovers a workaround to some issue like solving a dependency issue or finding that a certain command needs particular flags, these details should appear in the summary.
Wenn ein Subagent einen Workaround für ein Problem entdeckt, etwa das Lösen einer Abhängigkeit oder die Feststellung, dass ein Befehl bestimmte Flags benötigt, sollten diese Details in der Zusammenfassung erscheinen.
Otherwise, the main thread has to rediscover the same solutions, obstacles encountered, any setup issues, workarounds discovered or environment quirks, commands that needed special flags or configuration, dependencies or imports that cause problems.
Sonst muss der Hauptthread dieselben Lösungen neu entdecken: aufgetretene Hindernisse, Einrichtungsprobleme, gefundene Workarounds, Eigenheiten der Umgebung, Befehle mit speziellen Flags oder Konfigurationen, problematische Abhängigkeiten oder Importe.
Explicitly asking for obstacle reporting in the output format surfaces this information.
Das explizite Anfordern eines Hindernisberichts im Ausgabeformat bringt diese Informationen ans Licht.
A readonly sub aent using just glob grap read cannot accidentally modify files.
Ein schreibgeschützter Subagent, der nur glob, grep und read nutzt, kann keine Dateien versehentlich ändern.
This constraint clarifies that the sub aents role and prevents unintended side effects.
Diese Einschränkung klärt die Rolle des Subagenten und verhindert unbeabsichtigte Nebeneffekte.
So think about what sub aents actually needs to do.
Überlegen Sie also, was Subagenten tatsächlich tun müssen.
If it's just researching it only needs to read files.
Wenn er nur recherchiert, benötigt er nur Lesezugriff.
So keep it read only.
Halten Sie ihn also schreibgeschützt.
That way it can't accidentally modify anything while exploring.
So kann er beim Erkunden nichts versehentlich ändern.
A reviewer needs to run get diff to see what changed.
Ein Review-Agent muss get diff ausführen, um zu sehen, was sich geändert hat.
So give it bash access, but it still doesn't need to edit files.
Geben Sie ihm also bash-Zugriff, aber er benötigt trotzdem keine Dateibearbeitung.
Only give edit and write to sub aents that should actually change your code, like a styling agent applying CSS updates.
Vergeben Sie edit und write nur an Subagenten, die Ihren Code tatsächlich ändern sollen, wie einen Styling-Agenten, der CSS-Aktualisierungen anwendet.
This also helps clarify what each sub aent is for when you have several of them.
Das hilft auch dabei zu klären, wofür jeder Subagent zuständig ist, wenn Sie mehrere davon haben.
So effective sub aents use structured output report obstacles have specific descriptions and limit tool access.
Effektive Subagenten verwenden also strukturierte Ausgaben, melden Hindernisse, haben spezifische Beschreibungen und begrenzen den Werkzeugzugriff.