Claude Code Subagent

In Claude Code können Siespezialisierte KI-Subagentenerstellen, um bestimmte Arten von Aufgaben zu erledigen und dabei eine bessere Kontextisolierung, eine stärkere Einschränkungskontrolle und eine höhere Ausführungseffizienz zu erreichen.

Subagenten laufen inunabhängigen Kontextfenstern. Jeder Subagent kann über einen eigenen System-Prompt, ein festgelegtes Modell, explizite Berechtigungen für den Tool-Zugriff, unabhängige Berechtigungsmodi und sitzungsübergreifenden persistenten Speicher verfügen. Wenn Claude feststellt, dass deine Anfrage der Beschreibung eines Subagenten entspricht, delegiert es die Aufgabe automatisch an diesen Subagenten, der sie eigenständig abschließt und das Ergebnis zurückgibt.

Subagenten erhalten nur ihren eigenen System-Prompt und grundlegende Umgebungsinformationen (wie das Arbeitsverzeichnis),und erben nicht den vollständigen System-Prompt von Claude Code,was ein reines und kontrollierbares Verhalten gewährleistet.


Warum Subagenten verwenden

Der Kernwert von Subagenten liegt inIsolation + Spezialisierung,was sich vor allem in den folgenden Aspekten zeigt:

Hauptgesprächskontext bewahren: Verlege "schwere Aufgaben" wie Exploration und Log-Analyse in Subagenten, sodass das Hauptgespräch nur Zusammenfassungen der Ergebnisse erhält und nicht mit großen Mengen an Zwischenausgaben überflutet wird. Untersuchungen zeigen, dass die parallele Ausführung von drei Subagenten zur Analyse eines Projekts mit 50.000 Zeilen etwa 45 Sekunden dauert, während die serielle Ausführung 3 Minuten benötigt.

Einschränkungen durchsetzen: Begrenze die Fähigkeiten von Subagenten durch Tool-Whitelists oder -Blacklists, z. B. schreibgeschützte Analyse oder das Verbot gefährlicher Befehle.

Verhaltensspezialisierung: Entwirf dedizierte KI für bestimmte Domänen (Code-Review, Debugging, Datenanalyse) und gib die Fähigkeitsgrenzen des Agenten klar im System-Prompt an, um unnötige Aufrufe zu vermeiden.

Kosten kontrollieren: Weise einfache Aufgaben Haiku und komplexe Analysen Sonnet zu und verwende Umgebungsvariablen, umCLAUDE_CODE_SUBAGENT_MODELdas von allen Subagenten verwendete Modell einheitlich festzulegen.

Projektübergreifende Wiederverwendung: Subagenten auf Benutzerebene werden einmal konfiguriert und sind in allen Projekten verfügbar.


Subagent vs. Multi-Agent

Diese beiden Konzepte sind leicht zu verwechseln; der Unterschied liegt in der Aufgabengranularität und im Ausführungsumfang:

Vergleichspunkt Subagent Multi-Agent
Ausführungsbereich Wird innerhalb einer einzelnen Claude Code-Sitzung gestartet und gibt Ergebnisse nach der Verarbeitung von Teilaufgaben zurück Mehrere Claude Code-Sitzungen werden parallel oder seriell ausgeführt, typischerweise von einem Orchestrator verwaltet.
Kontext Unabhängiges Kontextfenster, von der Hauptunterhaltung isoliert. Jede Sitzung hat einen vollständig unabhängigen Kontext.
Verschachtelung Subagenten können keine weiteren Subagenten erstellen (verwenden Sie Skills, wenn Verschachtelung erforderlich ist). Kann mehrstufige Aufgaben über einen Orchestrator koordinieren.
Anwendungsfälle Fokussierte Teilaufgaben, Isolation großer Ausgaben, spezialisierte Analyse. Vollwertige Entwicklungs-Pipeline (Design → Implementierung → Test → Release).

Integrierte Subagenten

Claude Code wird mit mehreren integrierten Subagenten geliefert, die normalerweise automatisch verwendet werden und keine manuelle Konfiguration erfordern.

1. Explore (Explorations-Agent)

Wird für die schreibgeschützte Suche und Analyse der Codebasis verwendet. Das Modell verwendet standardmäßig Haiku (schnell, geringe Latenz), und es sind nur schreibgeschützte Tools aktiviert (kein Edit/Write). Wenn Claude Code ansehen muss, ohne ihn zu verändern, verwendet es automatisch den Explore-Agenten. Es unterstützt verschiedene Explorationstiefen:quick、medium、very thorough。

2. Plan (Planungs-Agent)

Sammelt im Planungsmodus Codebasisinformationen, um Claude dabei zu helfen, die Projektstruktur zu verstehen und Kontext für die anschließende Lösungsgestaltung aufzubauen. Es sind nur schreibgeschützte Tools aktiviert, was das sichere Sammeln von Planungsinformationen ermöglicht, ohne verschachtelte Agenten zu erstellen.

3. General-purpose (Allzweck-Agent)

Wird für komplexe, mehrstufige Aufgaben verwendet. Alle Tools sind aktiviert, und es übernimmt das Modell aus der Hauptkonversation. Es eignet sich für umfassende Szenarien von „Ansehen + Ändern + Schlussfolgern“ und für Aufgaben, die mehrstufige Codeänderungen erfordern.

4. Weitere interne Agenten

Agentenname Beschreibung
Bash Führt Shell-Befehle in einem unabhängigen Kontext aus
statusline-setup Konfiguriert die Anzeige der Terminal-Statusleiste
Claude Code-Anleitung Beantworten Sie Fragen zur Nutzung von Claude Code

Erstellen Sie Ihren ersten Subagenten

1. Öffnen Sie die Subagent-Verwaltungsoberfläche

Führen Sie den folgenden Befehl in Claude Code aus, um die vollständige Subagent-Verwaltungsoberfläche zu öffnen:

/agents

Diese Oberfläche bietet alle Funktionen zur Subagent-Verwaltung: alle verfügbaren Agenten anzeigen (integriert / Benutzerebene / Projektebene / Plugin), neue Agenten erstellen, vorhandene Agenten bearbeiten und sehen, welche Version bei einem Namenskonflikt tatsächlich wirksam wird.

2. Wählen Sie, einen Subagenten auf Benutzerebene zu erstellen

Wählen Sie in der OberflächeNeuen Agenten erstellen:

wählen Sie dannProjekt (.claude/agents/)Die Agentendatei wird im Verzeichnis .claude/agents/ im aktuellen Verzeichnis gespeichert. Wenn Sie~/.claude/agents/Verzeichnis auswählen, wird es für alle Projekte wirksam:

Claudes Empfehlung verwenden:

3. Beschreiben Sie die Verantwortlichkeiten des Agenten

Sie können Claude direkt in natürlicher Sprache sagen, was dieser Agent tun soll, und Claude generiert automatisch den System-Prompt und die anfängliche Konfiguration. Zum Beispiel:

A code improvement agent that scans project files, makes suggestions for readability, performance, and best practices, and provides improvement examples.

Nach der Generierung drücken Sie dieeTaste, um alle Konfigurationsinhalte manuell zu bearbeiten.

4. Tool-Berechtigungen und Modell konfigurieren

  • Nur Code-Review → nur schreibgeschützte Tools auswählen (Read / Grep / Glob)
  • Code muss geändert werden → Edit / Write-Tools beibehalten
  • Für das Modell wird empfohlen,Sonnetzu wählen, das eine ausgewogene Mischung aus Analysefähigkeit und Ausführungsgeschwindigkeit bietet.

Wählen Sie einfach Continue und drücken Sie Enter:

Drücken Sie für die folgenden Optionen einfach Enter, um die Standardwerte zu akzeptieren.

5. Speicherbereich auswählen (optional)

  • Wählen SieUser: um~/.claude/agent-memory/einen persistenten Speicher einzurichten und Erfahrungen über alle Projekte hinweg zu sammeln
  • Wählen SieNone: Lernergebnisse nicht beibehalten, bei jeder Aufgabe von vorn beginnen.

6. Verwenden Sie den soeben erstellten Agenten

使用 code-improver 子代理为此项目提出改进建议

Der Agent läuft in einem unabhängigen Kontext und gibt nach Abschluss eine Zusammenfassung der Ergebnisse an die Hauptkonversation zurück.


Geltungsbereich von Subagenten

Ein Subagent ist im Wesentlichen eine Markdown-Datei mit YAML-Frontmatter; sein Speicherort bestimmt seinen Geltungsbereich und seine Priorität:

Speicherort Geltungsbereich Priorität
CLI --agentsFlag Nur aktuelle Sitzung Höchste
.claude/agents/ Aktuelles Projekt Hoch
~/.claude/agents/ Alle Projekte (global) Mittel
Plugin-Agenten Plugin-Geltungsbereich Am niedrigsten

Wenn Subagenten mit demselben Namen an verschiedenen Speicherorten vorhanden sind, überschreibt der mit höherer Priorität den mit niedrigerer Priorität. Sie können den/agentsBefehl verwenden, um zu prüfen, welche Version tatsächlich wirksam ist.

Empfehlungen für die Wahl eines Speicherorts: Projekt-Agent (.claude/agents/) können für die gemeinsame Nutzung im Team mit dem Code committet werden; User-Agenten (~/.claude/agents/) speichern persönliche Gewohnheiten und allgemeine Werkzeuge, die projektübergreifend wirksam sind; CLI-Agenten (--agents) sind für temporäre Tests oder Automatisierungsskripte gedacht und werden nicht auf der Festplatte gespeichert.


Struktur der Konfigurationsdatei

Jede Subagent-Konfigurationsdatei besteht aus zwei Teilen: YAML-Frontmatter (Metadaten und Konfiguration) und Markdown-Body (System-Prompt).

Beispiel

---
name
: code-reviewer                    # Erforderlich: eindeutige Kennung, Kleinbuchstaben + Bindestriche
description
: Überprüft Code auf Qualität, Best Practices und Sicherheitsprobleme.
             Aufrufen, wenn der Benutzer eine Überprüfung, ein Audit oder eine Codequalitätsprüfung anfordert.
             # Erforderlich: bestimmt, wann Claude diesen Agenten aufruft; empfohlenes Format ist "wann aufzurufen + was er kann"
tools
: Read, Grep, Glob                # Tool-Whitelist (nur diese Tools können verwendet werden)
model
: sonnet                          # Angegebenes Modell: haiku / sonnet / opus / inherit
permissionMode
: default                # Berechtigungsmodus (siehe Abschnitt „Berechtigungsmodi“ unten)
memory
: project                        # Persistenter Memory-Geltungsbereich (siehe Abschnitt „Memory“ unten)
---

Du bist ein Senior-Code-Reviewer.
Analysiere Code und gib umsetzbares Feedback, nach Schweregrad geordnet
: Kritisch / Schwerwiegend / Geringfügig.

Aktualisiere den Speicher deines Agenten mit wiederkehrenden Mustern, Konventionen und bekannten Problemen, die du entdeckst.

Vollständige Feldbeschreibung

Feld Erforderlich Beschreibung
name Erforderlich Eindeutige Kennung, auch der Name, der für den expliziten Aufruf verwendet wird. Format: Kleinbuchstaben + Bindestriche, z. B.code-reviewer
description Erforderlich Das wichtigste Feld; ob und wann Claude diesen Agenten automatisch aufruft, hängt vollständig davon ab, also beschreibe die Nutzungsszenarien unbedingt klar
tools Optional Tool-Whitelist; sobald festgelegt, können nur die aufgeführten Tools verwendet werden, und MCP-Tools sind ebenfalls ausgeschlossen
disallowedTools Optional Tool-Blacklist; erbt alle Tools aus der Hauptunterhaltung, schließt jedoch die aufgeführten Tools aus (MCP-Tools bleiben erhalten)
model Optional Angegebenes Modell; kann festgelegt werden aufhaiku、sonnet、opus, eine vollständige Modell-ID, oderinherit(Standard, erbt von der Hauptunterhaltung)
permissionMode Optional Steuerung des Berechtigungsverhaltens, siehe den Abschnitt Berechtigungsmodi unten
memory Optional Persistenter Speicherbereich:user / project / local, siehe den Abschnitt Memory unten
background Optional Wenn festgelegt auftrue, läuft der Agent immer im Hintergrund (blockiert nicht die Hauptkonversation)
isolation Optional Wenn festgelegt aufworktree, läuft in einem temporären git worktree, vollständig vom Haupt-Repository isoliert
skills Optional Liste der Skills, die automatisch geladen werden, wenn dieser Agent startet
hooks Optional Lebenszyklus-Hooks:SubagentStart / SubagentStop / PreToolUse / PostToolUse

Unterschied zwischen tools und disallowedTools

Konfigurationsmethode Verhalten Typisches Szenario
Weder noch festgelegt Erbt alle Tools aus der Hauptkonversation, einschließlich MCP-Tools Allzweck-Agenten, die keine Einschränkungen benötigen
Nur gesetzttools Kann nur Tools aus der Whitelist verwenden; MCP-Tools sind ausgeschlossen Analyse-Agenten mit Nur-Lese-Zugriff, streng eingeschränkte Szenarien
Nur gesetztdisallowedTools Erbt alle Tools, schließt Tools auf der Blacklist aus, MCP-Tools bleiben erhalten Behält MCP-Funktionen bei, verbietet jedoch Schreibvorgänge
Beide gesetzt AnwendendisallowedToolszuerst, dann aus den verbleibenden Tools filtern nachtools Feingranulare Steuerung des Tool-Zugriffs

Beispiel

# Beispiel 1: Nur Leseoperationen zulassen (unter Verwendung der Tools-Whitelist)
---
name
: safe-researcher
description
: Recherche-Agent mit Nur-Lese-Zugriff. Verwenden, wenn Code analysiert wird, ohne Änderungen vorzunehmen.
tools
: Read, Grep, Glob, Bash    # Nur diese vier Tools sind aktiviert; Write und Edit sind nicht in der Whitelist und können nicht verwendet werden
---

Beispiel

# Beispiel 2: Alle Tools erben, aber das Schreiben von Dateien verbieten (mithilfe der disallowedTools-Blacklist)
---
name
: no-writes
description
: Analyse-Agent, der alle Tools außer Dateischreibvorgängen erbt.
disallowedTools
: Write, Edit     # MCP-Tools bleiben erhalten; nur Write und Edit sind ausgeschlossen
---

Berechtigungsmodi

DurchpermissionModeFeld steuert das Berechtigungsverhalten, wenn der Subagent Vorgänge ausführt:

Mode Verhalten Anwendungsfall
default Normale Berechtigungsabfrage, fragt den Benutzer vor jedem Vorgang Allgemeine Szenarien, empfohlene Standardeinstellung
acceptEdits Dateibearbeitungen automatisch akzeptieren, keine Bestätigung bei jedem Mal erforderlich Agenten, die häufig Dateien ändern und dadurch Interaktionsunterbrechungen reduzieren
dontAsk Nicht autorisierte Vorgänge automatisch ablehnen, ohne den Ausführungsfluss zu unterbrechen Strikte Nur-Lese-Szenarien, bei fehlgeschlagenem Vorgang stillschweigend überspringen
bypassPermissions Alle Berechtigungsprüfungen überspringen und direkt ausführen Nur für vollständig vertrauenswürdige, kontrollierte automatisierte Umgebungen
plan Planungsmodus mit Nur-Lese-Zugriff, führt keine Schreibvorgänge aus Planerstellung, Architekturanalyse

bypassPermissionsNur für vollständig vertrauenswürdige Subagenten geeignet. Darüber hinaus übernehmen Subagentenden Berechtigungsmodus der übergeordneten Sitzung– wenn die Hauptsitzung Bypass aktiviert, umgehen alle Subagenten ebenfalls. Mit äußerster Vorsicht verwenden.


Persistentes Gedächtnis (Memory)

ÜbermemoryFelder: Subagenten können Wissen über Sitzungen hinweg ansammeln, wie Codebasis-Muster, Debugging-Erfahrung, Architekturentscheidungen usw., ohne jedes Mal neu erkunden zu müssen.

Scope-Werte Speicherort Anwendbare Szenarien
user ~/.claude/agent-memory/<name>/ Agentenwissen gilt für alle Projekte, wie allgemeine Code-Review-Standards
project .claude/agent-memory/<name>/ Wissen ist an das Projekt gebunden und kann über git unter Teammitgliedern geteilt werden (empfohlene Standardeinstellung)
local .claude/agent-memory-local/<name>/ Wissen ist an das Projekt gebunden, wird aber nicht in git committet; nur als persönliche lokale Erfahrung gespeichert

Beispiel

---
name
: code-reviewer
description
: Überprüft Code auf Qualität und Best Practices. Beim Überprüfen von Codeänderungen aufrufen.
memory
: user    # Speicher auf Benutzerebene: Review-Erfahrung projektübergreifend sammeln
---

Sie sind ein Code-Reviewer.
Während Sie Code überprüfen, aktualisieren Sie das Gedächtnis Ihres Agenten mit Mustern, Konventionen
und wiederkehrenden Problemen, die Sie in dieser Codebasis entdecken.

Steuern Sie, wie das Gedächtnis in der Konversation verwendet wird:

  • Vor dem Start der Aufgabe:Please consult your memory first before starting the review.(Lassen Sie den Agenten vorhandene Erfahrung nutzen)
  • Nach Ende der Aufgabe:After the task is completed, save the patterns you discovered to memory.(Kontinuierliche Ansammlung)
  • Sie können auch direkt eine Anweisung wie „Gedächtnis proaktiv pflegen“ in den System-Prompt schreiben, sodass der Agent sie automatisch ausführt, ohne dass jedes Mal manuell erinnert werden muss.

Worktree-Isolationsmodus

Einmal konfiguriertisolation: worktreeDer Subagent läuft in einem temporären Git-Worktree, vollständig vom Haupt-Repository isoliert. Geeignet für die folgenden Szenarien:

  • Explorative Aufgaben, die umfangreiche Dateiänderungen mit ungewissem Ausgang erfordern
  • Mehrere Lösungsvergleiche parallel ausführen, ohne dass sie sich gegenseitig beeinträchtigen
  • Vorgänge, die eine saubere Umgebung erfordern, wie automatisiertes Testen und CI-Validierung

Beispiel

---
name
: experimental-refactor
Beschreibung
: Probiert Refactoring-Ansätze in einem isolierten Worktree aus.
             Verwenden, wenn riskantes Refactoring erkundet wird, das den Hauptbranch nicht beeinflussen soll.
Isolation
: worktree    # In einem temporären Worktree ausführen; Änderungen wirken sich nicht auf das Haupt-Repository aus
Werkzeuge
: Read, Write, Edit, Bash
---

Du bist ein Refactoring-Agent, der in einer isolierten Umgebung arbeitet.
Du kannst gerne Änderungen vornehmen – sie wirken sich nicht auf den Hauptbranch aus.
Fasse zusammen, was du geändert hast und ob der Ansatz erfolgreich war.

Hintergrundausführung (Background)

Subagenten unterstützen sowohl Vordergrund- als auch Hintergrundausführungsmodi mit unterschiedlichem Verhalten:

Ausführungsmodus Verhalten Einschränkungen
Vordergrund Blockiert die Hauptkonversation bis zum Abschluss; Berechtigungsaufforderungen und Klärungsfragen werden in Echtzeit an den Benutzer weitergegeben Keine besonderen Einschränkungen
Hintergrund Wird parallel ausgeführt, ohne die Hauptkonversation zu unterbrechen; erforderliche Berechtigungen werden vor dem Start im Voraus bestätigt Kann MCP nicht verwenden, kann keine interaktive Klärung durchführen; Aufgaben schlagen aufgrund unzureichender Berechtigungen fehl, anstatt zu pausieren und zu warten

Claude entscheidet automatisch anhand der Aufgabenmerkmale, ob Vordergrund oder Hintergrund verwendet wird. Sie können es auch manuell steuern:

  • Ctrl + B: Den aktuell laufenden Subagenten in den Hintergrund verschieben
  • Ctrl + F(zweimal drücken zum Bestätigen): Alle Hintergrund-Agenten beenden
  • In Frontmatter festlegenbackground: true: Dieser Agent läuft immer im Hintergrundmodus
  • Der Nachricht voranstellen&: Die Aufgabe als Hintergrundaufgabe an den claude.ai-Webclient senden
  • Über/tasksBefehl, Fortschritt der Hintergrundaufgabe jederzeit prüfen

Um die Hintergrundaufgaben-Funktion vollständig zu deaktivieren, legen Sie die folgenden Umgebungsvariablen fest:

export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1

Um das von allen Subagenten verwendete Modell einheitlich festzulegen (z. B. Opus für komplexes Reasoning im Hauptgespräch und Sonnet in Subagenten verwenden, um Kosten zu sparen):

export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"

Lebenszyklus-Hooks (Hooks)

Subagenten unterstützen die folgenden Hook-Ereignisse, die in Automatisierungsszenarien wie Protokollierung, Operationsvalidierung und Ergebnisbenachrichtigung verwendet werden können:

Hook-Ereignis Auslösezeitpunkt Typische Anwendungsfälle
SubagentStart Wenn ein Subagent startet Startprotokolle aufzeichnen, Umgebung initialisieren
SubagentStop Wenn die Aufgabe des Subagenten abgeschlossen ist Ergebnisse aufzeichnen, nachgelagerte Aufgaben auslösen, Benachrichtigungen senden. Beinhaltetagent_idundagent_transcript_pathFeld
PreToolUse Vor dem Tool-Aufruf Zulässigkeit der Operation validieren; ein Skript-Exit-Code von 2 kann den Tool-Aufruf blockieren
PostToolUse Nach dem Tool-Aufruf Ausgabe formatieren, Änderungsprotokolle generieren

Erweiterte Nutzung: Werkzeugverhalten dynamisch steuern überPreToolUseHooks. Zum Beispiel: Erlaube einem Datenbank-Agenten, nur schreibgeschützte SQL-Abfragen auszuführen, wobei alle Schreiboperationen vom Skript abgefangen werden:

Beispiel

---
name
: db-analyst
description
: Schreibgeschützter Datenbankanalyse-Agent. Verwende ihn zum Abfragen und Berichten, niemals für Schreibvorgänge.
tools
: Bash
# Hooks in .claude/settings.json konfigurieren:
# PreToolUse für Bash -> validate-readonly-query.sh
# Wenn das Skript eine Nicht-SELECT-Operation erkennt, gibt es Exit-Code 2 zurück und blockiert die Befehlsausführung
---

Du bist ein Datenbank-Analyst. Führe nur SELECT-Abfragen aus.
Führe niemals INSERT, UPDATE, DELETE, DROP oder irgendwelche DDL-Anweisungen aus.

Deaktivieren bestimmter Subagenten

Wenn du nicht möchtest, dass Claude automatisch einen bestimmten integrierten Subagenten aufruft, kannst du.claude/settings.jsonihn zur Deaktivierungsliste hinzufügen in:

Beispiel

{
  "subagents": {
"deny": ["explore", "plan"] // Deaktiviere die eingebauten explore- und plan-Agenten
// Nach dem Deaktivieren wird Claude sie nicht automatisch aufrufen, aber du kannst sie weiterhin explizit manuell aufrufen
  }
}

So rufst du Subagenten auf

1. Automatische Delegation

Claude wird automatisch anhand desdescriptionFeldes ermitteln, ob eine Aufgabe für einen Subagenten geeignet ist, ohne dass du dies manuell im Prompt angeben musst:

Help me check the quality of recent code changes.

2. Expliziter Aufruf

Gib im Prompt explizit an, welchen Agenten du verwenden möchtest:

让 code-reviewer 子代理检查最近的改动

Typische Nutzungsmuster

1. Aufgaben mit hohem Ausgabevolumen isolieren

Verlagern Sie Aufgaben, die eine große Menge an Zwischenausgaben erzeugen (wie das Ausführen von Tests oder das Durchsuchen von Protokollen), in Subagenten, und die Hauptkonversation erhält nur prägnante Schlussfolgerungen:

Use a subagent to run all tests, returning only failed tests and root cause analysis.

2. Parallele Recherche

Starten Sie mehrere Subagenten gleichzeitig, um verschiedene Module zu bearbeiten, wodurch die Analysezeit erheblich reduziert wird:

并行使用子代理分别分析认证模块、数据库模块和 API 模块,汇总后给出整体架构建议

3. Verkettung von Subagenten-Pipelines

Zerlegen Sie einen komplexen Workflow in mehrere spezialisierte Agenten, wobei Ergebnisse sequenziell weitergegeben werden:

先用 code-reviewer 找出问题,再用 optimizer 子代理修复这些问题

Entwurfsprinzip für verkettete Workflows: Jeder Agent erledigt nur eine Aufgabe und definiert seine Schnittstelle durch ein klares "Eingabe → Verarbeitung → Ausgabe → Übergabesignal". Nachfolgend ein dreistufiges Pipeline-Beispiel aus der Produktionspraxis:

  • pm-spec: Anforderungen lesen, Arbeitsspezifikation erstellen, nach Bestätigung markierenREADY_FOR_ARCH
  • architect-review: Design-Einschränkungen überprüfen, Architektur-Entscheidungsdokument (ADR) erstellen, markierenREADY_FOR_BUILD
  • implementer-tester: Code und Tests implementieren, Dokumentation aktualisieren, markierenDONE

DurchSubagentStopHooks, die auf Statusdateien lauschen, lösen automatisch den nächsten Agenten aus, ohne manuelles Eingreifen.

4. Parallele Codeüberprüfung

同时启动 style-checker、security-scanner、test-coverage 三个子代理并行审查,
将审查时间从数分钟压缩到数十秒

Wann sollten Sie Subagenten verwenden

Szenarien, die für Subagenten geeignet sind:

  • Aufgaben sind eigenständig, mit klarer Eingabe und erwarteter Ausgabe
  • Die Ausgabe ist groß und würde den Hauptkonversationskontext erheblich beanspruchen
  • Starke Einschränkungen erforderlich (schreibgeschützt, isolierter Worktree usw.)
  • Ähnliche Aufgaben treten wiederholt auf, es lohnt sich, sie als Agenten zu kodifizieren
  • Umfasst mehrere unabhängige Subdomänen, die parallel verarbeitet werden können

Szenarien, die für die Hauptkonversation geeignet sind:

  • Erfordert häufige wechselseitige Anpassungen, hochgradig interaktiv
  • Mehrstufige Aufgaben haben starke Abhängigkeiten, der Kontext muss kontinuierlich bleiben
  • Schnelle, kleine Änderungen, bei denen sich der Aufwand für den Start eines Agenten nicht lohnt
  • Praktische Erfahrung: Nach mehr als 3–4 Subagenten kann der Verwaltungsaufwand die Gesamteffizienz tatsächlich verringern

Subagenten können keine weiteren Subagenten erstellen (um unendliche Verschachtelung zu verhindern). Wenn Sie verschachtelte Logik benötigen, verwenden SieSkills。


Best Practices

Wie man Beschreibungen schreibt

  • Verwenden Sie handlungsorientierte Beschreibungen:Invoke when the user requests reviewing / analyzing / checking code quality.
  • Vorbedingungen angeben:Use after the specification document is confirmed, producing architecture decision records.
  • Beschreiben Sie klar die Grenzen des Agenten und Szenarien, in denen er nicht gut ist, um eine falsche Aufrufung zu verhindern

Tool-Berechtigungsdesign (Prinzip der geringsten Berechtigung)

  • Nur-Lese-Agenten (Überprüfung, Audit):Read, Grep, Glob
  • Recherche-Agenten (Informationsbeschaffung):Read, Grep, Glob, WebFetch, WebSearch
  • Implementierungs-Agenten (Code schreiben):Read, Write, Edit, Bash, Glob, Grep

Eindeutige Verantwortlichkeit

  • Jeder Agent macht nur eine Sache, mit klaren Regeln für Eingabe/Ausgabe/Übergabe
  • Versuchen Sie nicht, einen Agenten alles machen zu lassen

System-Prompt-Vorschläge

  • Legen Sie die Persönlichkeit des Agenten im System-Prompt fest:Please remain critical, don't just say nice things.
  • Weisen Sie auf die Schwächen und Einschränkungen des Agenten hin, um Selbstüberschätzung zu vermeiden
  • Wenn der Speicher aktiviert ist, fügen Sie die Anweisung „Speicher aktiv pflegen“ in den System-Prompt ein, damit der Agent sie automatisch ausführt

Wahl zwischen parallel und seriell

  • Subdomains sind unabhängig voneinander → parallel bevorzugen, um Zeit zu sparen
  • Nächster Schritt hängt vom vorherigen Ergebnis ab → seriell ausführen, um Qualität zu gewährleisten
  • Vermeiden Sie Parallelität um ihrer selbst willen: 10 parallele Agenten, die einfache Aufgaben bearbeiten, verschwenden Tokens und Koordinationskosten
Weitere Erweiterungen