Communitygithub.com

dimillian/ios-debugger-agent

Verwenden Sie XcodeBuildMCP, um das aktuelle iOS-Projekt auf einem gestarteten Simulator zu bauen, auszuführen, zu starten und zu debuggen. Wird ausgelöst, wenn eine iOS-App ausgeführt, die Simulator-Benutzeroberfläche bedient, der Bildschirmstatus untersucht, Protokolle/Konsolenausgabe erfasst oder das Laufzeitverhalten mit XcodeBuildMCP-Tools diagnostiziert werden soll.

Was ist ios-debugger-agent?

Dieses Skill ermöglicht es einem KI-Agenten, iOS-Projekte direkt über den Simulator zu bauen, auszuführen und zu debuggen – komplett ohne Xcode manuell bedienen zu müssen. Es nutzt die MCP-Tools von XcodeBuildMCP, um Builds zu starten, Apps auf einem laufenden Simulator zu installieren und zu starten, die Simulator-Oberfläche zu bedienen (z. B. Tippen, Wischen), den aktuellen Bildschirminhalt zu analysieren sowie Konsolenlogs und Fehlerausgaben zu erfassen. Der Agent eignet sich besonders für das Testen der Benutzerinteraktion, das Untersuchen von UI-Zuständen und das schnelle Reproduzieren von Fehlern während der iOS-Entwicklung. Hauptzielplattform ist der iOS-Simulator in Verbindung mit XcodeBuildMCP; die Implementierung erfolgt über prozessgesteuerte Befehle, Toolaufrufe und Bildschirmaufnahmen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dimillian/skills/tree/main/skills/ios-debugger-agent

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht ios-debugger-agent?

Verwenden Sie XcodeBuildMCP, um das aktuelle iOS-Projekt auf einem gestarteten Simulator zu bauen, auszuführen, zu starten und zu debuggen. Wird ausgelöst, wenn eine iOS-App ausgeführt, die Simulator-Benutzeroberfläche bedient, der Bildschirmstatus untersucht, Protokolle/Konsolenausgabe erfasst oder das Laufzeitverhalten mit XcodeBuildMCP-Tools diagnostiziert werden soll.

Beschreibung

Dieser Skill ermöglicht es einem KI-Agenten, den vollständigen Entwicklungszyklus einer iOS-App im Simulator zu automatisieren: Bauen, Installieren, Starten und Debuggen – ohne manuelle Eingriffe in Xcode. Der Agent kann den Simulator steuern (Tippen, Wischen, Texteingabe), visuelle Zustände über Screenshots auswerten und Laufzeitlogs sowie Fehlermeldungen erfassen.

Hauptfunktionen

  • Automatischer Build und Start – Projekt mit xcodebuild bauen, installieren und im Simulator starten.
  • Simulator-Steuerung – Tippen, Wischen, Tastatureingaben und andere UI-Interaktionen ausführen.
  • Bildschirm-Inspektion – Screenshots des Simulators erfassen und den UI-Zustand analysieren.
  • Log-Erfassung – Konsolenlogs (os_log, NSLog), Absturzberichte und Build-Fehler auslesen.
  • Fehlerdiagnose – Laufzeitfehler identifizieren und auf Basis von Logs und Screenshots beheben.

Verwendung

  1. Simulator starten – Der Agent startet bei Bedarf einen Simulator (z. B. iPhone 15 Pro).
  2. Build ausführen – xcodebuild baut das Projekt und installiert die App im Simulator.
  3. App starten – Die App wird im Simulator geöffnet.
  4. UI bedienen – Der Agent führt gewünschte Aktionen aus (Navigation, Eingaben, Gesten).
  5. Auswertung – Screenshots und Logs werden analysiert, um Ergebnisse oder Fehler zu melden.

Voraussetzungen

  • Xcode Command Line Tools installiert.
  • XcodeBuildMCP konfiguriert und verfügbar.
  • Ein iOS-Simulator (z. B. „iPhone 15 Pro“) als Zielplattform.
  • Das iOS-Projekt muss über ein gültiges .xcodeproj oder .xcworkspace und Build-Konfiguration verfügen.

Beispiel-Interaktion

Benutzer: „Starte die App und tippe auf den Login-Button.“

Agent:

  1. Baut das Projekt (xcodebuild -project ... -scheme ... -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build).
  2. Installiert die App im Simulator (xcrun simctl install booted ...).
  3. Startet die App (xcrun simctl launch booted ...).
  4. Macht einen Screenshot und analysiert die Position des Login-Buttons.
  5. Tippt auf die entsprechende Koordinate (xcrun simctl ...).
  6. Macht einen weiteren Screenshot zur Bestätigung und gibt die Logs aus.

Plattformen

  • Ziel: iOS Simulator (via Xcode Build System)
  • Werkzeug: XcodeBuildMCP (als MCP-Server)
  • Agent: Claude Code, Cursor, Codex oder andere MCP-kompatible KI-Agenten

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

dimillian/app-store-changelog

Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref). Use when asked to generate a comprehensive release changelog, App Store "What's New" text, or release notes based on git history or tags.

dimillian/macos-spm-app-packaging

Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project. Use when you need a from-scratch macOS app layout, SwiftPM targets/resources, a custom .app bundle assembly script, or signing/notarization/appcast steps outside Xcode.

dimillian/swift-concurrency-expert

Swift Concurrency review and remediation for Swift 6.2+. Use when asked to review Swift Concurrency usage, improve concurrency compliance, or fix Swift concurrency compiler errors in a feature or file. Concrete actions include adding Sendable conformance, applying @MainActor annotations, resolving actor isolation warnings, fixing data race diagnostics, and migrating completion handlers to async/await.

dimillian/swiftui-liquid-glass

Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API. Use when asked to adopt Liquid Glass in new SwiftUI UI, refactor an existing feature to Liquid Glass, or review Liquid Glass usage for correctness, performance, and design alignment.

dimillian/swiftui-performance-audit

Audit and improve SwiftUI runtime performance from code review and architecture. Use for requests to diagnose slow rendering, janky scrolling, high CPU/memory usage, excessive view updates, or layout thrash in SwiftUI apps, and to provide guidance for user-run Instruments profiling when code review alone is insufficient.

dimillian/swiftui-ui-patterns

Best practices and example-driven guidance for building SwiftUI views and components, including navigation hierarchies, custom view modifiers, and responsive layouts with stacks and grids. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens with VStack/HStack, managing @State or @Binding, building declarative iOS interfaces, or needing component-specific patterns and examples.

dimillian/swiftui-view-refactor

Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage. Use when cleaning up a SwiftUI view, splitting long bodies, removing inline actions or side effects, reducing computed `some View` helpers, or standardizing `@Observable` and view model initialization patterns.

Verwandte Skills