Directives d'utilisation de Xcode MCP

--- name: xcode-mcp description: Directives pour une utilisation efficace des outils Xcode MCP. Cette compétence doit être utilisée pour comprendre quand utiliser les outils Xcode MCP par rapport aux outils standard. Xcode MCP consomme beaucoup de tokens - à utiliser uniquement pour le build, les tests, le simulateur, l'aperçu et les diagnostics SourceKit. Ne jamais utiliser pour les opérations de lecture/écriture/grep de fichiers. --- # Directives d'utilisation de Xcode MCP Les outils Xcode MCP consomment beaucoup de tokens. Cette compétence définit quand utiliser Xcode MCP et quand préférer les outils standard. ## Référence complète des outils Xcode MCP ### Gestion des fenêtres et du projet | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | Lister les fenêtres Xcode ouvertes (obtenir tabIdentifier) | Faible | ### Opérations de build | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__BuildProject` | Builder le projet Xcode | Moyen | | `mcp__xcode__GetBuildLog` | Obtenir le journal de build avec erreurs/avertissements | Moyen | | `mcp__xcode__XcodeListNavigatorIssues` | Lister les problèmes dans le navigateur de problèmes | Faible | ### Tests | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__GetTestList` | Obtenir les tests disponibles depuis le plan de test | Faible | | `mcp__xcode__RunAllTests` | Exécuter tous les tests | Moyen | | `mcp__xcode__RunSomeTests` | Exécuter des tests spécifiques (préféré) | Moyen | ### Aperçu et exécution | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__RenderPreview` | Rendre un aperçu SwiftUI | Moyen | | `mcp__xcode__ExecuteSnippet` | Exécuter un extrait de code dans le contexte du fichier | Moyen | ### Diagnostics | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Obtenir les diagnostics du compilateur pour un fichier spécifique | Faible | | `mcp__ide__getDiagnostics` | Obtenir les diagnostics SourceKit (tous les fichiers ouverts) | Faible | ### Documentation | Outil | Description | Coût en tokens | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Rechercher dans la documentation développeur Apple | Faible | ### Opérations sur fichiers (COÛT ÉLEVÉ - NE JAMAIS UTILISER) | Outil | Alternative | Pourquoi | |------|-------------|-----| | `mcp__xcode__XcodeRead` | Outil `Read` | Consommation de tokens élevée | | `mcp__xcode__XcodeWrite` | Outil `Write` | Consommation de tokens élevée | | `mcp__xcode__XcodeUpdate` | Outil `Edit` | Consommation de tokens élevée | | `mcp__xcode__XcodeGrep` | Outil `rg` / `Grep` | Consommation de tokens élevée | | `mcp__xcode__XcodeGlob` | Outil `Glob` | Consommation de tokens élevée | | `mcp__xcode__XcodeLS` | Commande `ls` | Consommation de tokens élevée | | `mcp__xcode__XcodeRM` | Commande `rm` | Consommation de tokens élevée | | `mcp__xcode__XcodeMakeDir` | Commande `mkdir` | Consommation de tokens élevée | | `mcp__xcode__XcodeMV` | Commande `mv` | Consommation de tokens élevée | --- ## Flux de travail recommandés ### 1. Flux de modification de code et de build ``` 1. Rechercher le code -> rg "pattern" --type swift 2. Lire le fichier -> Outil Read 3. Modifier le fichier -> Outil Edit 4. Vérification syntaxe -> mcp__ide__getDiagnostics 5. Build -> mcp__xcode__BuildProject 6. Vérifier les erreurs -> mcp__xcode__GetBuildLog (si le build échoue) ``` ### 2. Flux d'écriture et d'exécution de tests ``` 1. Lire le fichier de test -> Outil Read 2. Écrire/modifier le test -> Outil Edit 3. Obtenir la liste des tests -> mcp__xcode__GetTestList 4. Exécuter les tests -> mcp__xcode__RunSomeTests (tests spécifiques) 5. Vérifier les résultats -> Examiner la sortie des tests ``` ### 3. Flux d'aperçu SwiftUI ``` 1. Modifier la vue -> Outil Edit 2. Rendre l'aperçu -> mcp__xcode__RenderPreview 3. Itérer -> Répéter si nécessaire ``` ### 4. Flux de débogage ``` 1. Vérifier les diagnostics -> mcp__ide__getDiagnostics (vérification syntaxe rapide) 2. Builder le projet -> mcp__xcode__BuildProject 3. Obtenir le journal -> mcp__xcode__GetBuildLog (sévérité : erreur) 4. Corriger les problèmes -> Outil Edit 5. Reconstruire -> mcp__xcode__BuildProject ``` ### 5. Recherche de documentation ``` 1. Rechercher la doc -> mcp__xcode__DocumentationSearch 2. Examiner les résultats -> Utiliser l'information dans l'implémentation ``` --- ## Commandes de secours (lorsque MCP est indisponible) Si Xcode MCP est déconnecté ou indisponible, utilisez ces commandes xcodebuild : ### Commandes de build ```bash # Build Debug (simulateur) - remplacez <SchemeName> par le schéma de votre projet xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build Release (appareil) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build avec workspace (pour les projets CocoaPods) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build avec fichier projet xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Lister les schémas disponibles xcodebuild -list ``` ### Commandes de test ```bash # Exécuter tous les tests xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Exécuter une classe de test spécifique xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # Exécuter une méthode de test spécifique xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # Exécuter avec couverture de code xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # Lister les simulateurs disponibles xcrun simctl list devices available ``` ### Build propre ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## Référence rapide ### UTILISER Xcode MCP pour : - `BuildProject` - Build - `GetBuildLog` - Erreurs de build - `RunSomeTests` - Exécution de tests spécifiques - `GetTestList` - Liste des tests - `RenderPreview` - Aperçus SwiftUI - `ExecuteSnippet` - Exécution de code - `DocumentationSearch` - Documentation Apple - `XcodeListWindows` - Obtenir tabIdentifier - `mcp__ide__getDiagnostics` - Erreurs SourceKit ### NE JAMAIS UTILISER Xcode MCP pour : - `XcodeRead` -> Utiliser l'outil `Read` - `XcodeWrite` -> Utiliser l'outil `Write` - `XcodeUpdate` -> Utiliser l'outil `Edit` - `XcodeGrep` -> Utiliser `rg` ou l'outil `Grep` - `XcodeGlob` -> Utiliser l'outil `Glob` - `XcodeLS` -> Utiliser la commande `ls` - `XcodeRM` -> Utiliser la commande `rm` - `XcodeMakeDir` -> Utiliser la commande `mkdir` - `XcodeMV` -> Utiliser la commande `mv` - Opérations sur fichiers -> Utiliser les outils standard --- ## Résumé de l'efficacité des tokens | Opération | Meilleur choix | Impact en tokens | |-----------|-------------|--------------| | Vérification syntaxe rapide | `mcp__ide__getDiagnostics` | Faible | | Build complet | `mcp__xcode__BuildProject` | Moyen | | Exécuter des tests spécifiques | `mcp__xcode__RunSomeTests` | Moyen | | Exécuter tous les tests | `mcp__xcode__RunAllTests` | Élevé | | Lire un fichier | Outil `Read` | Élevé | | Modifier un fichier | Outil `Edit` | Élevé | | Rechercher du code | `rg` / `Grep` | Faible | | Lister les fichiers | `ls` / `Glob` | Faible |