菜单
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 ← 平台选型