Community연구 & 데이터 분석github.com

steipete/swiftui-performance-audit

SwiftUI 성능: 렌더링, 스크롤, CPU/메모리, 업데이트, 레이아웃, Instruments 진단.

swiftui-performance-audit란 무엇인가요?

이 스킬은 SwiftUI 뷰 성능을 종합적으로 감사(audit)하는 전문 도구입니다. 사용자가 제공한 코드나 증상을 기반으로 코드 우선 검토(Code-First Review)를 진행하고, 필요한 경우 Instruments 프로파일링을 안내합니다. 분석 단계에서는 뷰 무효화 폭풍(view invalidation storms), 불안정한 리스트 식별자(unstable identity), body 내 과도한 연산(heavy work in body), 레이아웃 스래싱(layout thrash), 이미지 디코딩 문제, 과도한 애니메이션 등 주요 SwiftUI 성능 병목을 집중적으로 진단합니다. 최종적으로는 구체적인 코드 수정 제안과 함께 이전/이후 메트릭 비교를 통해 성능 개선 효과를 검증하며, Apple 공식 문서와 WWDC 자료를 참고 자료로 제공합니다. Cursor, Claude Code, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있습니다.

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

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

SwiftUI 성능 감사

귀속: @Dimillian의 Dimillian/Skills (2025-12-31)에서 가져옴.

개요

SwiftUI 뷰 성능을 계측(instrumentation)과 기준 측정(baselining)부터 근본 원인 분석 및 구체적인 수정 단계까지 종단간(end-to-end) 감사합니다.

워크플로우 결정 트리

  • 사용자가 코드를 제공하면 "코드 우선 검토"로 시작합니다.
  • 사용자가 증상만 설명하는 경우, 최소한의 코드/컨텍스트를 요청한 후 "코드 우선 검토"를 수행합니다.
  • 코드 검토가 불분명하면 "사용자에게 프로파일링 안내"로 이동하여 트레이스(trace) 또는 스크린샷을 요청합니다.

1. 코드 우선 검토

수집:

  • 대상 뷰/기능 코드.
  • 데이터 흐름: 상태, 환경, 관찰 가능 모델.
  • 증상 및 재현 단계.

집중할 사항:

  • 광범위한 상태 변경으로 인한 뷰 무효화 폭풍.
  • 리스트의 불안정한 식별자(id 변경, 렌더링 시 UUID() 호출).
  • body 내의 과도한 작업(포맷팅, 정렬, 이미지 디코딩).
  • 레이아웃 스래싱(깊은 스택, GeometryReader, 선호도 체인).
  • 다운샘플링 또는 크기 조정 없이 사용되는 큰 이미지.
  • 과도한 애니메이션 계층 구조(대규모 트리에 대한 암시적 애니메이션).

제공:

  • 코드 참조와 함께 가능한 근본 원인.
  • 제안된 수정 및 리팩토링.
  • 필요한 경우 최소한의 재현 코드 또는 계측 제안.

2. 사용자에게 프로파일링 안내

Instruments로 데이터를 수집하는 방법 설명:

  • Instruments에서 SwiftUI 템플릿 사용(Release 빌드).
  • 정확한 상호작용(스크롤, 탐색, 애니메이션) 재현.
  • SwiftUI 타임라인과 Time Profiler 캡처.
  • 관련 레인(lanes)과 호출 트리(call tree) 내보내기 또는 스크린샷.

요청:

  • SwiftUI 레인 + Time Profiler 호출 트리의 트레이스 내보내기 또는 스크린샷.
  • 기기/OS/빌드 구성.

3. 분석 및 진단

가능성이 높은 SwiftUI 원인 우선순위 지정:

  • 광범위한 상태 변경으로 인한 뷰 무효화 폭풍.
  • 리스트의 불안정한 식별자(id 변경, 렌더링 시 UUID() 호출).
  • body 내의 과도한 작업(포맷팅, 정렬, 이미지 디코딩).
  • 레이아웃 스래싱(깊은 스택, GeometryReader, 선호도 체인).
  • 다운샘플링 또는 크기 조정 없이 사용되는 큰 이미지.
  • 과도한 애니메이션 계층 구조(대규모 트리에 대한 암시적 애니메이션).

트레이스/로그의 증거와 함께 결과 요약.

4. 수정

대상별 수정 적용:

  • 상태 범위 좁히기(@State/@Observable을 리프 뷰에 더 가깝게).
  • ForEach 및 리스트의 식별자 안정화.
  • body 밖으로 무거운 작업 이동(사전 계산, 캐싱, @State).
  • 비용이 많이 드는 서브트리에 equatable() 또는 값 래퍼 사용.
  • 렌더링 전에 이미지 다운샘플링.
  • 레이아웃 복잡성 줄이기 또는 가능하면 고정 크기 사용.

일반적인 코드 냄새 (및 수정)

코드 검토 중에 다음 패턴을 찾으세요.

body 내의 비싼 포매터

var body: some View {
    let number = NumberFormatter() // 느린 할당
    let measure = MeasurementFormatter() // 느린 할당
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

모델 또는 전용 헬퍼에 캐시된 포매터를 선호:

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

무거운 작업을 수행하는 계산 속성

var filtered: [Item] {
    items.filter { $0.isEnabled } // 모든 body 평가 시 실행
}

변경 시 사전 계산 또는 캐싱 선호:

@State private var filtered: [Item] = []
// 입력 변경 시 filtered 업데이트

body 또는 ForEach 내의 정렬/필터링

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

뷰 업데이트 전에 한 번 정렬 선호:

let sortedItems = items.sorted(by: sortRule)

ForEach 내의 인라인 필터링

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

안정적인 식별자를 가진 사전 필터링된 컬렉션 선호.

불안정한 식별자

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

비안정적인 값에 대해 id: \.self를 피하고, 안정적인 ID를 사용하세요.

메인 스레드에서의 이미지 디코딩

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

메인 스레드 외부에서 디코딩/다운샘플링하고 결과를 저장하는 것을 선호.

관찰 가능 모델의 광범위한 의존성

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

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

업데이트 전파(fan-out)를 줄이기 위해 세분화된 뷰 모델 또는 항목별 상태를 선호.

5. 검증

사용자에게 동일한 캡처를 다시 실행하고 기준 메트릭과 비교하도록 요청하세요.

제공된 경우 델타(CPU, 프레임 드롭, 메모리 피크)를 요약합니다.

출력물

제공:

  • 간단한 메트릭 테이블(가능한 경우 이전/이후).
  • 주요 문제(영향 순으로 정렬).
  • 제안된 수정 사항 및 예상 노력.

참고 자료

사용자가 제공하는 대로 Apple 문서 및 WWDC 자료를 references/ 아래에 추가하세요.

  • Instruments로 SwiftUI 성능 최적화: references/optimizing-swiftui-performance-instruments.md
  • SwiftUI 성능 이해 및 개선: references/understanding-improving-swiftui-performance.md
  • 앱의 멈춤 현상 이해: references/understanding-hangs-in-your-app.md
  • 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.

관련 스킬