CommunityProgramación y desarrollogithub.com

Refactorizar vista SwiftUI

Refactorización/revisión de vistas SwiftUI: diseño, inyección de dependencias, Observation, modelos de vista.

¿Qué es Refactorizar vista SwiftUI?

Esta habilidad, basada en el trabajo de Dimillian, guía a los desarrolladores en la refactorización y revisión de vistas SwiftUI para aplicar una estructura consistente y patrones de dependencia. Proporciona reglas claras para ordenar los elementos de la vista (de entorno a funciones helper), promueve el patrón Modelo-Vista (MV) manteniendo las vistas ligeras y delegando la lógica de negocio a modelos y servicios, y ofrece pautas para dividir cuerpos de vista largos en subvistas o propiedades computadas. Además, maneja view models existentes, recomendando su inicialización no opcional y el uso de `@State` con `@Observable`, y asegura el uso correcto de Observation en SwiftUI. Compatible con asistentes de código y herramientas como Claude Code o Cursor, esta skill mejora la mantenibilidad y legibilidad del código SwiftUI sin alterar la lógica de negocio o el diseño visual.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Refactorizar vista SwiftUI?

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

Resumen

Aplicar una estructura y patrón de dependencias consistente a las vistas SwiftUI, con enfoque en ordenamiento, patrones Modelo-Vista (MV), manejo cuidadoso de view models y uso correcto de Observation.

Guías principales

1) Orden de la vista (de arriba a abajo)

  • Environment
  • private/public let
  • @State / otras propiedades almacenadas
  • var computadas (no vistas)
  • init
  • body
  • constructores de vista computados / otros helpers de vista
  • funciones helper / asíncronas

2) Preferir patrones MV (Modelo-Vista)

  • Por defecto usar MV: Las vistas son expresiones de estado ligeras; los modelos/servicios poseen la lógica de negocio.
  • Favorecer @State, @Environment, @Query y task/onChange para la orquestación.
  • Inyectar servicios y modelos compartidos mediante @Environment; mantener las vistas pequeñas y componibles.
  • Dividir vistas grandes en subvistas en lugar de introducir un view model.

3) Dividir cuerpos grandes y propiedades de vista

  • Si body crece más allá de una pantalla o tiene múltiples secciones lógicas, dividirlo en subvistas más pequeñas.
  • Extraer propiedades de vista computadas grandes (var header: some View { ... }) en tipos View dedicados cuando tengan estado o ramificaciones complejas.
  • Está bien mantener subvistas relacionadas como propiedades de vista computadas en el mismo archivo; extraer a un struct View independiente solo cuando tenga sentido estructuralmente o cuando se pretenda reutilizar.
  • Preferir pasar entradas pequeñas (datos, bindings, callbacks) en lugar de reutilizar todo el estado de la vista padre.

Ejemplo (extrayendo una sección):

var body: some View {
    VStack(alignment: .leading, spacing: 16) {
        HeaderSection(title: title, isPinned: isPinned)
        DetailsSection(details: details)
        ActionsSection(onSave: onSave, onCancel: onCancel)
    }
}

Ejemplo (body largo → body más corto + vistas computadas en el mismo archivo):

var body: some View {
    List {
        header
        filters
        results
        footer
    }
}

private var header: some View {
    VStack(alignment: .leading, spacing: 6) {
        Text(title).font(.title2)
        Text(subtitle).font(.subheadline)
    }
}

private var filters: some View {
    ScrollView(.horizontal, showsIndicators: false) {
        HStack {
            ForEach(filterOptions, id: \.self) { option in
                FilterChip(option: option, isSelected: option == selectedFilter)
                    .onTapGesture { selectedFilter = option }
            }
        }
    }
}

Ejemplo (extrayendo una vista computada compleja):

private var header: some View {
    HeaderSection(title: title, subtitle: subtitle, status: status)
}

private struct HeaderSection: View {
    let title: String
    let subtitle: String?
    let status: Status

    var body: some View {
        VStack(alignment: .leading, spacing: 4) {
            Text(title).font(.headline)
            if let subtitle { Text(subtitle).font(.subheadline) }
            StatusBadge(status: status)
        }
    }
}

4) Manejo de view models (solo si ya existen)

  • No introducir un view model a menos que la solicitud o el código existente claramente lo requiera.
  • Si existe un view model, hacerlo no opcional cuando sea posible.
  • Pasar dependencias a la vista mediante init, luego pasarlas al view model en el init de la vista.
  • Evitar patrones bootstrapIfNeeded.

Ejemplo (basado en Observation):

@State private var viewModel: SomeViewModel

init(dependency: Dependency) {
    _viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}

5) Uso de Observation

  • Para tipos de referencia @Observable, almacenarlos como @State en la vista raíz.
  • Pasar observables hacia abajo explícitamente según sea necesario; evitar estado opcional a menos que sea obligatorio.

Flujo de trabajo

  1. Reordenar la vista para que coincida con las reglas de ordenamiento.
  2. Favorecer MV: mover orquestación ligera a la vista usando @State, @Environment, @Query, task y onChange.
  3. Si existe un view model, reemplazar view models opcionales con un @State view model no opcional inicializado en init pasando dependencias desde la vista.
  4. Confirmar uso de Observation: @State para view models @Observable raíz, sin wrappers redundantes.
  5. Mantener el comportamiento intacto: no cambiar diseño ni lógica de negocio a menos que se solicite.

Notas

  • Preferir helpers pequeños y explícitos sobre bloques condicionales grandes.
  • Mantener constructores de vista computados debajo de body y vars computados que no sean de vista arriba de init.
  • Para orientación y fundamentos de MV, consultar references/mv-patterns.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