CommunityCodierung & Entwicklunggithub.com

steipete/swiftui-view-refactor

SwiftUI-View-Refactoring/Review: Layout, Dependency Injection, Observation, ViewModels.

Was ist swiftui-view-refactor?

Diese Anleitung für KI-Agenten (z. B. Claude Code, Cursor, Codex) bietet einen strukturierten Ansatz zum Refactoring und Review von SwiftUI-Views. Sie stellt sicher, dass Views eine konsistente Struktur erhalten, indem Attribute und Methoden in einer festgelegten Reihenfolge (z. B. Environment, @State, init, body) angeordnet werden. Das Skill empfiehlt das Model-View-Pattern (MV) als Standard, hält Views leichtgewichtig und setzt auf @Environment, @State und @Observable, anstatt ViewModels unnötig einzuführen. Es unterstützt die gängigsten SwiftUI-Entwicklungsumgebungen und ist insbesondere für Projekte nützlich, die eine saubere Trennung von Belangen und einheitliche Code-Standards anstreben.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SwiftUI View Refactor

Zuschreibung: Kopiert von @Dimillians Dimillian/Skills (2025-12-31).

Übersicht

Wende eine konsistente Struktur und ein einheitliches Abhängigkeitsmuster auf SwiftUI-Views an, mit Fokus auf Anordnung, Model-View (MV)-Muster, sorgfältige ViewModel-Behandlung und korrekte Observation-Nutzung.

Kernrichtlinien

1) View-Anordnung (oben → unten)

  • Environment
  • private/public let
  • @State / andere gespeicherte Eigenschaften
  • berechnete var (nicht View)
  • init
  • body
  • berechnete View-Builder / andere View-Helfer
  • Helfer / asynchrone Funktionen

2) Bevorzuge MV (Model-View)-Muster

  • Standardmäßig MV: Views sind leichtgewichtige Zustandsausdrücke; Modelle/Services besitzen die Geschäftslogik.
  • Bevorzuge @State, @Environment, @Query und task/onChange für die Orchestrierung.
  • Injiziere Services und gemeinsame Modelle über @Environment; halte Views klein und komponierbar.
  • Teile große Views in Unterviews auf, anstatt ein ViewModel einzuführen.

3) Große Bodies und View-Eigenschaften aufteilen

  • Wenn body größer als ein Bildschirm wird oder mehrere logische Abschnitte hat, teile ihn in kleinere Unterviews auf.
  • Extrahiere große berechnete View-Eigenschaften (var header: some View { ... }) in dedizierte View-Typen, wenn sie Zustand oder komplexe Verzweigungen enthalten.
  • Es ist in Ordnung, verwandte Unterviews als berechnete View-Eigenschaften in derselben Datei zu behalten; extrahiere sie nur dann in eine eigenständige View-Struktur, wenn es strukturell sinnvoll ist oder eine Wiederverwendung beabsichtigt ist.
  • Bevorzuge die Übergabe kleiner Eingaben (Daten, Bindungen, Callbacks) anstelle der Wiederverwendung des gesamten übergeordneten View-Status.

Beispiel (Extrahieren eines Abschnitts):

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

Beispiel (langer Body → kürzerer Body + berechnete Views in derselben Datei):

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

Beispiel (Extrahieren einer komplexen berechneten View):

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) ViewModel-Behandlung (nur wenn bereits vorhanden)

  • Führe kein ViewModel ein, es sei denn, die Anfrage oder der vorhandene Code erfordert es eindeutig.
  • Wenn ein ViewModel existiert, mache es möglichst nicht optional.
  • Übergib Abhängigkeiten an die View über init und reiche sie dann im init der View an das ViewModel weiter.
  • Vermeide bootstrapIfNeeded-Muster.

Beispiel (Observationsbasiert):

@State private var viewModel: SomeViewModel

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

5) Observation-Nutzung

  • Für @Observable-Referenztypen speichere sie als @State in der root-View.
  • Gib Observables bei Bedarf explizit nach unten weiter; vermeide optionalen Zustand, außer wenn erforderlich.

Arbeitsablauf

  1. Ordne die View neu an, um den Anordnungsregeln zu entsprechen.
  2. Bevorzuge MV: Verlagere leichte Orchestrierung in die View mit @State, @Environment, @Query, task und onChange.
  3. Wenn ein ViewModel existiert, ersetze optionale ViewModels durch ein nicht optionales @State ViewModel, das im init durch Übergabe von Abhängigkeiten aus der View initialisiert wird.
  4. Bestätige die Observation-Nutzung: @State für root @Observable ViewModels, keine redundanten Wrapper.
  5. Behalte das Verhalten bei: Ändere kein Layout oder Geschäftslogik, außer es wird angefordert.

Hinweise

  • Bevorzuge kleine, explizite Helfer gegenüber großen bedingten Blöcken.
  • Halte berechnete View-Builder unter body und nicht-View berechnete Variablen über init.
  • Für MV-erste Anleitung und Begründung siehe 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.

Verwandte Skills