callstackincubator/dogfood

Was macht dogfood?

Systematisches Erkunden und Testen einer mobilen App auf iOS/Android mit agent-device, um Bugs, UX-Probleme und andere Fehler zu finden. Verwenden Sie diesen Skill, wenn Sie aufgefordert werden, Dogfooding, QA, exploratives Testen, Fehlersuche, Bug Hunting oder das Testen einer mobilen App durchzuführen.

Funktionsweise

Der Skill callstackincubator/dogfood nutzt die agent-device-Schnittstelle, um einen KI-Agenten zu steuern, der methodisch durch eine mobile App navigiert. Dabei werden folgende Schritte ausgeführt:

1. Initialisierung: Der Agent verbindet sich mit einem Geräteemulator oder einem physischen Gerät (iOS/Android).
2. Exploration: Der Agent führt systematische Aktionen aus – Tippen, Wischen, Scrollen – um alle Bildschirme und Funktionen der App zu erkunden.
3. Analyse: Während der Exploration werden UI-Elemente, Ladezeiten, Abstürze und unerwartete Zustände aufgezeichnet und analysiert.
4. Bericht: Nach Abschluss wird ein strukturierter Testbericht erstellt, der gefundene Bugs, UX-Probleme und Vorschläge zur Verbesserung enthält.

Konfiguration

Parameter	Beschreibung	Standardwert
platform	Zielplattform (ios oder android)	android
app-path	Pfad zur App (.apk, .aab, .app)	–
device-name	Name des Zielgeräts	Pixel_4_API_30
timeout	Maximale Testdauer in Minuten	30

Verwendung

# Beispiel für die Verwendung mit agent-device
dogfood --platform ios --app-path ./build/MyApp.app --timeout 15

Ausgabe

Der Skill generiert folgende Artefakte:

• report.json: Strukturierte Liste gefundener Probleme mit Schweregrad und Beschreibung
• screenshots/: Automatisch erstellte Screenshots kritischer Fehlerzustände
• logs/: Detaillierte Logs aller durchgeführten Aktionen und Reaktionen der App

Voraussetzungen

• agent-device CLI muss installiert sein (npm install -g @callstackincubator/agent-device)
• Für iOS: Xcode und iOS-Simulator
• Für Android: Android Studio und Android-Emulator

Integration in CI/CD

# Beispiel für GitHub Actions
jobs:
  dogfood:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Dogfood test
        uses: callstackincubator/dogfood-action@v1
        with:
          platform: android
          app-path: ./app-release.apk

Fehlerbehebung

• Verbindungsfehler: Stellen Sie sicher, dass der Emulator oder das Gerät korrekt läuft und über ADB/Xcode erreichbar ist.
• Timeout: Bei großen Apps erhöhen Sie den timeout-Parameter.
• Keine Ergebnisse: Überprüfen Sie die Logs in logs/. Möglicherweise startet die App nicht oder ist nicht installiert.