Community코딩 & 개발github.com

steipete/swiftui-view-refactor

SwiftUI 뷰 리팩터/리뷰: 레이아웃, 의존성 주입, Observation, 뷰 모델.

swiftui-view-refactor란 무엇인가요?

이 기술은 SwiftUI 뷰에 일관된 구조와 의존성 패턴을 적용하는 방법을 제공합니다. 뷰 순서 정리, MV(Model-View) 패턴 선호, 큰 뷰 분할, 뷰 모델 처리, Observation 사용법 등에 대한 구체적인 가이드라인을 포함합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트가 SwiftUI 코드를 리팩터링하거나 리뷰할 때 사용되며, 코드 품질을 높이고 유지보수성을 개선하는 데 목적이 있습니다. 이 기술은 뷰의 속성 순서를 강제하고, 뷰 모델 도입을 신중하게 하며, Observable 객체를 올바르게 사용하도록 안내합니다. 또한 큰 body를 하위 뷰나 계산된 속성으로 분할하는 방법과 의존성 주입 패턴을 예시 코드와 함께 설명합니다.

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

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SwiftUI 뷰 리팩터

출처: @Dimillian의 Dimillian/Skills에서 복사함 (2025-12-31).

개요

SwiftUI 뷰에 일관된 구조와 의존성 패턴을 적용합니다. 순서, MV(Model-View) 패턴, 신중한 뷰 모델 처리, 올바른 Observation 사용에 중점을 둡니다.

핵심 가이드라인

1) 뷰 순서 (위 → 아래)

  • Environment
  • private/public let
  • @State / 기타 저장 속성
  • 계산된 var (뷰 관련 없음)
  • init
  • body
  • 계산된 뷰 빌더 / 기타 뷰 헬퍼
  • 헬퍼 / 비동기 함수

2) MV (Model-View) 패턴 선호

  • 기본값은 MV: 뷰는 가벼운 상태 표현이며, 모델/서비스가 비즈니스 로직을 소유합니다.
  • 오케스트레이션을 위해 @State, @Environment, @Query, task/onChange를 선호합니다.
  • 서비스와 공유 모델은 @Environment를 통해 주입하고, 뷰를 작고 조합 가능하게 유지합니다.
  • 뷰 모델을 도입하는 대신 큰 뷰를 하위 뷰로 분할합니다.

3) 큰 body와 뷰 속성 분할

  • body가 한 화면을 넘거나 여러 논리적 섹션으로 구성된 경우, 더 작은 하위 뷰로 분할합니다.
  • 큰 계산된 뷰 속성(var header: some View { ... })이 상태나 복잡한 분기를 포함할 때는 전용 View 타입으로 추출합니다.
  • 관련 하위 뷰를 같은 파일에 계산된 뷰 속성으로 유지하는 것은 괜찮습니다. 구조적으로 의미가 있거나 재사용이 필요한 경우에만 독립 View 구조체로 추출합니다.
  • 전체 부모 뷰 상태를 재사용하는 것보다 작은 입력(데이터, 바인딩, 콜백)을 전달하는 것을 선호합니다.

예시 (섹션 추출):

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

예시 (긴 body → 더 짧은 body + 같은 파일의 계산된 뷰):

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

예시 (복잡한 계산된 뷰 추출):

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) 뷰 모델 처리 (이미 존재하는 경우에만)

  • 요청이나 기존 코드가 명확히 요구하지 않는 한 뷰 모델을 도입하지 마십시오.
  • 뷰 모델이 존재하면 가능한 경우 옵셔널을 제거하십시오.
  • init을 통해 뷰에 의존성을 전달한 다음, 뷰의 init에서 뷰 모델로 전달합니다.
  • bootstrapIfNeeded 패턴을 피하십시오.

예시 (Observation 기반):

@State private var viewModel: SomeViewModel

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

5) Observation 사용

  • @Observable 참조 타입의 경우 루트 뷰에 @State로 저장합니다.
  • 필요에 따라 관찰 가능 객체를 명시적으로 전달하고, 필요하지 않으면 옵셔널 상태를 피합니다.

워크플로우

  1. 순서 규칙에 맞게 뷰를 재정렬합니다.
  2. MV 선호: @State, @Environment, @Query, task, onChange를 사용하여 가벼운 오케스트레이션을 뷰로 이동합니다.
  3. 뷰 모델이 존재하면 옵셔널 뷰 모델을 init에서 초기화된 비옵셔널 @State 뷰 모델로 교체하고, 뷰의 의존성을 전달합니다.
  4. Observation 사용 확인: 루트 @Observable 뷰 모델에는 @State를 사용하고, 중복 래퍼는 없어야 합니다.
  5. 동작을 유지: 요청되지 않은 한 레이아웃이나 비즈니스 로직을 변경하지 않습니다.

참고

  • 큰 조건문보다 작고 명시적인 헬퍼를 선호합니다.
  • 계산된 뷰 빌더는 body 아래에, 비뷰 계산된 변수는 init 위에 유지합니다.
  • MV 우선 지침과 근거는 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.

관련 스킬