Directrices de uso de Xcode MCP

--- name: xcode-mcp description: Directrices para el uso eficiente de las herramientas Xcode MCP. Esta habilidad debe usarse para comprender cuándo usar las herramientas Xcode MCP frente a las herramientas estándar. Xcode MCP consume muchos tokens - úsalo solo para build, test, simulador, preview y diagnósticos SourceKit. Nunca lo uses para operaciones de lectura/escritura/grep de archivos. --- # Directrices de uso de Xcode MCP Las herramientas Xcode MCP consumen tokens significativos. Esta habilidad define cuándo usar Xcode MCP y cuándo preferir herramientas estándar. ## Referencia completa de herramientas Xcode MCP ### Gestión de ventanas y proyectos | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | Listar ventanas Xcode abiertas (obtener tabIdentifier) | Bajo | ### Operaciones de build | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__BuildProject` | Compilar el proyecto Xcode | Medio | | `mcp__xcode__GetBuildLog` | Obtener registro de build con errores/advertencias | Medio | | `mcp__xcode__XcodeListNavigatorIssues` | Listar problemas en el Issue Navigator | Bajo | ### Pruebas | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__GetTestList` | Obtener pruebas disponibles del plan de pruebas | Bajo | | `mcp__xcode__RunAllTests` | Ejecutar todas las pruebas | Medio | | `mcp__xcode__RunSomeTests` | Ejecutar pruebas específicas (preferido) | Medio | ### Vista previa y ejecución | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__RenderPreview` | Renderizar instantánea de vista previa SwiftUI | Medio | | `mcp__xcode__ExecuteSnippet` | Ejecutar fragmento de código en contexto de archivo | Medio | ### Diagnósticos | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Obtener diagnósticos del compilador para archivo específico | Bajo | | `mcp__ide__getDiagnostics` | Obtener diagnósticos SourceKit (todos los archivos abiertos) | Bajo | ### Documentación | Herramienta | Descripción | Costo de tokens | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Buscar en Documentación para Desarrolladores de Apple | Bajo | ### Operaciones de archivos (ALTO TOKEN - NUNCA USAR) | Herramienta | Alternativa | Por qué | |------|-------------|-----| | `mcp__xcode__XcodeRead` | Herramienta `Read` | Alto consumo de tokens | | `mcp__xcode__XcodeWrite` | Herramienta `Write` | Alto consumo de tokens | | `mcp__xcode__XcodeUpdate` | Herramienta `Edit` | Alto consumo de tokens | | `mcp__xcode__XcodeGrep` | Herramienta `rg` / `Grep` | Alto consumo de tokens | | `mcp__xcode__XcodeGlob` | Herramienta `Glob` | Alto consumo de tokens | | `mcp__xcode__XcodeLS` | Comando `ls` | Alto consumo de tokens | | `mcp__xcode__XcodeRM` | Comando `rm` | Alto consumo de tokens | | `mcp__xcode__XcodeMakeDir` | Comando `mkdir` | Alto consumo de tokens | | `mcp__xcode__XcodeMV` | Comando `mv` | Alto consumo de tokens | --- ## Flujos de trabajo recomendados ### 1. Flujo de cambio de código y build ``` 1. Buscar código -> rg "patrón" --type swift 2. Leer archivo -> Herramienta Read 3. Editar archivo -> Herramienta Edit 4. Verificación de sintaxis -> mcp__ide__getDiagnostics 5. Build -> mcp__xcode__BuildProject 6. Verificar errores -> mcp__xcode__GetBuildLog (si el build falla) ``` ### 2. Flujo de escritura y ejecución de pruebas ``` 1. Leer archivo de prueba -> Herramienta Read 2. Escribir/editar prueba -> Herramienta Edit 3. Obtener lista de pruebas -> mcp__xcode__GetTestList 4. Ejecutar pruebas -> mcp__xcode__RunSomeTests (pruebas específicas) 5. Verificar resultados -> Revisar salida de pruebas ``` ### 3. Flujo de vista previa SwiftUI ``` 1. Editar vista -> Herramienta Edit 2. Renderizar vista previa -> mcp__xcode__RenderPreview 3. Iterar -> Repetir según sea necesario ``` ### 4. Flujo de depuración ``` 1. Verificar diagnósticos -> mcp__ide__getDiagnostics (verificación rápida de sintaxis) 2. Compilar proyecto -> mcp__xcode__BuildProject 3. Obtener registro de build -> mcp__xcode__GetBuildLog (severidad: error) 4. Corregir problemas -> Herramienta Edit 5. Recompilar -> mcp__xcode__BuildProject ``` ### 5. Búsqueda de documentación ``` 1. Buscar documentación -> mcp__xcode__DocumentationSearch 2. Revisar resultados -> Usar información en la implementación ``` --- ## Comandos de respaldo (cuando MCP no está disponible) Si Xcode MCP está desconectado o no disponible, usa estos comandos xcodebuild: ### Comandos de build ```bash # Build de depuración (simulador) - reemplaza <NombreEsquema> con el esquema de tu proyecto xcodebuild -scheme <NombreEsquema> -configuration Debug -sdk iphonesimulator build # Build de lanzamiento (dispositivo) xcodebuild -scheme <NombreEsquema> -configuration Release -sdk iphoneos build # Build con workspace (para proyectos CocoaPods) xcodebuild -workspace <NombreProyecto>.xcworkspace -scheme <NombreEsquema> -configuration Debug -sdk iphonesimulator build # Build con archivo de proyecto xcodebuild -project <NombreProyecto>.xcodeproj -scheme <NombreEsquema> -configuration Debug -sdk iphonesimulator build # Listar esquemas disponibles xcodebuild -list ``` ### Comandos de prueba ```bash # Ejecutar todas las pruebas xcodebuild test -scheme <NombreEsquema> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Ejecutar clase de prueba específica xcodebuild test -scheme <NombreEsquema> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<DestinoPrueba>/<NombreClasePrueba> # Ejecutar método de prueba específico xcodebuild test -scheme <NombreEsquema> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<DestinoPrueba>/<NombreClasePrueba>/<NombreMetodoPrueba> # Ejecutar con cobertura de código xcodebuild test -scheme <NombreEsquema> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # Listar simuladores disponibles xcrun simctl list devices available ``` ### Build limpio ```bash xcodebuild clean -scheme <NombreEsquema> ``` --- ## Referencia rápida ### USAR Xcode MCP Para: - `BuildProject` - Compilar - `GetBuildLog` - Errores de build - `RunSomeTests` - Ejecutar pruebas específicas - `GetTestList` - Listar pruebas - `RenderPreview` - Vistas previas SwiftUI - `ExecuteSnippet` - Ejecución de código - `DocumentationSearch` - Documentación de Apple - `XcodeListWindows` - Obtener tabIdentifier - `mcp__ide__getDiagnostics` - Errores SourceKit ### NUNCA USAR Xcode MCP Para: - `XcodeRead` -> Usar herramienta `Read` - `XcodeWrite` -> Usar herramienta `Write` - `XcodeUpdate` -> Usar herramienta `Edit` - `XcodeGrep` -> Usar herramienta `rg` o `Grep` - `XcodeGlob` -> Usar herramienta `Glob` - `XcodeLS` -> Usar comando `ls` - `XcodeRM` -> Usar comando `rm` - `XcodeMakeDir` -> Usar comando `mkdir` - `XcodeMV` -> Usar comando `mv` - Operaciones de archivos -> Usar herramientas estándar --- ## Resumen de eficiencia de tokens | Operación | Mejor opción | Impacto de tokens | |-----------|-------------|--------------| | Verificación rápida de sintaxis | `mcp__ide__getDiagnostics` | Bajo | | Build completo | `mcp__xcode__BuildProject` | Medio | | Ejecutar pruebas específicas | `mcp__xcode__RunSomeTests` | Medio | | Ejecutar todas las pruebas | `mcp__xcode__RunAllTests` | Alto | | Leer archivo | Herramienta `Read` | Alto | | Editar archivo | Herramienta `Edit` | Alto | | Buscar código | `rg` / `Grep` | Bajo | | Listar archivos | `ls` / `Glob` | Bajo |