[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77Y7WXDH10PHSH1M3KBB8X3":3,"skill-same:01M77Y7WXDH10PHSH1M3KBB8X3":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},"01M77Y7WXDH10PHSH1M3KBB8X3","swiftui-patterns",null,"SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS\u002FmacOS UI best practices.","503496348-ops\u002Fmischief-production","503496348-ops","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F266905914?v=4","01M77X5J7XQWWZGT8998HDGXQM","AtomCollide","01M77X5J8V78Y3NXMY6BBC75X9",2,"MIT","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fecc-swiftui-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: swiftui-patterns\ndescription: SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS\u002FmacOS UI best practices.\n---\n\n# SwiftUI Patterns\n\nModern SwiftUI patterns for building declarative, performant user interfaces on Apple platforms. Covers the Observation framework, view composition, type-safe navigation, and performance optimization.\n\n## When to Activate\n\n- Building SwiftUI views and managing state (`@State`, `@Observable`, `@Binding`)\n- Designing navigation flows with `NavigationStack`\n- Structuring view models and data flow\n- Optimizing rendering performance for lists and complex layouts\n- Working with environment values and dependency injection in SwiftUI\n\n## State Management\n\n### Property Wrapper Selection\n\nChoose the simplest wrapper that fits:\n\n| Wrapper | Use Case |\n|---------|----------|\n| `@State` | View-local value types (toggles, form fields, sheet presentation) |\n| `@Binding` | Two-way reference to parent's `@State` |\n| `@Observable` class + `@State` | Owned model with multiple properties |\n| `@Observable` class (no wrapper) | Read-only reference passed from parent |\n| `@Bindable` | Two-way binding to an `@Observable` property |\n| `@Environment` | Shared dependencies injected via `.environment()` |\n\n### @Observable ViewModel\n\nUse `@Observable` (not `ObservableObject`) — it tracks property-level changes so SwiftUI only re-renders views that read the changed property:\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### View Consuming the 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### Environment Injection\n\nReplace `@EnvironmentObject` with `@Environment`:\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## View Composition\n\n### Extract Subviews to Limit Invalidation\n\nBreak views into small, focused structs. When state changes, only the subview reading that state re-renders:\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 for Reusable Styling\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## Navigation\n\n### Type-Safe NavigationStack\n\nUse `NavigationStack` with `NavigationPath` for programmatic, type-safe routing:\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## Performance\n\n### Use Lazy Containers for Large Collections\n\n`LazyVStack` and `LazyHStack` create views only when visible:\n\n```swift\nScrollView {\n    LazyVStack(spacing: 8) {\n        ForEach(items) { item in\n            ItemRow(item: item)\n        }\n    }\n}\n```\n\n### Stable Identifiers\n\nAlways use stable, unique IDs in `ForEach` — avoid using array indices:\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### Avoid Expensive Work in body\n\n- Never perform I\u002FO, network calls, or heavy computation inside `body`\n- Use `.task {}` for async work — it cancels automatically when the view disappears\n- Use `.sensoryFeedback()` and `.geometryGroup()` sparingly in scroll views\n- Minimize `.shadow()`, `.blur()`, and `.mask()` in lists — they trigger offscreen rendering\n\n### Equatable Conformance\n\nFor views with expensive bodies, conform to `Equatable` to skip unnecessary re-renders:\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## Previews\n\nUse `#Preview` macro with inline mock data for fast iteration:\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## Anti-Patterns to Avoid\n\n- Using `ObservableObject` \u002F `@Published` \u002F `@StateObject` \u002F `@EnvironmentObject` in new code — migrate to `@Observable`\n- Putting async work directly in `body` or `init` — use `.task {}` or explicit load methods\n- Creating view models as `@State` inside child views that don't own the data — pass from parent instead\n- Using `AnyView` type erasure — prefer `@ViewBuilder` or `Group` for conditional views\n- Ignoring `Sendable` requirements when passing data to\u002Ffrom actors\n\n## References\n\nSee skill: `swift-actor-persistence` for actor-based persistence patterns.\nSee skill: `swift-protocol-di-testing` for protocol-based DI and testing with Swift Testing.\n","# SwiftUI Patterns\n\nModern SwiftUI patterns for building declarative, performant user interfaces on Apple platforms. Covers the Observation framework, view composition, type-safe navigation, and performance optimization.\n\n## When to Activate\n\n- Building SwiftUI views and managing state (`@State`, `@Observable`, `@Binding`)\n- Designing navigation flows with `NavigationStack`\n- Structuring view models and data flow\n- Optimizing rendering performance for lists and complex layouts\n- Working with environment values and dependency injection in SwiftUI\n\n## State Management\n\n### Property Wrapper Selection\n\nChoose the simplest wrapper that fits:\n\n| Wrapper | Use Case |\n|---------|----------|\n| `@State` | View-local value types (toggles, form fields, sheet presentation) |\n| `@Binding` | Two-way reference to parent's `@State` |\n| `@Observable` class + `@State` | Owned model with multiple properties |\n| `@Observable` class (no wrapper) | Read-only reference passed from parent |\n| `@Bindable` | Two-way binding to an `@Observable` property |\n| `@Environment` | Shared dependencies injected via `.environment()` |\n\n### @Observable ViewModel\n\nUse `@Observable` (not `ObservableObject`) — it tracks property-level changes so SwiftUI only re-renders views that read the changed property:\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### View Consuming the 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### Environment Injection\n\nReplace `@EnvironmentObject` with `@Environment`:\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## View Composition\n\n### Extract Subviews to Limit Invalidation\n\nBreak views into small, focused structs. When state changes, only the subview reading that state re-renders:\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 for Reusable Styling\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## Navigation\n\n### Type-Safe NavigationStack\n\nUse `NavigationStack` with `NavigationPath` for programmatic, type-safe routing:\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## Performance\n\n### Use Lazy Containers for Large Collections\n\n`LazyVStack` and `LazyHStack` create views only when visible:\n\n```swift\nScrollView {\n    LazyVStack(spacing: 8) {\n        ForEach(items) { item in\n            ItemRow(item: item)\n        }\n    }\n}\n```\n\n### Stable Identifiers\n\nAlways use stable, unique IDs in `ForEach` — avoid using array indices:\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### Avoid Expensive Work in body\n\n- Never perform I\u002FO, network calls, or heavy computation inside `body`\n- Use `.task {}` for async work — it cancels automatically when the view disappears\n- Use `.sensoryFeedback()` and `.geometryGroup()` sparingly in scroll views\n- Minimize `.shadow()`, `.blur()`, and `.mask()` in lists — they trigger offscreen rendering\n\n### Equatable Conformance\n\nFor views with expensive bodies, conform to `Equatable` to skip unnecessary re-renders:\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## Previews\n\nUse `#Preview` macro with inline mock data for fast iteration:\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## Anti-Patterns to Avoid\n\n- Using `ObservableObject` \u002F `@Published` \u002F `@StateObject` \u002F `@EnvironmentObject` in new code — migrate to `@Observable`\n- Putting async work directly in `body` or `init` — use `.task {}` or explicit load methods\n- Creating view models as `@State` inside child views that don't own the data — pass from parent instead\n- Using `AnyView` type erasure — prefer `@ViewBuilder` or `Group` for conditional views\n- Ignoring `Sendable` requirements when passing data to\u002Ffrom actors\n\n## References\n\nSee skill: `swift-actor-persistence` for actor-based persistence patterns.\nSee skill: `swift-protocol-di-testing` for protocol-based DI and testing with Swift Testing.\n",{"name":5,"description":7},"main","c9103dbad48ef3005f163584d0f2abd4591217f6","skills\u002Fecc-swiftui-patterns",1,"https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production","https:\u002F\u002Fgithub.com\u002F503496348-ops","https:\u002F\u002F503496348-ops.github.io\u002Fatomcollide-product-matrix\u002F#tree","元素碰撞-AtomCollide-AI 智能体实验室 测试人专属成长社群 正式招募\r\n我们的目标很纯粹：连接每一位测试工程师\u002FAI使用探索与爱好者，让你在这里既能扎实打磨技术硬实力，也能打通职业晋升的新通路，这是一个专注于AI领域的开源组","2026-07-30 00:35:42",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add 503496348-ops\u002Fmischief-production --skill swiftui-patterns",{"tool":39,"command":40},"bunx","bunx skills add 503496348-ops\u002Fmischief-production --skill swiftui-patterns",{"tool":42,"command":43},"pnpm","pnpm dlx skills add 503496348-ops\u002Fmischief-production --skill swiftui-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fecc-swiftui-patterns\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"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},"01M77YG7NPZHE751W9QGK3H9ED","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-writing-skills\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M77YG4HPYH0GJP974DZ6KCPQ","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-writing-plans\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M77YFZW1FZ1GVC5C89NPE5M8","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-verification-before-completion\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M77YFVPWANT5VE5GWBTKHPA2","using-智械工程","Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-using-superpowers\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M77YFQJAW5PX3QYSBCD3B24S","using-git-worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-using-git-worktrees\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M77YFMSTB70VX8W2QHNJWYB0","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002F503496348-ops\u002Fmischief-production\u002Fblob\u002Fmain\u002Fskills\u002Fsp-test-driven-development\u002FSKILL.md",[],[]]