开发技能 — SwiftUI iOS 应用生成器

概述

该技能可将产品需求文档（PRD）转化为功能完备的 SwiftUI iOS 应用。它解析 PRD 中的需求，并生成具备完整架构、UI 组件、数据模型及业务逻辑的生产就绪代码。

架构模式

MVVM 架构

所有生成的代码均遵循 Model-View-ViewModel 模式：

Model 层

• 数据模型（遵循 Codable 协议的 struct）
• 数据持久化（Core Data 或 SwiftData）
• 网络层（URLSession 或 Alamofire）

ViewModel 层

• 业务逻辑与状态管理
• 数据转换与校验
• 服务协调

View 层

• 结构清晰、组件化的 SwiftUI 视图
• 导航栈管理
• UI 状态绑定

代码生成流程

1. PRD 分析

• 解析 PRD 文档以提取功能需求
• 抽取页面规格与用户操作流程
• 识别数据模型及其关系
• 确定所需的第三方集成

2. 项目结构生成

创建完整的 Xcode 项目，目录结构如下：

ProjectName/
├── ProjectName.xcodeproj
├── ProjectName/
│   ├── Models/
│   │   ├── DataModel.swift
│   │   └── APIModels.swift
│   ├── ViewModels/
│   │   ├── MainViewModel.swift
│   │   └── [Feature]ViewModel.swift
│   ├── Views/
│   │   ├── ContentView.swift
│   │   ├── [Feature]View.swift
│   │   └── Components/
│   │       ├── ButtonStyles.swift
│   │       └── CustomViews.swift
│   ├── Services/
│   │   ├── APIService.swift
│   │   └── DataService.swift
│   └── Utilities/
│       ├── Extensions.swift
│       └── Constants.swift
└── ProjectNameTests/
    └── [Feature]Tests.swift

3. 核心组件生成

3.1 数据模型

struct Task: Identifiable, Codable {
    let id: UUID
    var title: String
    var isCompleted: Bool
    var dueDate: Date?
    var category: String
    var priority: Priority
}

enum Priority: String, Codable, CaseIterable {
    case low, medium, high
}

3.2 ViewModel

class TaskViewModel: ObservableObject {
    @Published var tasks: [Task] = []
    @Published var selectedCategory: String?
    
    private let dataService: DataService
    
    init(dataService: DataService = .shared) {
        self.dataService = dataService
        loadTasks()
    }
    
    func addTask(_ task: Task) { ... }
    func deleteTask(_ task: Task) { ... }
    func toggleCompletion(_ task: Task) { ... }
}

3.3 SwiftUI 视图

struct TaskListView: View {
    @StateObject private var viewModel = TaskViewModel()
    @State private var showingAddTask = false
    
    var body: some View {
        NavigationView {
            List {
                ForEach(viewModel.tasks) { task in
                    TaskRowView(task: task)
                }
                .onDelete(perform: deleteTask)
            }
            .navigationTitle("Tasks")
            .toolbar {
                Button(action: { showingAddTask = true }) {
                    Image(systemName: "plus")
                }
            }
            .sheet(isPresented: $showingAddTask) {
                AddTaskView()
            }
        }
    }
}

4. 功能实现

4.1 导航

• 使用 TabView 实现主导航
• 使用 NavigationStack 实现层级导航
• 使用 sheet 呈现模态视图

4.2 数据持久化

• 对复杂关系使用 Core Data
• 对简单偏好设置使用 @AppStorage
• 对文档存储使用 FileManager

4.3 网络请求

• 采用 Async/Await 编写现代 API 调用
• 使用 Result 类型进行错误处理
• 使用 Codable 进行 JSON 解码

4.4 UI/UX

• 适配所有设备尺寸的自适应布局
• 支持深色模式
• 支持无障碍功能
• 集成触感反馈（Haptic feedback）

示例：基于 PRD 的待办事项应用

PRD 输入：支持分类、提醒和分享功能的待办事项应用

生成代码：

1. Models：Task、Category、Reminder
2. ViewModels：TaskListViewModel、CategoryViewModel
3. Views：TaskListView、CategoryView、AddTaskView、SettingsView
4. Services：NotificationService、SharingService
5. 功能特性：
   • 基于提醒的推送通知
   • 系统分享面板（Share Sheet）集成
   • 通过 iCloud 同步数据
   • 提供 Widget 用于快速访问

自动触发后续步骤

在生成 iOS 项目后，该技能将自动执行以下操作：

1. 在 dev-output/ 目录中创建完整的 Xcode 项目
2. 验证代码可在 Xcode 中无错误编译
3. 以生成的代码为输入，触发 qa-skill
4. 提供构建说明及下一步操作指引

集成要求

输入格式

• 来自 prd-skill 的 PRD Markdown 文档
• 含优先级标记的结构化需求
• 技术规格与约束条件

输出验证

• 所有代码必须可在 Xcode 15+ 中成功编译
• 遵循 SwiftUI 最佳实践
• 包含完善的错误处理机制
• 支持 iOS 16+ 部署目标

质量标准

• 100% 使用 SwiftUI（仅在绝对必要时才引入 UIKit）
• 职责分离合理清晰
• 提供全面的代码文档
• 遵循 Apple 人机界面指南（Human Interface Guidelines）