SwiftUI视图重构

技能简介

本技能用于重构和审查SwiftUI视图文件，建立一致的代码结构、依赖注入模式和Observation使用规范。适用于清理视图布局顺序、安全处理视图模型（尽可能非可选）、标准化依赖项和@Observable状态的初始化与传递。

业务背景

解决SwiftUI项目代码混乱、维护困难的问题。通过统一代码结构和依赖注入规范，让团队成员能快速理解他人代码，降低协作成本。标准化Observation状态管理后，视图逻辑更清晰，新人上手更快，减少因代码风格不一致导致的Bug和返工。

落地案例：某App的订单详情页由多人经手，body长达300行且混用@StateObject与@ObservedObject，新需求开发时频繁出现状态不同步。使用本技能重构后，按环境变量→常量→@State顺序重组属性，将业务逻辑拆分为独立OrderModel，原可选视图模型改为非可选@State注入。最终文件结构清晰，后续功能迭代效率明显提升。

能做什么

• 按固定顺序重组视图属性：环境变量 → 常量 → @State → 计算属性 → init → body → 视图构造器 → 辅助函数
• 推行MV模式：视图轻量表达状态，业务逻辑下沉至模型/服务层
• 拆分过长body为子视图或独立View类型，提升可读性和可维护性
• 将可选视图模型改为非可选@State，通过init注入依赖
• 规范Observation使用：根视图用@State持有@Observable对象，向下显式传递

使用说明

1. 安装指令：本技能无需额外安装，直接在支持MCP的工具中调用即可。需确保项目使用SwiftUI框架，且Xcode版本支持@Observable宏（iOS 17+）。
2. 执行流程：
   ① 识别目标视图文件
   ② 按规则重排属性顺序
   ③ 评估是否引入或改造视图模型
   ④ 验证Observation使用正确性
   ⑤ 保持原有行为和布局不变
3. 输入要求：提供需要重构的SwiftUI视图代码片段或文件路径

输入与输出

见下方输入与输出表格。

风险提示

• 重构前建议备份代码或使用版本控制，避免意外丢失业务逻辑
• 本技能不修改布局或业务逻辑，但复杂视图的拆分可能影响动画或状态传递，需人工复核
• @Observable宏需iOS 17/macOS 14+，旧版本项目需评估兼容性
• 强制非可选视图模型可能改变初始化时机，需测试边界场景

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/swiftui-view-refactor/SKILL.md
来源类型：GitHub仓库技能定义文件