[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7305CPYFT4W2FSGNQP342JR":3,"skill-same:01M7305CPYFT4W2FSGNQP342JR":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7305CPYFT4W2FSGNQP342JR","swiftui-patterns",null,"SwiftUI 架构模式，使用 @Observable 进行状态管理，视图组合，导航，性能优化，以及现代 iOS\u002FmacOS UI 最佳实践。","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fskills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fswiftui-patterns\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: swiftui-patterns\ndescription: SwiftUI 架构模式，使用 @Observable 进行状态管理，视图组合，导航，性能优化，以及现代 iOS\u002FmacOS UI 最佳实践。\n---\n\n# SwiftUI 模式\n\n适用于 Apple 平台的现代 SwiftUI 模式，用于构建声明式、高性能的用户界面。涵盖 Observation 框架、视图组合、类型安全导航和性能优化。\n\n## 何时激活\n\n* 构建 SwiftUI 视图和管理状态时（`@State`、`@Observable`、`@Binding`）\n* 使用 `NavigationStack` 设计导航流程时\n* 构建视图模型和数据流时\n* 优化列表和复杂布局的渲染性能时\n* 在 SwiftUI 中使用环境值和依赖注入时\n\n## 状态管理\n\n### 属性包装器选择\n\n选择最适合的最简单包装器：\n\n| 包装器 | 使用场景 |\n|---------|----------|\n| `@State` | 视图本地的值类型（开关、表单字段、Sheet 展示） |\n| `@Binding` | 指向父视图 `@State` 的双向引用 |\n| `@Observable` 类 + `@State` | 拥有多个属性的自有模型 |\n| `@Observable` 类（无包装器） | 从父视图传递的只读引用 |\n| `@Bindable` | 指向 `@Observable` 属性的双向绑定 |\n| `@Environment` | 通过 `.environment()` 注入的共享依赖项 |\n\n### @Observable ViewModel\n\n使用 `@Observable`（而非 `ObservableObject`）—— 它跟踪属性级别的变更，因此 SwiftUI 只会重新渲染读取了已变更属性的视图：\n\n```swift\n@Observable\nfinal class ItemListViewModel {\n    private(set) var items: [Item] = []\n    private(set) var isLoading = false\n    var searchText = \"\"\n\n    private let repository: any ItemRepository\n\n    init(repository: any ItemRepository = DefaultItemRepository()) {\n        self.repository = repository\n    }\n\n    func load() async {\n        isLoading = true\n        defer { isLoading = false }\n        items = (try? await repository.fetchAll()) ?? []\n    }\n}\n```\n\n### 消费 ViewModel 的视图\n\n```swift\nstruct ItemListView: View {\n    @State private var viewModel: ItemListViewModel\n\n    init(viewModel: ItemListViewModel = ItemListViewModel()) {\n        _viewModel = State(initialValue: viewModel)\n    }\n\n    var body: some View {\n        List(viewModel.items) { item in\n            ItemRow(item: item)\n        }\n        .searchable(text: $viewModel.searchText)\n        .overlay { if viewModel.isLoading { ProgressView() } }\n        .task { await viewModel.load() }\n    }\n}\n```\n\n### 环境注入\n\n用 `@Environment` 替换 `@EnvironmentObject`：\n\n```swift\n\u002F\u002F Inject\nContentView()\n    .environment(authManager)\n\n\u002F\u002F Consume\nstruct ProfileView: View {\n    @Environment(AuthManager.self) private var auth\n\n    var body: some View {\n        Text(auth.currentUser?.name ?? \"Guest\")\n    }\n}\n```\n\n## 视图组合\n\n### 提取子视图以限制失效\n\n将视图拆分为小型、专注的结构体。当状态变更时，只有读取该状态的子视图会重新渲染：\n\n```swift\nstruct OrderView: View {\n    @State private var viewModel = OrderViewModel()\n\n    var body: some View {\n        VStack {\n            OrderHeader(title: viewModel.title)\n            OrderItemList(items: viewModel.items)\n            OrderTotal(total: viewModel.total)\n        }\n    }\n}\n```\n\n### 用于可复用样式的 ViewModifier\n\n```swift\nstruct CardModifier: ViewModifier {\n    func body(content: Content) -> some View {\n        content\n            .padding()\n            .background(.regularMaterial)\n            .clipShape(RoundedRectangle(cornerRadius: 12))\n    }\n}\n\nextension View {\n    func cardStyle() -> some View {\n        modifier(CardModifier())\n    }\n}\n```\n\n## 导航\n\n### 类型安全的 NavigationStack\n\n使用 `NavigationStack` 与 `NavigationPath` 来实现程序化、类型安全的路由：\n\n```swift\n@Observable\nfinal class Router {\n    var path = NavigationPath()\n\n    func navigate(to destination: Destination) {\n        path.append(destination)\n    }\n\n    func popToRoot() {\n        path = NavigationPath()\n    }\n}\n\nenum Destination: Hashable {\n    case detail(Item.ID)\n    case settings\n    case profile(User.ID)\n}\n\nstruct RootView: View {\n    @State private var router = Router()\n\n    var body: some View {\n        NavigationStack(path: $router.path) {\n            HomeView()\n                .navigationDestination(for: Destination.self) { dest in\n                    switch dest {\n                    case .detail(let id): ItemDetailView(itemID: id)\n                    case .settings: SettingsView()\n                    case .profile(let id): ProfileView(userID: id)\n                    }\n                }\n        }\n        .environment(router)\n    }\n}\n```\n\n## 性能\n\n### 为大型集合使用惰性容器\n\n`LazyVStack` 和 `LazyHStack` 仅在视图可见时才创建它们：\n\n```swift\nScrollView {\n    LazyVStack(spacing: 8) {\n        ForEach(items) { item in\n            ItemRow(item: item)\n        }\n    }\n}\n```\n\n### 稳定的标识符\n\n在 `ForEach` 中始终使用稳定、唯一的 ID —— 避免使用数组索引：\n\n```swift\n\u002F\u002F Use Identifiable conformance or explicit id\nForEach(items, id: \\.stableID) { item in\n    ItemRow(item: item)\n}\n```\n\n### 避免在 body 中进行昂贵操作\n\n* 切勿在 `body` 内执行 I\u002FO、网络调用或繁重计算\n* 使用 `.task {}` 处理异步工作 —— 当视图消失时它会自动取消\n* 在滚动视图中谨慎使用 `.sensoryFeedback()` 和 `.geometryGroup()`\n* 在列表中最小化使用 `.shadow()`、`.blur()` 和 `.mask()` —— 它们会触发屏幕外渲染\n\n### 遵循 Equatable\n\n对于 body 计算昂贵的视图，遵循 `Equatable` 以跳过不必要的重新渲染：\n\n```swift\nstruct ExpensiveChartView: View, Equatable {\n    let dataPoints: [DataPoint] \u002F\u002F DataPoint must conform to Equatable\n\n    static func == (lhs: Self, rhs: Self) -> Bool {\n        lhs.dataPoints == rhs.dataPoints\n    }\n\n    var body: some View {\n        \u002F\u002F Complex chart rendering\n    }\n}\n```\n\n## 预览\n\n使用 `#Preview` 宏配合内联模拟数据以进行快速迭代：\n\n```swift\n#Preview(\"Empty state\") {\n    ItemListView(viewModel: ItemListViewModel(repository: EmptyMockRepository()))\n}\n\n#Preview(\"Loaded\") {\n    ItemListView(viewModel: ItemListViewModel(repository: PopulatedMockRepository()))\n}\n```\n\n## 应避免的反模式\n\n* 在新代码中使用 `ObservableObject` \u002F `@Published` \u002F `@StateObject` \u002F `@EnvironmentObject` —— 迁移到 `@Observable`\n* 将异步工作直接放在 `body` 或 `init` 中 —— 使用 `.task {}` 或显式的加载方法\n* 在不拥有数据的子视图中将视图模型创建为 `@State` —— 改为从父视图传递\n* 使用 `AnyView` 类型擦除 —— 对于条件视图，优先选择 `@ViewBuilder` 或 `Group`\n* 在向 Actor 传递数据或从 Actor 接收数据时忽略 `Sendable` 要求\n\n## 参考\n\n查看技能：`swift-actor-persistence` 以了解基于 Actor 的持久化模式。\n查看技能：`swift-protocol-di-testing` 以了解基于协议的 DI 和使用 Swift Testing 进行测试。\n","# SwiftUI 模式\n\n适用于 Apple 平台的现代 SwiftUI 模式，用于构建声明式、高性能的用户界面。涵盖 Observation 框架、视图组合、类型安全导航和性能优化。\n\n## 何时激活\n\n* 构建 SwiftUI 视图和管理状态时（`@State`、`@Observable`、`@Binding`）\n* 使用 `NavigationStack` 设计导航流程时\n* 构建视图模型和数据流时\n* 优化列表和复杂布局的渲染性能时\n* 在 SwiftUI 中使用环境值和依赖注入时\n\n## 状态管理\n\n### 属性包装器选择\n\n选择最适合的最简单包装器：\n\n| 包装器 | 使用场景 |\n|---------|----------|\n| `@State` | 视图本地的值类型（开关、表单字段、Sheet 展示） |\n| `@Binding` | 指向父视图 `@State` 的双向引用 |\n| `@Observable` 类 + `@State` | 拥有多个属性的自有模型 |\n| `@Observable` 类（无包装器） | 从父视图传递的只读引用 |\n| `@Bindable` | 指向 `@Observable` 属性的双向绑定 |\n| `@Environment` | 通过 `.environment()` 注入的共享依赖项 |\n\n### @Observable ViewModel\n\n使用 `@Observable`（而非 `ObservableObject`）—— 它跟踪属性级别的变更，因此 SwiftUI 只会重新渲染读取了已变更属性的视图：\n\n```swift\n@Observable\nfinal class ItemListViewModel {\n    private(set) var items: [Item] = []\n    private(set) var isLoading = false\n    var searchText = \"\"\n\n    private let repository: any ItemRepository\n\n    init(repository: any ItemRepository = DefaultItemRepository()) {\n        self.repository = repository\n    }\n\n    func load() async {\n        isLoading = true\n        defer { isLoading = false }\n        items = (try? await repository.fetchAll()) ?? []\n    }\n}\n```\n\n### 消费 ViewModel 的视图\n\n```swift\nstruct ItemListView: View {\n    @State private var viewModel: ItemListViewModel\n\n    init(viewModel: ItemListViewModel = ItemListViewModel()) {\n        _viewModel = State(initialValue: viewModel)\n    }\n\n    var body: some View {\n        List(viewModel.items) { item in\n            ItemRow(item: item)\n        }\n        .searchable(text: $viewModel.searchText)\n        .overlay { if viewModel.isLoading { ProgressView() } }\n        .task { await viewModel.load() }\n    }\n}\n```\n\n### 环境注入\n\n用 `@Environment` 替换 `@EnvironmentObject`：\n\n```swift\n\u002F\u002F Inject\nContentView()\n    .environment(authManager)\n\n\u002F\u002F Consume\nstruct ProfileView: View {\n    @Environment(AuthManager.self) private var auth\n\n    var body: some View {\n        Text(auth.currentUser?.name ?? \"Guest\")\n    }\n}\n```\n\n## 视图组合\n\n### 提取子视图以限制失效\n\n将视图拆分为小型、专注的结构体。当状态变更时，只有读取该状态的子视图会重新渲染：\n\n```swift\nstruct OrderView: View {\n    @State private var viewModel = OrderViewModel()\n\n    var body: some View {\n        VStack {\n            OrderHeader(title: viewModel.title)\n            OrderItemList(items: viewModel.items)\n            OrderTotal(total: viewModel.total)\n        }\n    }\n}\n```\n\n### 用于可复用样式的 ViewModifier\n\n```swift\nstruct CardModifier: ViewModifier {\n    func body(content: Content) -> some View {\n        content\n            .padding()\n            .background(.regularMaterial)\n            .clipShape(RoundedRectangle(cornerRadius: 12))\n    }\n}\n\nextension View {\n    func cardStyle() -> some View {\n        modifier(CardModifier())\n    }\n}\n```\n\n## 导航\n\n### 类型安全的 NavigationStack\n\n使用 `NavigationStack` 与 `NavigationPath` 来实现程序化、类型安全的路由：\n\n```swift\n@Observable\nfinal class Router {\n    var path = NavigationPath()\n\n    func navigate(to destination: Destination) {\n        path.append(destination)\n    }\n\n    func popToRoot() {\n        path = NavigationPath()\n    }\n}\n\nenum Destination: Hashable {\n    case detail(Item.ID)\n    case settings\n    case profile(User.ID)\n}\n\nstruct RootView: View {\n    @State private var router = Router()\n\n    var body: some View {\n        NavigationStack(path: $router.path) {\n            HomeView()\n                .navigationDestination(for: Destination.self) { dest in\n                    switch dest {\n                    case .detail(let id): ItemDetailView(itemID: id)\n                    case .settings: SettingsView()\n                    case .profile(let id): ProfileView(userID: id)\n                    }\n                }\n        }\n        .environment(router)\n    }\n}\n```\n\n## 性能\n\n### 为大型集合使用惰性容器\n\n`LazyVStack` 和 `LazyHStack` 仅在视图可见时才创建它们：\n\n```swift\nScrollView {\n    LazyVStack(spacing: 8) {\n        ForEach(items) { item in\n            ItemRow(item: item)\n        }\n    }\n}\n```\n\n### 稳定的标识符\n\n在 `ForEach` 中始终使用稳定、唯一的 ID —— 避免使用数组索引：\n\n```swift\n\u002F\u002F Use Identifiable conformance or explicit id\nForEach(items, id: \\.stableID) { item in\n    ItemRow(item: item)\n}\n```\n\n### 避免在 body 中进行昂贵操作\n\n* 切勿在 `body` 内执行 I\u002FO、网络调用或繁重计算\n* 使用 `.task {}` 处理异步工作 —— 当视图消失时它会自动取消\n* 在滚动视图中谨慎使用 `.sensoryFeedback()` 和 `.geometryGroup()`\n* 在列表中最小化使用 `.shadow()`、`.blur()` 和 `.mask()` —— 它们会触发屏幕外渲染\n\n### 遵循 Equatable\n\n对于 body 计算昂贵的视图，遵循 `Equatable` 以跳过不必要的重新渲染：\n\n```swift\nstruct ExpensiveChartView: View, Equatable {\n    let dataPoints: [DataPoint] \u002F\u002F DataPoint must conform to Equatable\n\n    static func == (lhs: Self, rhs: Self) -> Bool {\n        lhs.dataPoints == rhs.dataPoints\n    }\n\n    var body: some View {\n        \u002F\u002F Complex chart rendering\n    }\n}\n```\n\n## 预览\n\n使用 `#Preview` 宏配合内联模拟数据以进行快速迭代：\n\n```swift\n#Preview(\"Empty state\") {\n    ItemListView(viewModel: ItemListViewModel(repository: EmptyMockRepository()))\n}\n\n#Preview(\"Loaded\") {\n    ItemListView(viewModel: ItemListViewModel(repository: PopulatedMockRepository()))\n}\n```\n\n## 应避免的反模式\n\n* 在新代码中使用 `ObservableObject` \u002F `@Published` \u002F `@StateObject` \u002F `@EnvironmentObject` —— 迁移到 `@Observable`\n* 将异步工作直接放在 `body` 或 `init` 中 —— 使用 `.task {}` 或显式的加载方法\n* 在不拥有数据的子视图中将视图模型创建为 `@State` —— 改为从父视图传递\n* 使用 `AnyView` 类型擦除 —— 对于条件视图，优先选择 `@ViewBuilder` 或 `Group`\n* 在向 Actor 传递数据或从 Actor 接收数据时忽略 `Sendable` 要求\n\n## 参考\n\n查看技能：`swift-actor-persistence` 以了解基于 Actor 的持久化模式。\n查看技能：`swift-protocol-di-testing` 以了解基于协议的 DI 和使用 Swift Testing 进行测试。\n",{"name":5,"description":7},"master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","skills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fswiftui-patterns",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add SriramGandhiS\u002FSkills --skill swiftui-patterns",{"tool":39,"command":40},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill swiftui-patterns",{"tool":42,"command":43},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill swiftui-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fskills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fswiftui-patterns\u002FSKILL.md",true,[],[48,55,60,66,73,80],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":56,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]