初始提交：创建 Swift UIKit iOS MVVM 工程规范

AGENTS.md

@@ -0,0 +1,41 @@
+# suixinkan
+
+## 项目概览
+
+这是一个 **Swift + UIKit** 的 iOS 工程，采用 **MVVM** 设计模式。
+
+## 平台与设备
+
+- **最低系统版本**：iOS 16
+- **设备**：仅支持 iPhone（`TARGETED_DEVICE_FAMILY = 1`）
+- **屏幕方向**：仅竖屏（Portrait）
+
+开发时请遵守以上约束，不要引入 iPad 专属布局、横屏适配或低于 iOS 16 的 API。
+
+## 架构（MVVM）
+
+按 MVVM 分层组织代码，职责清晰：
+
+| 层级 | 职责 |
+|------|------|
+| **View** | `UIViewController` / 自定义 `UIView`，负责 UI 展示与用户交互，不包含业务逻辑 |
+| **ViewModel** | 处理业务逻辑与状态，向 View 暴露可绑定的数据；不直接引用 UIKit 视图 |
+| **Model** | 数据模型、网络/本地数据源 |
+
+### 约定
+
+- View 通过 ViewModel 获取数据并响应用户操作，避免在 ViewController 中写复杂业务逻辑
+- ViewModel 不依赖 `UIViewController` 或具体 View 类型
+- 新增功能时，优先创建对应的 Model、ViewModel、View（Controller）文件，保持结构一致
+
+## 技术栈
+
+- **语言**：Swift
+- **UI 框架**：UIKit（Storyboard / 代码布局均可，与现有工程保持一致）
+- **入口**：`AppDelegate`、`SceneDelegate`、`Main.storyboard`
+
+## 开发注意
+
+- 使用 iOS 16+ 可用 API；如需兼容更低版本，需先与项目维护者确认
+- UI 按竖屏 iPhone 设计，无需考虑横屏与 iPad 分屏
+- 保持代码简洁，遵循现有命名与目录风格