Deskbird-Automator

Verwende diesen Skill, um Deskbird ueber das lokale CLI (scripts/deskbird_tool.py) sicher zu bedienen und optional als wiederkehrende Cron-Session laufen zu lassen.

Voraussetzungen

• Arbeite im Projektordner <repo-root>.
• Nutze bevorzugt diese CLI-Kommandos:
  • ./scripts/deskbird.sh auth-check
  • ./scripts/deskbird.sh auth-refresh --format json
  • ./scripts/deskbird.sh auth-import --stdin --format json
  • ./scripts/deskbird.sh discovery
  • ./scripts/deskbird.sh parking-status
  • ./scripts/deskbird.sh parking-book-first
  • Setup bei frischem Upload:
    • python3 -m venv .venv
    • source .venv/bin/activate
    • pip install -r requirements.txt
    • python -m playwright install chromium
    • chmod +x scripts/deskbird.sh
• Halte den Schonmodus aktiv (DESKBIRD_SAFE_MODE=true) und sende keine Request-Stuerme.
• Fuer Telegram-Reauth standardmaessig nur DevTools-Paste + auth-import verwenden.
• auth-pair-* und auth-capture nicht als Standard im Chat vorschlagen.

Deterministischer Env-Pfad

• Verwende fuer alle Skill-Aufrufe den Wrapper ./scripts/deskbird.sh.
• Der Wrapper setzt automatisch --env-file <skill-root>/.env und verhindert damit CWD-bedingte Auth-Fehler.
• Nur bei gezieltem Debugging darfst du --env-file explizit auf eine andere Datei setzen.

Empfohlene Dauer-Auth (Broker-Basis)

• Hinterlege nach einmaliger Ermittlung in der Skill-.env:
  • DESKBIRD_FIREBASE_API_KEY
  • DESKBIRD_FIREBASE_REFRESH_TOKEN
• Dann kann der Agent automatisch per auth-refresh einen neuen Bearer holen, ohne jeden Login-Flow.

Pflichtdialog Vor Automatisierung

Wenn noch keine passende Cron-Session existiert, frage den Nutzer in genau dieser Reihenfolge:

1. Soll ich eine wiederkehrende Cron-Session dafuer anlegen?
2. Wenn ja: Welcher Rhythmus? Default ist taeglich um 00:30 Uhr (Europe/Berlin), ein Lauf fuer den naechsten 24h-Blick.
3. Was soll die Session pro Lauf genau tun?
   Falls unklar, biete als Defaults an:
   • Nur Uebersicht ueber alle buchbaren Objekte senden
   • Uebersicht + Parkplatz automatisch buchen, wenn Regel erfuellt ist
   • Nur monitoren, nie buchen
4. Fasse Name, Rhythmus und Session-Aufgabe zusammen und hole eine letzte Bestaetigung ein.

Wenn der Nutzer keinen Rhythmus nennt, setze den Default: taeglich 00:30 (Europe/Berlin).

Reauth-Protokoll (immer vor Deskbird-Calls)

Fuehre vor Discovery/Status/Buchung immer zuerst aus:

./scripts/deskbird.sh auth-check --format json --min-valid-minutes 90

Auswertung: