Xcode MCP Nutzungsrichtlinien

--- name: xcode-mcp description: Richtlinien für die effiziente Nutzung der Xcode MCP-Tools. Diese Skill sollte verwendet werden, um zu verstehen, wann Xcode MCP-Tools im Vergleich zu Standard-Tools eingesetzt werden sollten. Xcode MCP verbraucht viele Tokens - nur für Build, Test, Simulator, Preview und SourceKit-Diagnosen verwenden. Nie für Datei-Lese-/Schreib-/Grep-Operationen verwenden. --- # Xcode MCP-Nutzungsrichtlinien Xcode MCP-Tools verbrauchen erhebliche Tokens. Diese Skill definiert, wann Xcode MCP verwendet werden sollte und wann Standard-Tools bevorzugt werden. ## Vollständige Xcode MCP-Tools-Referenz ### Fenster- und Projektverwaltung | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | Offene Xcode-Fenster auflisten (tabIdentifier erhalten) | Niedrig | ### Build-Operationen | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__BuildProject` | Das Xcode-Projekt bauen | Mittel | | `mcp__xcode__GetBuildLog` | Build-Log mit Fehlern/Warnungen abrufen | Mittel | | `mcp__xcode__XcodeListNavigatorIssues` | Probleme im Issue-Navigator auflisten | Niedrig | ### Testen | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__GetTestList` | Verfügbare Tests aus dem Testplan abrufen | Niedrig | | `mcp__xcode__RunAllTests` | Alle Tests ausführen | Mittel | | `mcp__xcode__RunSomeTests` | Bestimmte Tests ausführen (bevorzugt) | Mittel | ### Preview und Ausführung | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__RenderPreview` | SwiftUI-Preview-Snapshot rendern | Mittel | | `mcp__xcode__ExecuteSnippet` | Code-Snippet im Dateikontext ausführen | Mittel | ### Diagnose | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Compiler-Diagnosen für eine bestimmte Datei abrufen | Niedrig | | `mcp__ide__getDiagnostics` | SourceKit-Diagnosen abrufen (alle geöffneten Dateien) | Niedrig | ### Dokumentation | Tool | Beschreibung | Token-Kosten | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Apple-Entwicklerdokumentation durchsuchen | Niedrig | ### Dateioperationen (HOHE TOKEN - NIE VERWENDEN) | Tool | Alternative | Warum | |------|-------------|------| | `mcp__xcode__XcodeRead` | `Read`-Tool | Hoher Token-Verbrauch | | `mcp__xcode__XcodeWrite` | `Write`-Tool | Hoher Token-Verbrauch | | `mcp__xcode__XcodeUpdate` | `Edit`-Tool | Hoher Token-Verbrauch | | `mcp__xcode__XcodeGrep` | `rg` / `Grep`-Tool | Hoher Token-Verbrauch | | `mcp__xcode__XcodeGlob` | `Glob`-Tool | Hoher Token-Verbrauch | | `mcp__xcode__XcodeLS` | `ls`-Befehl | Hoher Token-Verbrauch | | `mcp__xcode__XcodeRM` | `rm`-Befehl | Hoher Token-Verbrauch | | `mcp__xcode__XcodeMakeDir` | `mkdir`-Befehl | Hoher Token-Verbrauch | | `mcp__xcode__XcodeMV` | `mv`-Befehl | Hoher Token-Verbrauch | --- ## Empfohlene Arbeitsabläufe ### 1. Code-Änderung und Build-Ablauf ``` 1. Code durchsuchen -> rg "pattern" --type swift 2. Datei lesen -> Read-Tool 3. Datei bearbeiten -> Edit-Tool 4. Syntaxprüfung -> mcp__ide__getDiagnostics 5. Build -> mcp__xcode__BuildProject 6. Fehler prüfen -> mcp__xcode__GetBuildLog (wenn Build fehlschlägt) ``` ### 2. Test-Schreiben und Ausführen-Ablauf ``` 1. Testdatei lesen -> Read-Tool 2. Test schreiben/bearbeiten -> Edit-Tool 3. Testliste abrufen -> mcp__xcode__GetTestList 4. Tests ausführen -> mcp__xcode__RunSomeTests (bestimmte Tests) 5. Ergebnisse prüfen -> Testausgabe überprüfen ``` ### 3. SwiftUI-Preview-Ablauf ``` 1. View bearbeiten -> Edit-Tool 2. Preview rendern -> mcp__xcode__RenderPreview 3. Iterieren -> Nach Bedarf wiederholen ``` ### 4. Debug-Ablauf ``` 1. Diagnosen prüfen -> mcp__ide__getDiagnostics (schnelle Syntaxprüfung) 2. Projekt bauen -> mcp__xcode__BuildProject 3. Build-Log abrufen -> mcp__xcode__GetBuildLog (severity: error) 4. Probleme beheben -> Edit-Tool 5. Neu bauen -> mcp__xcode__BuildProject ``` ### 5. Dokumentationssuche ``` 1. Dokumentation durchsuchen -> mcp__xcode__DocumentationSearch 2. Ergebnisse prüfen -> Informationen in der Implementierung verwenden ``` --- ## Fallback-Befehle (wenn MCP nicht verfügbar) Wenn Xcode MCP getrennt oder nicht verfügbar ist, verwenden Sie diese xcodebuild-Befehle: ### Build-Befehle ```bash # Debug-Build (Simulator) - <SchemeName> durch das Schema Ihres Projekts ersetzen xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Release-Build (Gerät) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build mit Workspace (für CocoaPods-Projekte) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build mit Projektdatei xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Verfügbare Schemata auflisten xcodebuild -list ``` ### Test-Befehle ```bash # Alle Tests ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Bestimmte Testklasse ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # Bestimmte Testmethode ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # Mit Code-Coverage ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # Verfügbare Simulatoren auflisten xcrun simctl list devices available ``` ### Clean Build ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## Schnellreferenz ### Xcode MCP VERWENDEN für: - `BuildProject` - Bauen - `GetBuildLog` - Build-Fehler - `RunSomeTests` - Bestimmte Tests ausführen - `GetTestList` - Tests auflisten - `RenderPreview` - SwiftUI-Previews - `ExecuteSnippet` - Code-Ausführung - `DocumentationSearch` - Apple-Dokumentation - `XcodeListWindows` - tabIdentifier abrufen - `mcp__ide__getDiagnostics` - SourceKit-Fehler ### Xcode MCP NIE VERWENDEN für: - `XcodeRead` -> `Read`-Tool verwenden - `XcodeWrite` -> `Write`-Tool verwenden - `XcodeUpdate` -> `Edit`-Tool verwenden - `XcodeGrep` -> `rg` oder `Grep`-Tool verwenden - `XcodeGlob` -> `Glob`-Tool verwenden - `XcodeLS` -> `ls`-Befehl verwenden - `XcodeRM` -> `rm`-Befehl verwenden - `XcodeMakeDir` -> `mkdir`-Befehl verwenden - `XcodeMV` -> `mv`-Befehl verwenden - Dateioperationen -> Standard-Tools verwenden --- ## Token-Effizienz-Zusammenfassung | Operation | Beste Wahl | Token-Auswirkung | |-----------|-------------|------------------| | Schnelle Syntaxprüfung | `mcp__ide__getDiagnostics` | Niedrig | | Vollständiger Build | `mcp__xcode__BuildProject` | Mittel | | Bestimmte Tests ausführen | `mcp__xcode__RunSomeTests` | Mittel | | Alle Tests ausführen | `mcp__xcode__RunAllTests` | Hoch | | Datei lesen | `Read`-Tool | Hoch | | Datei bearbeiten | `Edit`-Tool | Hoch | | Code durchsuchen | `rg` / `Grep` | Niedrig | | Dateien auflisten | `ls` / `Glob` | Niedrig |