用途:该技能负责 SwiftUI 视图中 Observation 的归属与属性包装器接线、视图组合与功能边界、环境依赖注入、视图级异步生命周期工作、确定性预览,以及保持行为不变的视图重构。它不处理布局组件(交给 swiftui-layout-components)、响应式布局、导航、动画、性能诊断、Liquid Glass 与并发机制等。
主要能力与用法:使用前先检查项目的部署目标、Swift 语言模式与可用 SDK,保留这些设置,除非用户要求更改;新 API 需按 SDK 头文件或 Apple/Swift 文档做可用性判断。状态归属上,视图自己拥有的本地值或 @Observable 实例用 @State(默认 private);子视图只需读取用 let,需要 $property 绑定时用 @Bindable,编辑父级状态用 @Binding,深层共享依赖用 @Environment(Type.self),SwiftData 实时查询用 @Query。绑定 UI 的 observable store 通常应为 @MainActor。工作流为:记录状态所有者、输入、动作、副作用、导航交接、标识、可访问性与生命周期行为;选择能保持契约的最小结构变更;保持 body 声明式,把有意义的部分抽成独立视图、把复杂动作抽成命名方法;做有意义的抽取或高风险改动后构建并渲染预览、验证交互;若只是结构变更,需先恢复被改变的行为。
限制与注意:不要让视图直接初始化 @Observable 模型而不加 @State;不要在 body 中执行网络、持久化或变更等副作用;ForEach 对可变集合不要用动态数组索引作 id;避免单视图堆砌大量局部状态;避免在 .onAppear 中启动无法追踪取消的后台任务。预览需为已加载、加载中、空、错误等状态提供确定性夹具,安装必要环境值,使用内存或临时持久化,不得调用线上 API、生产认证、Keychain 或全局数据库。技能内还引用了架构模式、项目结构、视图重构、预览隔离、设计打磨、迁移与平台分享等参考文档。