Diretrizes de Uso do MCP do Xcode

--- name: xcode-mcp description: Diretrizes para uso eficiente das ferramentas Xcode MCP. Esta skill deve ser usada para entender quando usar as ferramentas Xcode MCP versus ferramentas padrão. O Xcode MCP consome muitos tokens - use apenas para build, teste, simulador, preview e diagnósticos SourceKit. Nunca use para operações de leitura/escrita/grep de arquivos. --- # Diretrizes de Uso do Xcode MCP As ferramentas Xcode MCP consomem tokens significativos. Esta skill define quando usar o Xcode MCP e quando preferir ferramentas padrão. ## Referência Completa das Ferramentas Xcode MCP ### Gerenciamento de Janelas e Projetos | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | Listar janelas abertas do Xcode (obter tabIdentifier) | Baixo | ### Operações de Build | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__BuildProject` | Compilar o projeto Xcode | Médio | | `mcp__xcode__GetBuildLog` | Obter log de build com erros/avisos | Médio | | `mcp__xcode__XcodeListNavigatorIssues` | Listar problemas no Navegador de Problemas | Baixo | ### Testes | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__GetTestList` | Obter testes disponíveis do plano de teste | Baixo | | `mcp__xcode__RunAllTests` | Executar todos os testes | Médio | | `mcp__xcode__RunSomeTests` | Executar testes específicos (preferido) | Médio | ### Preview e Execução | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__RenderPreview` | Renderizar snapshot do SwiftUI Preview | Médio | | `mcp__xcode__ExecuteSnippet` | Executar trecho de código no contexto do arquivo | Médio | ### Diagnósticos | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Obter diagnósticos do compilador para arquivo específico | Baixo | | `mcp__ide__getDiagnostics` | Obter diagnósticos SourceKit (todos os arquivos abertos) | Baixo | ### Documentação | Ferramenta | Descrição | Custo de Tokens | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Pesquisar na Documentação do Apple Developer | Baixo | ### Operações de Arquivo (ALTO TOKEN - NUNCA USAR) | Ferramenta | Alternativa | Porquê | |------|-------------|-----| | `mcp__xcode__XcodeRead` | Ferramenta `Read` | Alto consumo de tokens | | `mcp__xcode__XcodeWrite` | Ferramenta `Write` | Alto consumo de tokens | | `mcp__xcode__XcodeUpdate` | Ferramenta `Edit` | Alto consumo de tokens | | `mcp__xcode__XcodeGrep` | Ferramenta `rg` / `Grep` | Alto consumo de tokens | | `mcp__xcode__XcodeGlob` | Ferramenta `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 | --- ## Fluxos de Trabalho Recomendados ### 1. Fluxo de Alteração de Código e Build ``` 1. Pesquisar código -> rg "pattern" --type swift 2. Ler arquivo -> Ferramenta Read 3. Editar arquivo -> Ferramenta Edit 4. Verificação de sintaxe -> mcp__ide__getDiagnostics 5. Build -> mcp__xcode__BuildProject 6. Verificar erros -> mcp__xcode__GetBuildLog (se o build falhar) ``` ### 2. Fluxo de Escrita e Execução de Testes ``` 1. Ler arquivo de teste -> Ferramenta Read 2. Escrever/editar teste -> Ferramenta Edit 3. Obter lista de testes -> mcp__xcode__GetTestList 4. Executar testes -> mcp__xcode__RunSomeTests (testes específicos) 5. Verificar resultados -> Revisar saída do teste ``` ### 3. Fluxo de Preview SwiftUI ``` 1. Editar view -> Ferramenta Edit 2. Renderizar preview -> mcp__xcode__RenderPreview 3. Iterar -> Repetir conforme necessário ``` ### 4. Fluxo de Depuração ``` 1. Verificar diagnósticos -> mcp__ide__getDiagnostics (verificação rápida de sintaxe) 2. Compilar projeto -> mcp__xcode__BuildProject 3. Obter log de build -> mcp__xcode__GetBuildLog (severidade: erro) 4. Corrigir problemas -> Ferramenta Edit 5. Recompilar -> mcp__xcode__BuildProject ``` ### 5. Pesquisa de Documentação ``` 1. Pesquisar docs -> mcp__xcode__DocumentationSearch 2. Revisar resultados -> Usar informações na implementação ``` --- ## Comandos de Fallback (Quando o MCP Estiver Indisponível) Se o Xcode MCP estiver desconectado ou indisponível, use estes comandos xcodebuild: ### Comandos de Build ```bash # Build de depuração (simulador) - substitua <SchemeName> pelo scheme do seu projeto xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build de release (dispositivo) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build com workspace (para projetos CocoaPods) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build com arquivo de projeto xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Listar schemes disponíveis xcodebuild -list ``` ### Comandos de Teste ```bash # Executar todos os testes xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Executar classe de teste específica xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # Executar método de teste específico xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # Executar com cobertura de código xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # Listar simuladores disponíveis xcrun simctl list devices available ``` ### Build Limpo ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## Referência Rápida ### USE Xcode MCP Para: - `BuildProject` - Compilar - `GetBuildLog` - Erros de build - `RunSomeTests` - Executar testes específicos - `GetTestList` - Listar testes - `RenderPreview` - Previews SwiftUI - `ExecuteSnippet` - Execução de código - `DocumentationSearch` - Documentação Apple - `XcodeListWindows` - Obter tabIdentifier - `mcp__ide__getDiagnostics` - Erros SourceKit ### NUNCA USE Xcode MCP Para: - `XcodeRead` -> Use a ferramenta `Read` - `XcodeWrite` -> Use a ferramenta `Write` - `XcodeUpdate` -> Use a ferramenta `Edit` - `XcodeGrep` -> Use a ferramenta `rg` ou `Grep` - `XcodeGlob` -> Use a ferramenta `Glob` - `XcodeLS` -> Use o comando `ls` - `XcodeRM` -> Use o comando `rm` - `XcodeMakeDir` -> Use o comando `mkdir` - `XcodeMV` -> Use o comando `mv` - Operações de arquivo -> Use ferramentas padrão --- ## Resumo de Eficiência de Tokens | Operação | Melhor Escolha | Impacto de Tokens | |-----------|-------------|--------------| | Verificação rápida de sintaxe | `mcp__ide__getDiagnostics` | Baixo | | Build completo | `mcp__xcode__BuildProject` | Médio | | Executar testes específicos | `mcp__xcode__RunSomeTests` | Médio | | Executar todos os testes | `mcp__xcode__RunAllTests` | Alto | | Ler arquivo | Ferramenta `Read` | Alto | | Editar arquivo | Ferramenta `Edit` | Alto | | Pesquisar código | `rg` / `Grep` | Baixo | | Listar arquivos | `ls` / `Glob` | Baixo |