Directives d'utilisation de Xcode MCP pour les agents IA

name: xcode-mcp-for-pi-agent description: Directives pour une utilisation efficace des outils Xcode MCP via l'interface CLI mcporter. 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 jetons - ne l'utiliser que pour les builds, tests, simulateur, aperçus et diagnostics SourceKit. Ne jamais l'utiliser pour les opérations de lecture/écriture/grep de fichiers. Utiliser cette compétence à chaque fois que vous travaillez avec des projets Xcode, des builds iOS/macOS, des aperçus SwiftUI ou le développement de plateformes Apple. # Directives d'utilisation de Xcode MCP Les outils Xcode MCP sont accessibles via l'interface CLI `mcporter`, qui fait le pont entre les serveurs MCP et les outils en ligne de commande standard. Cette compétence définit quand utiliser Xcode MCP et quand préférer les outils standard. ## Configuration Xcode MCP doit être configuré dans `~/.mcporter/mcporter.json` : ```json { "mcpServers": { "xcode": { "command": "xcrun", "args": ["mcpbridge"], "env": {} } } } ``` Vérifier la connexion : ```bash mcporter list xcode ``` --- ## Appel des outils Tous les outils Xcode MCP sont appelés via mcporter : ```bash # Lister les outils disponibles mcporter list xcode # Appeler un outil avec des arguments clé:valeur mcporter call xcode.<tool_name> param1:value1 param2:value2 # Appeler avec une syntaxe de fonction mcporter call 'xcode.<tool_name>(param1: "value1", param2: "value2")' ``` --- ## Référence complète des outils Xcode MCP ### Gestion des fenêtres et des projets | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Lister les fenêtres Xcode ouvertes (obtenir tabIdentifier) | `mcporter call xcode.XcodeListWindows` | Faible | ### Opérations de build | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Builder le projet Xcode | `mcporter call xcode.BuildProject` | Moyen | | Obtenir le journal de build avec erreurs/avertissements | `mcporter call xcode.GetBuildLog` | Moyen | | Lister les problèmes dans le navigateur de problèmes | `mcporter call xcode.XcodeListNavigatorIssues` | Faible | ### Tests | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Obtenir les tests disponibles du plan de test | `mcporter call xcode.GetTestList` | Faible | | Exécuter tous les tests | `mcporter call xcode.RunAllTests` | Moyen | | Exécuter des tests spécifiques (préféré) | `mcporter call xcode.RunSomeTests` | Moyen | ### Aperçu et exécution | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Rendre un aperçu SwiftUI | `mcporter call xcode.RenderPreview` | Moyen | | Exécuter un extrait de code dans le contexte du fichier | `mcporter call xcode.ExecuteSnippet` | Moyen | ### Diagnostics | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Obtenir les diagnostics du compilateur pour un fichier spécifique | `mcporter call xcode.XcodeRefreshCodeIssuesInFile` | Faible | | Obtenir les diagnostics SourceKit (tous les fichiers ouverts) | `mcporter call xcode.getDiagnostics` | Faible | ### Documentation | Outil | Appel mcporter | Coût en jetons | |-------|----------------|---------------| | Rechercher dans la documentation développeur Apple | `mcporter call xcode.DocumentationSearch` | Faible | ### Opérations sur fichiers (COÛT ÉLEVÉ EN JETONS - NE JAMAIS UTILISER) | Outil MCP | Utiliser à la place | Pourquoi | |-----------|---------------------|----------| | `xcode.XcodeRead` | Outil `Read` / `cat` | Consommation élevée de jetons | | `xcode.XcodeWrite` | Outil `Write` | Consommation élevée de jetons | | `xcode.XcodeUpdate` | Outil `Edit` | Consommation élevée de jetons | | `xcode.XcodeGrep` | `rg` / `grep` | Consommation élevée de jetons | | `xcode.XcodeGlob` | `find` / `glob` | Consommation élevée de jetons | | `xcode.XcodeLS` | Commande `ls` | Consommation élevée de jetons | | `xcode.XcodeRM` | Commande `rm` | Consommation élevée de jetons | | `xcode.XcodeMakeDir` | Commande `mkdir` | Consommation élevée de jetons | | `xcode.XcodeMV` | Commande `mv` | Consommation élevée de jetons | --- ## Flux de travail recommandés ### 1. Flux de modification de code et build ``` 1. Rechercher du code -> rg "pattern" --type swift 2. Lire le fichier -> Outil Read / cat 3. Modifier le fichier -> Outil Edit 4. Vérification syntaxe -> mcporter call xcode.getDiagnostics 5. Build -> mcporter call xcode.BuildProject 6. Vérifier les erreurs -> mcporter call xcode.GetBuildLog (si le build échoue) ``` ### 2. Flux d'écriture et d'exécution de tests ``` 1. Lire le fichier de test -> Outil Read / cat 2. Écrire/modifier le test -> Outil Edit 3. Obtenir la liste des tests -> mcporter call xcode.GetTestList 4. Exécuter les tests -> mcporter call xcode.RunSomeTests (tests spécifiques) 5. Vérifier les résultats -> Examiner la sortie du test ``` ### 3. Flux d'aperçu SwiftUI ``` 1. Modifier la vue -> Outil Edit 2. Rendre l'aperçu -> mcporter call xcode.RenderPreview 3. Itérer -> Répéter si nécessaire ``` ### 4. Flux de débogage ``` 1. Vérifier les diagnostics -> mcporter call xcode.getDiagnostics 2. Builder le projet -> mcporter call xcode.BuildProject 3. Obtenir le journal -> mcporter call xcode.GetBuildLog severity:error 4. Corriger les problèmes -> Outil Edit 5. Reconstruire -> mcporter call xcode.BuildProject ``` ### 5. Recherche de documentation ``` 1. Rechercher la doc -> mcporter call xcode.DocumentationSearch query:"SwiftUI NavigationStack" 2. Examiner les résultats -> Utiliser les informations dans l'implémentation ``` --- ## Commandes de repli (Quand MCP ou mcporter est indisponible) Si Xcode MCP est déconnecté, mcporter n'est pas installé ou la connexion échoue, utilisez ces commandes xcodebuild directement : ### Commandes de build ```bash # Build de débogage (simulateur) - remplacez <SchemeName> par le schéma de votre projet xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build de version (appareil) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build avec espace de travail (pour les projets CocoaPods) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build avec fichier de 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 mcporter + Xcode MCP Pour : - `xcode.BuildProject` - Builds - `xcode.GetBuildLog` - Erreurs de build - `xcode.RunSomeTests` - Exécution de tests spécifiques - `xcode.GetTestList` - Liste des tests - `xcode.RenderPreview` - Aperçus SwiftUI - `xcode.ExecuteSnippet` - Exécution de code - `xcode.DocumentationSearch` - Documentation Apple - `xcode.XcodeListWindows` - Obtenir tabIdentifier - `xcode.getDiagnostics` - Erreurs SourceKit ### NE JAMAIS UTILISER Xcode MCP Pour : - `xcode.XcodeRead` -> Utiliser l'outil `Read` / `cat` - `xcode.XcodeWrite` -> Utiliser l'outil `Write` - `xcode.XcodeUpdate` -> Utiliser l'outil `Edit` - `xcode.XcodeGrep` -> Utiliser `rg` ou `grep` - `xcode.XcodeGlob` -> Utiliser `find` / `glob` - `xcode.XcodeLS` -> Utiliser la commande `ls` - Opérations sur fichiers -> Utiliser les outils standard --- ## Résumé de l'efficacité des jetons | Opération | Meilleur choix | Impact sur les jetons | |-----------|----------------|----------------------| | Vérification syntaxe rapide | `mcporter call xcode.getDiagnostics` | Faible | | Build complet | `mcporter call xcode.BuildProject` | Moyen | | Exécuter des tests spécifiques | `mcporter call xcode.RunSomeTests` | Moyen | | Exécuter tous les tests | `mcporter call xcode.RunAllTests` | Élevé | | Lire un fichier | Outil `Read` / `cat` | Faible | | Modifier un fichier | Outil `Edit` | Faible | | Rechercher du code | `rg` / `grep` | Faible | | Lister les fichiers | `ls` / `find` | Faible |