Communityコーディング&開発github.com

steipete/swiftui-view-refactor

SwiftUI ビューのリファクタリング/レビュー:レイアウト、依存性注入、Observation、ビューモデル。

swiftui-view-refactor とは?

このスキルは、SwiftUI ビューに対して一貫性のある構造と依存性パターンを適用するためのガイドラインを提供します。主な目的は、ビューのプロパティやメソッドの順序を統一し、Model-View (MV) パターンを推奨することで、コードの可読性と保守性を向上させることです。具体的には、環境変数、プロパティ、イニシャライザ、body、ヘルパー関数などの記述順序を規定し、複雑なビューは computed property や専用の View 構造体に分割することを推奨します。また、@Observable を用いた Observation フレームワークの正しい使い方や、既存のビューモデルの扱い方についても具体的な指針を示しています。このスキルは、Claude Code や Cursor などの AI エージェントが SwiftUI コードをレビュー・リファクタリングする際に、プロジェクト全体のコード品質を均一に保つために役立ちます。

対応~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 View Refactor

帰属: @Dimillian の Dimillian/Skills (2025-12-31) よりコピー。

概要

SwiftUI ビューに一貫性のある構造と依存性パターンを適用します。順序付け、Model-View (MV) パターン、注意深いビューモデルの扱い、正しい 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 として保存します。
  • 必要に応じて Observable を明示的に子ビューに渡します。必要な場合を除き、オプショナルな状態は避けてください。

ワークフロー

  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.

関連スキル