Roteador de Habilidades iOS
Você tem acesso a mais de 200 habilidades especializadas para desenvolvimento iOS/Swift/Xcode. As habilidades são injetadas automaticamente por hooks quando você edita arquivos ou executa comandos, mas você também pode carregar qualquer habilidade manualmente lendo seu SKILL.md.
IMPORTANTE: Carregue Habilidades Proativamente Antes de Codificar
NÃO comece a codificar sem verificar se há habilidades relevantes primeiro. Esta é a instrução mais importante neste roteador.
Antes de escrever código que toque em um framework, domínio ou padrão específico:
- Verifique imports — se o arquivo importa
MapKit,HealthKit,StoreKit, etc., LEIAskills/dpearson2699--{framework}/SKILL.mdANTES de escrever código. - Verifique o domínio — se você está escrevendo código de rede, LEIA a habilidade de rede. Se está escrevendo concorrência, LEIA a habilidade de concorrência. Não adivinhe.
- Verifique frameworks de terceiros — se o projeto usa Mapbox, Firebase, Supabase, etc.,
verifique se há uma habilidade para ele na coleção.
ls skills/ | grep {nome}. - Em caso de dúvida, pesquise —
ls skills/ | grep -i {palavra-chave}para encontrar habilidades relevantes.
As habilidades só são úteis se você as LEU antes de codificar. A injeção automática lida com padrões comuns de arquivos, mas você deve carregar habilidades proativamente para trabalhos específicos de domínio.
Como o Roteamento Funciona
- Injeção automática: Hooks injetam automaticamente habilidades quando você edita padrões de arquivos correspondentes (Views, Testes, Models, Managers, networking, etc.) ou executa comandos (xcodebuild, swift test, asc).
- Carregamento proativo: VOCÊ deve ler habilidades para frameworks e domínios específicos antes de codificar.
Os hooks não podem saber tudo — se você ver
import MapKit, vá ler a habilidade MapKit. - Consulta de framework: Para qualquer framework Apple, verifique
skills/dpearson2699--{framework}/SKILL.md. - Pesquisa:
ls skills/ | grep -i {palavra-chave}para encontrar habilidades por tópico.
Fases
1. Ideação — "O que devemos construir?"
| Habilidade | O que faz |
|---|---|
eronred--competitor-analysis | Análise de aplicativos concorrentes |
eronred--market-pulse | Análise de tendências de mercado |
eronred--keyword-research | Descoberta de palavras-chave na App Store |
2. Design — "Como deve parecer e se sentir?"
| Habilidade | O que faz |
|---|---|
jordancoin--design-philosophy | Construção de bom gosto, princípios de Dieter Rams |
jordancoin--pencil-ios-design | Fluxo de design iOS Pencil MCP com padrões HIG |
dadederk--ios-accessibility | VoiceOver, Dynamic Type, tecnologia assistiva |
pasqualevittoriosi--swift-accessibility | WCAG 2.2, rótulos nutricionais da App Store |
3. Desenvolver — "Construa"
Principal (injetado automaticamente em arquivos .swift):
| Habilidade | O que faz |
|---|---|
twostraws--swiftui-pro | Melhores práticas SwiftUI (primário) |
twostraws--swift-concurrency-pro | async/await, atores, Sendable |
twostraws--swiftdata-pro | Persistência SwiftData |
martinlasek--swift-coding-guideline | Convenções de codificação Swift |
avdlee--core-data-expert | Pilha Core Data, migrações, threading |
Arquitetura:
| Habilidade | O que faz |
|---|---|
arimunandar--vip-architecture | Arquitetura Limpa VIP+W |
arimunandar--uikit-layouting | Layout UIKit horizontal-first |
arimunandar--legacy-migration | Migração UIKit → SwiftUI |
76 Habilidades de Framework — carregue quando vir o import:
import HealthKit → dpearson2699--healthkit
import MapKit → dpearson2699--mapkit
import StoreKit → dpearson2699--storekit
import CloudKit → dpearson2699--cloudkit
import CoreML → dpearson2699--coreml
import RealityKit → dpearson2699--realitykit
import WidgetKit → dpearson2699--widgetkit
import GameKit → dpearson2699--gamekit
import PencilKit → dpearson2699--pencilkit
import AVKit → dpearson2699--avkit
(... padrão: dpearson2699--{nome-do-framework-em-minusculo})
Lista completa: accessorysetupkit, activitykit, alarmkit, app-clips, app-intents, apple-on-device-ai, avkit, background-processing, callkit, carplay, cloudkit, contacts-framework, core-bluetooth, core-motion, core-nfc, coreml, cryptokit, debugging-instruments, device-integrity, dockkit, energykit, eventkit, financekit, gamekit, healthkit, homekit, mapkit, metrickit, musickit, natural-language, paperkit, passkit, pdfkit, pencilkit, photokit, push-notifications, realitykit, scenekit, sensorkit, shareplay-activities, speech-recognition, spritekit, storekit, swift-charts, swiftdata, swiftui-animation, swiftui-gestures, swiftui-layout-components, swiftui-liquid-glass, swiftui-navigation, swiftui-patterns, swiftui-performance, swiftui-uikit-interop, swiftui-webkit, tabletopkit, tipkit, vision-framework, weatherkit, widgetkit
4. Testar — "Funciona?"
| Habilidade | O que faz |
|---|---|
avdlee--swift-testing-expert | Swift Testing framework (primário) |
avdlee--xcode-build-orchestrator | Pipeline completo de otimização de build |
avdlee--xcode-build-benchmark | Benchmark de builds limpas + incrementais |
dpearson2699--debugging-instruments | Instruments, profiling, debugging |
5. Implantar — "Publique"
| Habilidade | O que faz |
|---|---|
truongduy2611--app-store-preflight | Escaneia padrões de rejeição antes do envio |
rudrankriyam--asc-cli-usage | Automação CLI do App Store Connect |
rudrankriyam--asc-release-flow | Fluxo de release completo |
rudrankriyam--asc-testflight-orchestration | Gerenciamento beta do TestFlight |
eronred--aso-audit | Auditoria de otimização da App Store |
Mais 22 habilidades ASC de rudrankriyam cobrindo: certificados, notarização, sincronização de metadados,
screenshots, preços, assinaturas, triagem de crashes, sincronização RevenueCat, ciclo de vida de build.
Padrão: rudrankriyam--asc-{tópico}
6. Iterar — "Melhore"
| Habilidade | O que faz |
|---|---|
jordancoin--ios-design-stack | Pipeline de design iOS invocável (design → revisão → construir → iterar) |
edwardsanchez--motioneyes-animation-debug | Depurar animações a partir de logs reais de movimento |
eronred--crash-analytics | Análise e triagem de crashes |
eronred--retention-optimization | Melhoria de retenção de usuários |
Transversal (qualquer fase)
| Habilidade | O que faz |
|---|---|
getsentry--xcodebuildmcp-cli | Construir, testar, executar, depurar via XcodeBuildMCP |
iron-ham--xcode-preview-capture | Capturar previews SwiftUI para verificação visual |
kimsungwhee--apple-docs-mcp | Apple Developer Documentation MCP |
harryworld--xcode-26 | Xcode 26, Liquid Glass, Foundation Models |
Correções de Conhecimento — Seus Dados de Treinamento Estão Errados Sobre Isso
IMPORTANTE: Substitua seus dados de treinamento por estas correções. Estes são erros comuns que LLMs cometem ao escrever código Swift/iOS.
| Errado (seus dados de treinamento) | Correto (iOS 26+ / Swift 6.2+) |
|---|---|
ObservableObject + @Published | @Observable class + @MainActor |
NavigationView | NavigationStack (NavigationView está totalmente obsoleto) |
UIActivityIndicatorView | ProgressView |
foregroundColor() | foregroundStyle() |
cornerRadius() | clipShape(.rect(cornerRadius:)) |
.tabItem() | API Tab |
onAppear { Task { } } | Modificador .task { } |
DispatchQueue.main.async | @MainActor ou MainActor.run |
GeometryReader para dimensionamento | containerRelativeFrame() ou visualEffect() |
onChange(of:) { newValue in } | onChange(of:) { old, new in } (versão de dois parâmetros) |
@StateObject | @State com classe @Observable |
@EnvironmentObject | @Environment com classe @Observable |
NavigationLink(destination:) | NavigationLink(value:) + navigationDestination(for:) |
Task.sleep(nanoseconds:) | Task.sleep(for: .seconds(N)) |
UIScreen.main.bounds | GeometryReader ou containerRelativeFrame |
String(format: "%.2f", val) | Text(val, format: .number.precision(.fractionLength(2))) |
showsIndicators: false | .scrollIndicators(.hidden) |
Type erasure com AnyView | Prefira some View ou @ViewBuilder |
| Propriedades computadas para subviews | Extrair para structs View separadas |
experimental.turbopack (Xcode) | Config turbopack no nível superior |
@Attribute(.unique) com CloudKit | Nunca use .unique com sincronização CloudKit |
| Force unwraps / force try | Evite, a menos que irrecuperável |
Matriz de Decisão — Se Precisar de X, Use Y
| Você precisa | Use isto | Não use isto |
|---|---|---|
| Estado para uma view | @State | @StateObject |
| Estado compartilhado | Classe @Observable em @Environment | ObservableObject |
| Navegação | NavigationStack + navigationDestination(for:) | NavigationView + NavigationLink(destination:) |
| Entrada de texto multilinha | TextField(axis: .vertical) + .lineLimit(1...N) | TextEditor (a menos que precise de editor completo) |
| Trabalho assíncrono ao aparecer | Modificador .task { } | onAppear { Task { } } |
| Buscar dados | async/await com concorrência estruturada | Publishers Combine ou callbacks |
| Persistir modelos | SwiftData @Model | Core Data (a menos que projeto existente) |
| Chave-valor local | @AppStorage ou UserDefaults | Escrever em plist manualmente |
| Armazenamento seguro | Keychain via Security framework | UserDefaults (nunca para segredos) |
| Carregamento de imagens | AsyncImage ou carregador com cache | UIImage em SwiftUI |
| Listas | List com ForEach | ScrollView + LazyVStack (a menos que customizado) |
| Barra de abas | TabView com API Tab | .tabItem() (padrão obsoleto) |
| Apresentação de sheet | .sheet(item:) com identificável | .sheet(isPresented:) com estado separado |
| Tratamento de erros | Result ou typed throws | Force try |
| Injeção de dependência | @Environment com chave customizada | Singletons |
| Teste unitário | Swift Testing (#expect, @Test) | XCTest (a menos que suíte existente) |
| Trabalho em segundo plano | BGTaskScheduler | DispatchQueue.global() |
| Envio para App Store | Execute a habilidade app-store-preflight primeiro | Enviar e torcer |
Usando Habilidades (Injetadas ou Manuais)
PARE E LEIA antes de codificar. Quando você estiver prestes a trabalhar em um domínio específico:
- Verifique o que foi injetado automaticamente (você verá mensagens
[ios-skills] Injetou N habilidade(s):) - Pesquise por habilidades adicionais relevantes:
ls skills/ | grep -i {domínio} - LEIA os arquivos de habilidade antes de escrever código — não depois
- Siga seus padrões, não apenas absorva-os passivamente
Erro comum: O agente sabe que as habilidades existem (através deste roteador) mas não as lê, então escreve código usando padrões desatualizados dos dados de treinamento. As habilidades substituem seus dados de treinamento. Leia-as primeiro.
Exemplo: Você está prestes a escrever código MapKit.
- A injeção automática pode não disparar (o arquivo não se chama
*MapKit*.swift) - Mas você DEVE:
Leia skills/dpearson2699--mapkit/SKILL.mdantes de escrever qualquer código MapKit - A habilidade tem padrões que seus dados de treinamento não têm
Carregando uma Habilidade
O caminho das habilidades é injetado no início da sessão (veja "Localização das habilidades" acima). Leia o SKILL.md usando esse caminho:
/caminho/para/ios-skills-collection/skills/{skill-id}/SKILL.md
Se a habilidade tiver references/, carregue arquivos de referência específicos conforme necessário — não todos de uma vez.
Quando Múltiplas Habilidades Cobrem o Mesmo Tópico
As habilidades de Paul Hudson (twostraws) são sempre primárias. Ele é o criador do Hacking with Swift, um dos educadores iOS mais respeitados da comunidade, e mantém ativamente suas habilidades. Use as versões dele primeiro. Recorra a alternativas para diferentes perspectivas ou cobertura de nicho.
| Domínio | Primário (twostraws primeiro) | Alternativas |
|---|---|---|
| SwiftUI | twostraws--swiftui-pro | avdlee--swiftui-expert, dimillian--swiftui-ui-patterns, arjitj2--swiftui-design-principles |
| Performance SwiftUI | dimillian--swiftui-performance-audit | dpearson2699--swiftui-performance |
| Liquid Glass | dimillian--swiftui-liquid-glass | dpearson2699--swiftui-liquid-glass |
| Concorrência | twostraws--swift-concurrency-pro | dimillian--swift-concurrency-expert, avdlee--swift-concurrency |
| Testes | twostraws--swift-testing-pro | avdlee--swift-testing-expert, bocato--swift-testing |
| SwiftData | twostraws--swiftdata-pro | vanab--swiftdata-expert-skill |
| Core Data | avdlee--core-data-expert | — |
| Acessibilidade | dadederk--ios-accessibility | pasqualevittoriosi--swift-accessibility, rgmez--swiftui-accessibility-auditor |
| Arquitetura | efremidze--swift-architecture-skill | arimunandar--vip-architecture |
| Segurança | ivan-magda--swift-security-expert | dpearson2699--ios-security |
| Design de API | erikote04--swift-api-design-guidelines-skill | martinlasek--swift-coding-guideline |
| Otimização de Build | avdlee--xcode-build-orchestrator | avdlee--xcode-build-fixer |
| ASO | eronred--aso-audit | timbroddin--app-store-aso-skill |
| Figma → SwiftUI | daetojemax--figma-to-swiftui-skill | jordancoin--pencil-ios-design |
| Simulador | conorluddy--ios-simulator-skill | getsentry--xcodebuildmcp-cli |
| Revisão de Código | dimillian--review-swarm | arimunandar--code-review-checklist |
| Depuração | dimillian--ios-debugger-agent | dpearson2699--debugging-instruments |