steipete/swiftui-view-refactor

Refatoração/revisão de views SwiftUI: layout, injeção de dependência, Observation e view models.

O que é swiftui-view-refactor?

Esta skill oferece diretrizes consistentes para refatorar e revisar views SwiftUI, com foco em ordenação, padrões Model-View (MV), uso correto de view models e observação de estado com Observation. Ela ajuda desenvolvedores a manter views enxutas, dividindo corpos grandes em subviews ou propriedades computadas, e a injetar dependências via `@Environment` ou `init` em vez de recorrer a view models desnecessários. A skill suporta qualquer projeto SwiftUI moderno (iOS 17+, macOS 14+, etc.) e funciona com ferramentas como Claude Code, Cursor e Codex que possam interpretar essas regras. Ela é útil para padronizar a estrutura de código, melhorar a legibilidade e evitar antipadrões como `bootstrapIfNeeded` ou view models opcionais.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Refatoração de Views SwiftUI

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

Visão Geral

Aplica uma estrutura consistente e um padrão de dependência a views SwiftUI, com foco em ordenação, padrões Model-View (MV), tratamento cuidadoso de view models e uso correto de Observation.

Diretrizes Principais

1) Ordenação da view (topo → base)

  • Environment
  • private/public let
  • @State / outras propriedades armazenadas
  • var computada (não-view)
  • init
  • body
  • construtores de view computados / outros helpers de view
  • funções helper / assíncronas

2) Prefira padrões MV (Model-View)

  • Padrão MV por padrão: Views são expressões de estado leves; models/services possuem a lógica de negócio.
  • Favoreça @State, @Environment, @Query e task/onChange para orquestração.
  • Injete serviços e models compartilhados via @Environment; mantenha as views pequenas e componíveis.
  • Divida views grandes em subviews em vez de introduzir um view model.

3) Divida corpos grandes e propriedades de view

  • Se body crescer além de uma tela ou tiver várias seções lógicas, divida-o em subviews menores.
  • Extraia propriedades de view computadas grandes (var header: some View { ... }) em tipos View dedicados quando elas carregarem estado ou ramificação complexa.
  • É ok manter subviews relacionadas como propriedades de view computadas no mesmo arquivo; extraia para um struct View autônomo apenas quando fizer sentido estruturalmente ou quando houver intenção de reuso.
  • Prefira passar pequenas entradas (dados, bindings, callbacks) em vez de reutilizar todo o estado da view pai.

Exemplo (extraindo uma seção):

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

Exemplo (body longo → body mais curto + views computadas no mesmo arquivo):

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 }
            }
        }
    }
}

Exemplo (extraindo uma view computada complexa):

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) Tratamento de view model (apenas se já existir)

  • Não introduza um view model a menos que a solicitação ou o código existente o exija claramente.
  • Se um view model existir, torne-o não opcional quando possível.
  • Passe dependências para a view via init e depois passe-as para o view model no init da view.
  • Evite padrões bootstrapIfNeeded.

Exemplo (baseado em Observation):

@State private var viewModel: SomeViewModel

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

5) Uso de Observation

  • Para tipos de referência @Observable, armazene-os como @State na view raiz.
  • Passe observáveis explicitamente conforme necessário; evite estado opcional a menos que seja obrigatório.

Fluxo de Trabalho

  1. Reordene a view para corresponder às regras de ordenação.
  2. Favoreça MV: mova a orquestração leve para a view usando @State, @Environment, @Query, task e onChange.
  3. Se um view model existir, substitua view models opcionais por um @State view model não opcional inicializado no init passando dependências da view.
  4. Confirme o uso de Observation: @State para @Observable view models raiz, sem wrappers redundantes.
  5. Mantenha o comportamento intacto: não altere layout ou lógica de negócio a menos que solicitado.

Notas

  • Prefira helpers pequenos e explícitos a grandes blocos condicionais.
  • Mantenha construtores de view computados abaixo de body e vars computadas não-view acima de init.
  • Para orientação e fundamentação MV-first, consulte 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.

Habilidades Relacionadas