القائمة
XXF iOS 框架接入与模块选型助手。当用户说"新项目想用 XXF"、"怎么集成 XXF iOS"、"应该引入哪些模块"、"XXFArch 和单模块怎么选"、"最低系统版本要求"时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
创建 XXF iOS 列表页模板（DiffableDataSource + BaseCollectionViewCell + StatefulView + 分页 ViewModel）
规范 ViewController 与 ViewModel 的分区组织方式。用于治理成员变量和方法过多、顺序混乱、阅读成本高的问题；通过 MARK 分区和职责分层保持代码导航清晰。
处理 XXF iOS 项目中的通用编码任务交付流程。用于 bugfix、功能开发、重构、回归修复等未显式指明测试或 review 的日常 coding 请求；负责自动串起模块 skill、补测、验证、代码审查与风险门禁。
iOS 性能门禁与主动鉴别。针对常规 coding 改动自动识别性能风险（主线程阻塞、列表卡顿、内存抖动、启动耗时、无效并发、过度渲染），并执行最小可行验证与门禁结论，不依赖用户额外提示。
Vibe Coding 通用治理闭环。用于把模糊需求转成可验证交付：先定义问题与边界，再走拼好码优先、最小改动、硬门禁验证、证据化交付和风险结论。适用于需求澄清、实现前规划、AI 协作治理、质量门禁落地。
XXFViewModel MVVM 的 VM 基类与生命周期。当用户要写 ViewModel、绑定 View、处理输入输出流，或询问"XXF 的 MVVM 怎么用"时使用。若出现 ViewModel 成员或方法膨胀、顺序混乱，应联动 `xxf-aaa-class-declaration-guidelines` 做分区治理。
| name | xxf-aaa-quickstart |
| description | XXF iOS 框架接入与模块选型助手。当用户说"新项目想用 XXF"、"怎么集成 XXF iOS"、"应该引入哪些模块"、"XXFArch 和单模块怎么选"、"最低系统版本要求"时使用。 |
| allowed-tools | Read, Glob, Grep, Bash |
swift --version # 要求 ≥ 6.0
xcodebuild -version # 要求 iOS 15+ / macOS 13+
如低于要求，停止并告知用户升级，不要强行集成。
以 AskUserQuestion 方式问清以下问题，禁止代用户决定：
根据需求推荐，不要一把 XXFArch 梭哈：
| 需求 | 推荐模块 | 备注 |
|---|---|---|
| 只要网络 | XXFHttp + XXFFoundation | 最小集成 |
| 网络 + 响应式 | 加 XXFFlow | 替代 RxSwift |
| 加持久化 | 加 XXFDatabase + 选一个实现 | GRDB 或 ObjectBox |
| 加缓存 | 加 XXFCache（+ XXFCacheMMKV 若 Swift 6.2+） | MMKV 需更高 Swift 版本 |
| 全家桶 | XXFArch | 体积大，Demo / 内部工具可用 |
仅示范结构，实际依赖版本让用户自己查 git tag：
dependencies: [
.package(url: "https://github.com/NBXXF/xxf_ios.git", from: "<version>")
],
targets: [
.target(
name: "MyApp",
dependencies: [
.product(name: "XXFHttp", package: "xxf_ios"),
.product(name: "XXFFlow", package: "xxf_ios"),
]
)
]
让用户执行：
swift build 2>&1 | tail -20
若失败，路由到 xxf-aaa-troubleshooting。
Sources/ 为准，可用 Glob 查看：Sources/XXF*。XXFImageEditorBrightroom）必须和基础模块（XXFImageEditor）一起引入。XXFFoundation ← 几乎所有模块的基础
↓
XXFHttp / XXFFlow / XXFCache / XXFBus / XXFLog ← 业务常用
↓
XXFDatabase → XXFDatabaseGrdb / XXFDatabaseObjectBox ← 选一个实现
XXFImageEditor → XXFImageEditorBrightroom ← Provider 模式
XXFTracker → XXFTrackerSentry / Firebase / Bugsnag ← 埋点选型
XXFHud → XXFHudiOS / XXFHudMac ← 平台选型