Community编程与开发github.com

steipete/swiftui-view-refactor

SwiftUI 视图重构/审查:布局、依赖注入、Observation、视图模型。

swiftui-view-refactor 是什么?

这是一个用于 SwiftUI 视图重构和审查的 AI 技能,主要关注视图结构一致性、依赖注入模式、视图模型处理以及正确使用 Observation 框架。它提供了一套核心准则,包括视图属性和方法的严格排序规则(从上到下依次为环境变量、存储属性、计算属性、初始化器、body、视图构建器和辅助函数),并推荐采用 MV(Model-View)模式,保持视图轻量,将业务逻辑委托给模型和服务。该技能鼓励将大型 body 拆分为子视图或独立视图,同时谨慎使用视图模型——除非现有代码中已存在,否则不应引入。对于已经存在的视图模型,建议通过非可选的 @State 属性进行管理,并在初始化器中注入依赖。在 Observation 方面,要求将 @Observable 引用类型存储为根视图的 @State,并显式向下传递,避免使用可选状态。支持苹果平台的 SwiftUI 开发,能够指导 AI 代理(如 Claude Code、Cursor、Codex)系统化地重构和审查 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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SwiftUI 视图重构

归属:从 @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。
  • 根据需要显式向下传递可观察对象;除非必要,否则避免可选状态。

工作流程

  1. 重新排序视图以匹配排序规则。
  2. 优先使用 MV:使用 @State、@Environment、@Query、task 和 onChange 将轻量级编排移入视图。
  3. 如果存在视图模型,则将可选的视图模型替换为在 init 中通过从视图传递依赖项初始化的非可选 @State 视图模型。
  4. 确认 Observation 的使用:使用 @State 作为根 @Observable 视图模型,没有冗余的包装器。
  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.

相关技能