ADK-Ingenieur
Entwickle produktionsreife Agent Development Kit (ADK) Agenten und Multi-Agenten-Systeme: saubere Struktur, Testbarkeit, sichere Tool-Nutzung und Bereitstellungsautomatisierung.
Überblick
Verwende diesen Skill, um ADK-Agenten-Code zu entwerfen und zu implementieren, der wartbar und auslieferbar ist: klare Modulgrenzen, strukturierte Tool-Schnittstellen, Regressionstests und eine Bereitstellungs-Checkliste (lokal oder Agent Engine).
Voraussetzungen
- Eine Ziellaufzeit (Python/Java/Go), die mit den festgelegten Versionen des Projekts übereinstimmt
- ADK installiert (und alle erforderlichen Modell-/Provider-SDKs konfiguriert)
- Ein Test-Runner, der im Repository verfügbar ist (mindestens Komponententests)
- Bei Bereitstellung: Zugriff auf ein Google Cloud-Projekt und Berechtigungen für das gewählte Bereitstellungsziel
Anweisungen
- Kläre die Anforderungen: Agentenziele, Tool-Oberfläche, Latenz-/Kostenbeschränkungen und Bereitstellungsziel.
- Schlage eine Architektur vor: Einzel-Agent vs. Multi-Agent, Orchestrierungsmuster, Statusstrategie (Memory Bank / externer Speicher).
- Strukturiere das Gerüst: Agenten-Einstiegspunkt(e), Tool-Module, Konfiguration und Tests.
- Implementiere inkrementell:
- Füge jeweils ein Tool mit Eingabevalidierung und strukturierten Ausgaben hinzu
- Füge Regressionstests für jedes Tool und kritische Prompt-Abläufe hinzu
- Füge operative Schutzmaßnahmen hinzu: Wiederholungen/Backoff, Timeouts, Logging und sichere Fehlermeldungen.
- Validiere lokal (Tests + Smoke-Prompts) und erstelle einen Bereitstellungsplan (auf Anfrage).
Ausgabe
- Ein konkreter Architekturplan und Dateilayout
- Agenten- und Tool-Implementierungen (oder Patches) mit Tests
- Eine Validierungs-Checkliste (auszuführende Befehle, erwartete Ausgaben und Fehlerbehebung)
- Optional: Bereitstellungsanweisungen und Post-Deployment-Health-Checks
Fehlerbehandlung
- Build-/Testfehler: Isoliere das fehlerhafte Modul, minimiere die Reproduktion, behebe den Fehler und füge einen Regressionstest hinzu.
- Tool-/Laufzeitfehler: Erzwinge strukturierte Fehlerantworten und sichere Wiederholungen, wo angemessen.
- Bereitstellungsfehler: Gib den genauen fehlgeschlagenen Befehl, die zu überprüfenden Logs und IAM-Fixes mit minimalen Berechtigungen an.
Beispiele
Beispiel: Produktionsreif machen eines bestehenden ADK-Agenten
- Anfrage: "Überarbeite diesen Agenten in eine saubere Modulstruktur und füge Tests hinzu, bevor wir bereitstellen."
- Ergebnis: Neu organisierte
src/-Struktur, Tool-Grenzen, eine Testsuite und eine Bereitstellungs-Checkliste.
Beispiel: Multi-Agenten-Workflow
- Anfrage: "Baue ein Team aus Validator-, Deployer- und Monitor-Agenten mit einem sequenziellen Orchestrator."
- Ergebnis: Orchestrator-Grundgerüst, Verantwortlichkeiten pro Agent und Smoke-Tests für jeden Schritt.
Ressourcen
- Vollständiges detailliertes Playbook (als Referenz aufbewahrt):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Repository-Standards (maßgebliche Quelle):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine Dokumentation: https://cloud.google.com/vertex-ai/docs/agent-engine