Community研究&データ分析github.com

steipete/swiftui-performance-audit

SwiftUI パフォーマンス:レンダリング、スクロール、CPU/メモリ、更新、レイアウト、Instruments。

swiftui-performance-audit とは?

このスキルは、SwiftUI ビューのパフォーマンスをエンドツーエンドで監査するためのものです。インストルメンテーションとベースライン測定から根本原因分析、具体的な修正手順までをカバーします。ユーザーが提供するコードや症状をもとに、コードレビュー、Instruments を使ったプロファイリング、診断、修正、検証のワークフローを段階的に案内します。具体的には、@State や @Observable の広すぎるスコープによるビュー無効化ストーム、リスト内の不安定なID(毎回のレンダリングで UUID() を使用するなど)、body 内での重い処理(フォーマット、ソート、画像デコード)、レイアウトスラッシング、大きな画像のダウンサンプリング不足、暗黙的アニメーションの多用といった一般的な問題を特定し、修正するための知識とコード例を提供します。対応後は再キャプチャによる検証を促し、改善前後のメトリクス比較を支援します。

対応~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 ビューのパフォーマンスを、インストルメンテーションとベースライン測定から根本原因分析、具体的な修正手順までエンドツーエンドで監査します。

ワークフロー決定木

  • ユーザーがコードを提供した場合:"コードファーストレビュー"から開始。
  • ユーザーが症状のみを説明した場合:最小限のコード/コンテキストを求め、その後"コードファーストレビュー"を実施。
  • コードレビューで結論が出ない場合:"ユーザーをプロファイリングへ導く"に進み、トレースまたはスクリーンショットを依頼。

1. コードファーストレビュー

収集するもの:

  • 対象のビュー/機能のコード。
  • データフロー:state、environment、observable モデル。
  • 症状と再現手順。

着目する点:

  • 広範な状態変更によるビュー無効化ストーム。
  • リスト内の不安定な Identity(id の変動、レンダリングごとの UUID())。
  • body 内での重い処理(フォーマット、ソート、画像デコード)。
  • レイアウトスラッシング(深い階層、GeometryReader、優先度チェーン)。
  • ダウンサンプリングやリサイズなしの大きな画像。
  • アニメーションの過剰な階層(大きいビューツリーへの暗黙的アニメーション)。

提供するもの:

  • コード参照を含む推定される根本原因。
  • 修正案とリファクタリングの提案。
  • 必要に応じて、最小限の再現コードやインストルメンテーションの提案。

2. ユーザーをプロファイリングへ導く

Instruments でデータを収集する方法を説明します:

  • Instruments の SwiftUI テンプレートを使用(Release ビルド)。
  • 正確な操作(スクロール、ナビゲーション、アニメーション)を再現。
  • SwiftUI タイムラインと Time Profiler をキャプチャ。
  • 関連するレーンとコールツリーをエクスポートまたはスクリーンショット。

依頼するもの:

  • SwiftUI レーン + Time Profiler コールツリーのトレースエクスポートまたはスクリーンショット。
  • デバイス/OS/ビルド構成。

3. 分析と診断

SwiftUI の一般的な原因を優先:

  • 広範な状態変更によるビュー無効化ストーム。
  • リスト内の不安定な Identity(id の変動、レンダリングごとの UUID())。
  • body 内での重い処理(フォーマット、ソート、画像デコード)。
  • レイアウトスラッシング(深い階層、GeometryReader、優先度チェーン)。
  • ダウンサンプリングやリサイズなしの大きな画像。
  • アニメーションの過剰な階層(大きいビューツリーへの暗黙的アニメーション)。

トレースやログからの証拠を基に調査結果をまとめます。

4. 修正

的を絞った修正を適用:

  • 状態のスコープを狭くする(@State/@Observable をリーフビューの近くに配置)。
  • ForEach やリストの identity を安定化。
  • 重い処理を 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()
}

重い処理を行う computed プロパティ

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

ビュー更新の前に1回だけソートすることを推奨:

let sortedItems = items.sorted(by: sortRule)

ForEach でのインラインフィルタリング

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

安定した identity を持つ事前フィルタリングされたコレクションを推奨。

不安定な identity

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

安定しない値には id: \.self を避け、安定した ID を使用。

メインスレッドでの画像デコード

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

メインスレッド外でデコード/ダウンサンプリングし、結果を保存することを推奨。

Observable モデル内の広範な依存関係

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

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

粒度の細かいビューモデルやアイテムごとの状態を使用して、更新の波及を減らすことを推奨。

5. 検証

ユーザーに同じキャプチャを再実行し、ベースラインのメトリクスと比較するよう依頼します。 提供された場合、デルタ(CPU、フレームドロップ、メモリピーク)を要約します。

出力

以下のものを提供します:

  • 短いメトリクス表(可能であれば改善前/後)。
  • 主要な問題(影響度順)。
  • 推定作業量を含む修正案。

参照資料

ユーザーから提供された Apple ドキュメントや WWDC リソースは references/ 以下に追加してください。

  • SwiftUI パフォーマンスを Instruments で最適化: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.

関連スキル