CommunityPesquisa e Análise de Dadosgithub.com

steipete/swiftui-performance-audit

Auditoria de desempenho SwiftUI: renderização, scroll, CPU/memória, atualizações, layout, Instruments.

O que é swiftui-performance-audit?

Esta skill oferece uma auditoria completa de desempenho de visualizações SwiftUI, desde a instrumentação inicial e criação de uma linha de base até a análise de causa raiz e recomendações concretas de correção. É útil para desenvolvedores que enfrentam problemas como lag em listas, renderização lenta, uso excessivo de CPU ou memória, ou animações instáveis em seus aplicativos SwiftUI. A skill suporta uma abordagem em etapas: revisão de código, orientação para uso da ferramenta Instruments (com o template SwiftUI) e análise de traces, seguida por diagnóstico e remediação. O fluxo de trabalho inclui a identificação de mau cheiros comuns, como formatação cara dentro da propriedade `body`, identidades instáveis em `ForEach`, decodificação de imagens na thread principal e dependências amplas em modelos observáveis, com soluções como pré-cálculo, cache e uso de `equatable()` para subárvores caras. A skill também oferece uma etapa de verificação para comparar métricas antes e depois das correções.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-performance-audit

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Auditoria de Desempenho SwiftUI

Atribuição: copiado de Dimillian/Skills de @Dimillian (2025-12-31).

Visão Geral

Audite o desempenho de visualizações SwiftUI de ponta a ponta, desde instrumentação e criação de linha de base até análise de causa raiz e etapas concretas de remediação.

Árvore de Decisão do Fluxo de Trabalho

  • Se o usuário fornecer código, comece com "Revisão Centrada no Código."
  • Se o usuário apenas descrever sintomas, peça o código mínimo/contexto e então faça a "Revisão Centrada no Código."
  • Se a revisão de código for inconclusiva, vá para "Guiar o Usuário para Perfilar" e peça um trace ou capturas de tela.

1. Revisão Centrada no Código

Colete:

  • Código da visualização/recurso alvo.
  • Fluxo de dados: estado, environment, modelos observáveis.
  • Sintomas e etapas de reprodução.

Concentre-se em:

  • Tempestades de invalidação de visualização causadas por alterações amplas de estado.
  • Identidade instável em listas (rotatividade de id, UUID() por renderização).
  • Trabalho pesado em body (formatação, ordenação, decodificação de imagens).
  • Instabilidade de layout (pilhas profundas, GeometryReader, cadeias de preferências).
  • Imagens grandes sem redução de amostragem ou redimensionamento.
  • Hierarquias super animadas (animações implícitas em árvores grandes).

Forneça:

  • Causas raiz prováveis com referências de código.
  • Correções sugestões e refatorações.
  • Se necessário, uma reprodução mínima ou sugestão de instrumentação.

2. Guiar o Usuário para Perfilar

Explique como coletar dados com Instruments:

  • Use o template SwiftUI no Instruments (build Release).
  • Reproduza a interação exata (scroll, navegação, animação).
  • Capture a linha do tempo do SwiftUI e o Time Profiler.
  • Exporte ou tire uma captura de tela das faixas relevantes e da árvore de chamadas.

Peça:

  • Exportação do trace ou capturas de tela das faixas do SwiftUI + árvore de chamadas do Time Profiler.
  • Configuração do dispositivo/SO/build.

3. Analisar e Diagnosticar

Priorize os culpados prováveis do SwiftUI:

  • Tempestades de invalidação de visualização causadas por alterações amplas de estado.
  • Identidade instável em listas (rotatividade de id, UUID() por renderização).
  • Trabalho pesado em body (formatação, ordenação, decodificação de imagens).
  • Instabilidade de layout (pilhas profundas, GeometryReader, cadeias de preferências).
  • Imagens grandes sem redução de amostragem ou redimensionamento.
  • Hierarquias super animadas (animações implícitas em árvores grandes).

Resuma as descobertas com evidências de traces/logs.

4. Remediar

Aplique correções direcionadas:

  • Escopo estreito de estado (@State/@Observable mais próximo das visualizações folhas).
  • Estabilize identidades para ForEach e listas.
  • Mova trabalho pesado para fora de body (pré-calcular, cache, @State).
  • Use equatable() ou wrappers de valor para subárvores caras.
  • Reduza a amostragem de imagens antes da renderização.
  • Reduza a complexidade do layout ou use dimensionamento fixo quando possível.

Mau Cheiros Comuns (e Correções)

Procure por estes padrões durante a revisão de código.

Formatadores caros em body

var body: some View {
    let number = NumberFormatter() // alocação lenta
    let measure = MeasurementFormatter() // alocação lenta
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

Prefira formatadores em cache em um modelo ou um helper dedicado:

final class DistanceFormatter {
    static let shared = DistanceFormatter()
    let number = NumberFormatter()
    let measure = MeasurementFormatter()
}

Propriedades computadas que fazem trabalho pesado

var filtered: [Item] {
    items.filter { $0.isEnabled } // executa em toda avaliação de body
}

Prefira pré-calcular ou cache na mudança:

@State private var filtered: [Item] = []
// atualize filtered quando as entradas mudarem

Ordenação/filtragem em body ou ForEach

List {
    ForEach(items.sorted(by: sortRule)) { item in
        Row(item)
    }
}

Prefira ordenar uma vez antes das atualizações de visualização:

let sortedItems = items.sorted(by: sortRule)

Filtragem inline em ForEach

ForEach(items.filter { $0.isEnabled }) { item in
    Row(item)
}

Prefira uma coleção pré-filtrada com identidade estável.

Identidade instável

ForEach(items, id: \.self) { item in
    Row(item)
}

Evite id: \.self para valores não estáveis; use um ID estável.

Decodificação de imagem na thread principal

Image(uiImage: UIImage(data: data)!)

Prefira decodificar/reduzir amostragem fora da thread principal e armazenar o resultado.

Dependências amplas em modelos observáveis

@Observable class Model {
    var items: [Item] = []
}

var body: some View {
    Row(isFavorite: model.items.contains(item))
}

Prefira modelos de visualização granulares ou estado por item para reduzir a propagação de atualizações.

5. Verificar

Peça ao usuário para executar novamente a mesma captura e comparar com as métricas da linha de base. Resuma o delta (CPU, quedas de quadro, pico de memória) se fornecido.

Saídas

Forneça:

  • Uma tabela curta de métricas (antes/depois se disponível).
  • Principais problemas (ordenados por impacto).
  • Correções propostas com esforço estimado.

Referências

Adicione documentação da Apple e recursos da WWDC em references/ conforme forem fornecidos pelo usuário.

  • Otimizando desempenho SwiftUI com Instruments: references/optimizing-swiftui-performance-instruments.md
  • Entendendo e melhorando desempenho SwiftUI: references/understanding-improving-swiftui-performance.md
  • Entendendo travamentos no seu aplicativo: references/understanding-hangs-in-your-app.md
  • Desmistificando desempenho SwiftUI (WWDC23): references/demystify-swiftui-performance-wwdc23.md

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas