STOP. LESEN SIE DIESES GESAMTE SKILL.MD, BEVOR SIE EINEN ENDPUNKT AUFRUFEN.
Agenten-Posteingang
Dateibasierte Kommunikation zwischen Agenten mit Headless-Dispatch und Task-Monitor-Integration.
Kernablauf
- Senden: Agent A sendet Bug/Anfrage an Projekt B mit Modell + Verifikationsbefehl
- Triage: KI klassifiziert den Schweregrad, passt Priorität/Modell an, leitet an das Projekt weiter
- Dispatch: Headless-Agent wird mit dem angegebenen Modell gestartet, um das Problem zu beheben
- Verfolgen: Der Task-Monitor zeigt den Fortschritt in Echtzeit an (0 % → 25 % → 50 % → 75 % → 100 %)
- Verifizieren: Vor der automatischen Bestätigung wird ein Testbefehl ausgeführt – bei Fehlschlag wird der Vorgang an den Agenten zurückgegeben
- Threading: Antwort-/Austausch-Threading für mehrteilige Gespräche
Einrichtung
# Projekte registrieren (einmalig)
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# Auflisten / überprüfen
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
Befehle
| Befehl | Beschreibung |
|---|---|
register <name> <pfad> | Ein Projekt registrieren |
unregister <name> | Ein Projekt entfernen |
projects [--json] | Registrierte Projekte auflisten |
whoami | Ermitteltes Projekt für das aktuelle Arbeitsverzeichnis anzeigen |
send --to PROJEKT --type TYP "nachricht" | Nachricht senden (Typen: bug, request, info, question) |
check [--project P] [--all] [--quiet] | Posteingang prüfen |
list [--project P] [--status S] [--json] | Nachrichten auflisten |
read NACHRICHT_ID [--json] | Eine Nachricht lesen |
ack NACHRICHT_ID [--note "..."] | Bestätigen/abschließen |
reply NACHRICHT_ID "nachricht" | Antworten (automatisches Threading) |
thread THREAD_ID | Vollständigen Austausch-Thread anzeigen |
update-status NACHRICHT_ID STATUS [--note] | Status manuell aktualisieren |
triage classify --message "..." [--no-llm] | Manuelle Triage-Klassifizierung |
triage route --message "..." | Automatische Weiterleitung anhand von Dateipfaden |
triage log --msg-id ID | Triage-Entscheidungsprotokoll anzeigen |
triage webhook-add --url URL --events E | Webhook registrieren |
Sendeoptionen
| Option | Beschreibung | Standard |
|---|---|---|
--model MODELL | KI-Modell: sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTEN | Maximale Arbeitszeit des Agenten | 30 |
--test BEFEHL | Verifikationsbefehl vor automatischer Bestätigung | Keiner |
--no-dispatch | Automatischen Start deaktivieren | False |
--context-file DATEI | Datei als Kontext anhängen (wiederholbar) | Keiner |
--priority PRIORITÄT | low, normal, high, critical | normal |
--no-triage | KI-Triage überspringen | False |
--dry-run | Nachrichten-JSON anzeigen, ohne zu senden | False |
Modellauswahl
| Modell | Anwendungsfall |
|---|---|
sonnet | Einfache Korrekturen, Tippfehler |
opus-4.5 | Komplexe Analyse, Architektur |
codex-5.2 | Standard-Fehlerbehebungen |
codex-5.2-high | Tiefgreifende Analyse, Wettlaufsituationen |
KI-Triage
Nachrichten werden automatisch nach Schweregrad klassifiziert:
- critical: Absturz, Datenverlust, Sicherheit, Produktionsausfall →
opus-4.5 - high: Fehler, Ausnahme, Fehlschlag, defekt, Regression →
opus-4.5 - medium: Bug, Problem, falsch, unerwartet →
sonnet - low: Tippfehler, kosmetisch, Verbesserung, geringfügig →
sonnet
Die automatische Weiterleitung extrahiert Dateipfade aus Nachrichten und gleicht sie mit den registrierten Projekten ab.
Statusverlauf
pending → dispatched (25 %) → in_progress (50 %) → needs_verification (75 %) → done (100 %)
Gedächtnis-Vorbereitung
Der Dispatcher fragt /memory ab, bevor er einen Agenten startet, um ähnliche Fehler und frühere Lösungen zu finden.
Proaktive Überprüfung
Agenten sollten den Posteingang zu Session-Beginn, beim Wechsel von Projekten, vor größeren Arbeiten und wenn Benutzer einen anderen Agenten oder ein anderes Projekt erwähnen, überprüfen.
Speicher
~/.agent-inbox/
├── pending/ # Unverarbeitete Nachrichten
├── done/ # Bestätigte Nachrichten
├── logs/ # Dispatch-Protokolle
├── task_states/ # Task-Monitor-Zustandsdateien
├── triage_logs/ # KI-Triage-Entscheidungsprotokolle
├── webhooks.json # Registrierte Webhooks
└── projects.json # Projektregister
Beispiele
# Bug mit Verifikation senden (startet Headless-Opus-Agent, bestätigt automatisch, wenn der Test bestanden wird)
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"Wettlaufsituation in der Provider-Initialisierung"
# Kontextdateien anhängen
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"Serverabsturz beim Start"
# Posteingang prüfen und verarbeiten
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "Behoben in Commit abc123"
# Thread-Austausch
python inbox.py reply scillm_abc123 "Können Sie den Stack-Trace bereitstellen?"
python inbox.py thread scillm_abc123
Dispatcher-Daemon
python dispatcher.py start # Hintergrund
python dispatcher.py start --foreground # Debug
python dispatcher.py status
python dispatcher.py stop
Umgebungsvariablen
| Variable | Beschreibung | Standard |
|---|---|---|
AGENT_INBOX_DIR | Posteingangsverzeichnis | ~/.agent-inbox |
TASK_MONITOR_API_URL | Task-Monitor-URL | http://localhost:8765 |
CLAUDE_PROJECT | Name des aktuellen Projekts | automatisch erkannt |
Integration mit Claude Code Hooks
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}