artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

Terminal-Sitzungsmanager für KI-Agenten. Ermöglicht das Starten, Überwachen und Abrufen von Ergebnissen untergeordneter Claude-Sitzungen.

Sub-Agent starten

Trigger: "starte agent", "starte sub-agent", "launch sub-agent"

Einfacher Start (CLI-Befehle)

# Sitzung erstellen
agent-deck add -t "Name" -c claude /pfad/zum/arbeitsverzeichnis

# Als untergeordnete Sitzung des aktuellen Agenten erstellen
agent-deck add -t "Name" --parent "Elternagent" -c claude /pfad/zum/arbeitsverzeichnis

# Starten
agent-deck session start "Name"

# Aufgabe senden
agent-deck session send "Name" "Deine Aufgabe..."

Automatischer Start (Skript)

scripts/launch-subagent.sh "Name" "Prompt" [--mcp exa] [--wait]

Das Skript führt automatisch folgende Schritte aus:

• Ermittelt die aktuelle Sitzung und das Profil
• Erstellt eine untergeordnete Sitzung
• Wartet auf die Claude-Initialisierung
• Sendet den Prompt

Modi zum Abrufen des Ergebnisses

Modus	Befehl	Wann verwenden
Fire & forget	(ohne --wait)	Standard. Sage: "Frag mich, wenn es fertig ist"
On-demand	agent-deck session output "Name"	Wenn der Benutzer danach fragt
Blocking	--wait	Sofortiges Ergebnis erforderlich

---

Status prüfen

Trigger: "prüfe sitzung", "prüfe status", "check session"

agent-deck status                         # Alle Sitzungen (Zusammenfassung)
agent-deck session show "Name"            # Details einer bestimmten Sitzung
agent-deck session show -json "Name"      # JSON-Format
agent-deck session current                # Aktuelle Sitzung (in der wir arbeiten)
agent-deck session current --json         # Aktuelle Sitzung als JSON

Status:

• ● läuft (running)
• ◐ wartet auf Eingabe (waiting)
• ○ im Leerlauf (idle)
• ✕ Fehler (error)

---

Ergebnis abrufen

Trigger: "zeige agenten-ausgabe", "was hat der agent geantwortet", "show agent output"

agent-deck session output "Name"

---

MCP-Verbindung

agent-deck mcp list                          # Verfügbare MCP-Server auflisten
agent-deck mcp attach "Name" exa             # MCP an Sitzung anhängen
agent-deck session restart "Name"            # NACH dem Anhängen ERFORDERLICH!

Empfohlene MCP

Aufgabe	MCP-Server
Websuche	exa, firecrawl
Code-Dokumentation	context7
Komplexe Überlegungen	sequential-thinking

---

Sitzungen verwalten

# Lebenszyklus
agent-deck session start "Name"
agent-deck session stop "Name"
agent-deck session restart "Name"

# Alle Sitzungen auflisten
agent-deck ls
agent-deck ls -json

# Sitzung löschen
agent-deck rm "Name"

---

Wichtige Regeln

1. Flags vor Argumenten: session show -json name (nicht session show name -json)
2. Nach mcp attach muss session restart folgen, um die Änderungen zu übernehmen
3. Polling von Ergebnissen anderer Agenten vermeiden – dies kann die Ziel-Sitzung stören
4. Identifikation einer Sitzung: Name, ID (≥6 Zeichen) oder Pfad können verwendet werden

---

Anwendungsbeispiele

Forschungsagent starten

# Agent für Web-Recherche erstellen
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Finde Informationen zu den neuesten Trends in der KI"

Bereitschaft prüfen

# Status prüfen
agent-deck session show "Researcher"

# Wenn Status ◐ (waiting) – Agent ist fertig, Ergebnis abrufen:
agent-deck session output "Researcher"