steipete/swiftui-performance-audit

Auditoría de rendimiento en SwiftUI: renderizado, scroll, CPU/memoria, actualizaciones, layout e Instruments.

¿Qué es swiftui-performance-audit?

Esta skill permite realizar una auditoría completa del rendimiento de vistas SwiftUI, desde la instrumentación y línea base hasta el análisis de causas raíz y pasos concretos de remediación. Es útil para desarrolladores que trabajan con SwiftUI y necesitan identificar cuellos de botella como tormentas de invalidación de vistas, inestabilidad de identidad en listas, trabajo pesado en el cuerpo de las vistas, o imágenes grandes sin downsampling. Soporta plataformas Apple (iOS, macOS, etc.) y se integra con Instruments para capturar trazas de rendimiento. El flujo de trabajo incluye una revisión de código inicial, guía para perfilar con Instruments, análisis de hallazgos, remediación con soluciones específicas y verificación comparando métricas antes y después.

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

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Auditoría de Rendimiento en SwiftUI

Atribución: copiado de la skill Dimillian/Skills de @Dimillian (2025-12-31).

Resumen

Auditar el rendimiento de vistas SwiftUI de extremo a extremo, desde la instrumentación y línea base hasta el análisis de causas raíz y pasos concretos de remediación.

Árbol de Decisión del Flujo de Trabajo

  • Si el usuario proporciona código, empezar con "Revisión de Código Primero".
  • Si el usuario solo describe síntomas, pedir código mínimo/contexto, luego hacer "Revisión de Código Primero".
  • Si la revisión de código no es concluyente, ir a "Guiar al Usuario para Perfilar" y pedir una traza o capturas de pantalla.

1. Revisión de Código Primero

Recopilar:

  • Código de la vista/característica objetivo.
  • Flujo de datos: estado, entorno, modelos observables.
  • Síntomas y pasos de reproducción.

Enfocarse en:

  • Tormentas de invalidación de vistas por cambios de estado amplios.
  • Identidad inestable en listas (cambio constante de id, UUID() por cada renderizado).
  • Trabajo pesado en body (formateo, ordenamiento, decodificación de imágenes).
  • Sobrecarga de layout (pilas profundas, GeometryReader, cadenas de preferencias).
  • Imágenes grandes sin downsampling o redimensionamiento.
  • Jerarquías sobre-animadas (animaciones implícitas en árboles grandes).

Proporcionar:

  • Causas raíz probables con referencias de código.
  • Soluciones y refactorizaciones sugeridas.
  • Si es necesario, una reproducción mínima o sugerencia de instrumentación.

2. Guiar al Usuario para Perfilar

Explicar cómo recopilar datos con Instruments:

  • Usar la plantilla SwiftUI en Instruments (compilación Release).
  • Reproducir la interacción exacta (scroll, navegación, animación).
  • Capturar la línea de tiempo de SwiftUI y el Perfilador de Tiempo (Time Profiler).
  • Exportar o capturar en pantalla las pistas relevantes y el árbol de llamadas.

Solicitar:

  • Exportación de traza o capturas de pantalla de las pistas de SwiftUI + el árbol de llamadas del Perfilador de Tiempo.
  • Configuración de dispositivo/SO/compilación.

3. Analizar y Diagnosticar

Priorizar culpables comunes de SwiftUI:

  • Tormentas de invalidación de vistas por cambios de estado amplios.
  • Identidad inestable en listas (cambio constante de id, UUID() por cada renderizado).
  • Trabajo pesado en body (formateo, ordenamiento, decodificación de imágenes).
  • Sobrecarga de layout (pilas profundas, GeometryReader, cadenas de preferencias).
  • Imágenes grandes sin downsampling o redimensionamiento.
  • Jerarquías sobre-animadas (animaciones implícitas en árboles grandes).

Resumir hallazgos con evidencia de trazas/registros.

4. Remediar

Aplicar correcciones específicas:

  • Reducir el ámbito del estado (@State/@Observable más cerca de las vistas hoja).
  • Estabilizar identidades para ForEach y listas.
  • Mover trabajo pesado fuera de body (precalcular, cachear, usar @State).
  • Usar equatable() o envoltorios de valor para subárboles costosos.
  • Redimensionar imágenes antes de renderizar.
  • Reducir la complejidad del layout o usar tamaños fijos cuando sea posible.

Patrones de Código Sospechosos Comunes (y Correcciones)

Buscar estos patrones durante la revisión de código.

Formateadores costosos en body

var body: some View {
    let number = NumberFormatter() // asignación lenta
    let measure = MeasurementFormatter() // asignación lenta
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

Prefiere formateadores cacheados en un modelo o en un helper dedicado:

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

Propiedades computadas que hacen trabajo pesado

var filtered: [Item] {
    items.filter { $0.isEnabled } // se ejecuta en cada evaluación de body
}

Prefiere precalcular o cachear ante cambios:

@State private var filtered: [Item] = []
// actualizar filtered cuando las entradas cambien

Ordenamiento/filtrado en body o ForEach

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

Prefiere ordenar una vez antes de las actualizaciones de vista:

let sortedItems = items.sorted(by: sortRule)

Filtrado en línea en ForEach

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

Prefiere una colección pre-filtrada con identidad estable.

Identidad inestable

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

Evita id: \.self para valores no estables; usa un ID estable.

Decodificación de imágenes en el hilo principal

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

Prefiere decodificar/redimensionar fuera del hilo principal y almacenar el resultado.

Dependencias amplias en modelos observables

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

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

Prefiere modelos de vista granulares o estado por elemento para reducir la propagación de actualizaciones.

5. Verificar

Pedir al usuario que ejecute nuevamente la misma captura y compare con las métricas de línea base. Resumir el delta (CPU, caídas de fotogramas, pico de memoria) si se proporciona.

Salidas

Proporcionar:

  • Una tabla breve de métricas (antes/después si está disponible).
  • Problemas principales (ordenados por impacto).
  • Correcciones propuestas con esfuerzo estimado.

Referencias

Agregar documentación de Apple y recursos de WWDC bajo references/ según los proporcione el usuario.

  • Optimización del rendimiento de SwiftUI con Instruments: references/optimizing-swiftui-performance-instruments.md
  • Comprensión y mejora del rendimiento de SwiftUI: references/understanding-improving-swiftui-performance.md
  • Comprensión de los bloqueos en tu app: references/understanding-hangs-in-your-app.md
  • Desmitificar el rendimiento de 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.

Skills relacionados