Menu
排查 XXF iOS 相关的编译错误、运行时崩溃、性能问题。当用户贴出编译错误日志、崩溃栈、卡顿报告、内存警告，或说"XXF 报错"、"用了 XXF 后变慢"时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
创建 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-troubleshooting |
| description | 排查 XXF iOS 相关的编译错误、运行时崩溃、性能问题。当用户贴出编译错误日志、崩溃栈、卡顿报告、内存警告，或说"XXF 报错"、"用了 XXF 后变慢"时使用。 |
| allowed-tools | Read, Glob, Grep, Bash |
让用户描述或贴出 完整错误信息；不要凭猜测给答案。
| 症状 | 可能原因 | 处理 |
|---|---|---|
no such module 'XXFxxx' | Package.swift 未加 dependency | 检查 .product(name:...) |
XXFCacheMMKV 找不到 | Swift < 6.2 | 升级 Swift 或改用 XXFCache |
| 符号重复定义 | 同时引入 XXFArch 和单模块 | 二选一 |
iOS 13 不支持 | 部署目标过低 | 提升到 iOS 15+ |
| 症状 | 可能原因 | 处理 |
|---|---|---|
| Router 找不到目标 | 未注册 / key 拼错 | 检查路由常量、注册时机 |
| Flow 订阅立即释放 | 未持有订阅 | 绑定生命周期容器 |
| 数据库死锁 | 并发写 + 未串行化 | 写入走同一队列 |
| Cache miss 雪崩 | 无锁并发 | 用 XXFCache 内置并发保护 |
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 启动慢 | 在 +load / init 做重活 | 延迟到 didFinishLaunching 之后 |
| 首屏白屏 | 同步请求阻塞 | 改异步，展示骨架屏 |
| 滚动卡顿 | 主线程 IO / 图片解码 | 用 XXFPerformance 监测并迁到后台 |
| 内存持续上涨 | 订阅泄漏 / 缓存无淘汰 | 检查 DisposeBag、LRU 配置 |
要求用户提供：
swift --version、Xcode 版本Package.resolved 片段（确认 XXF 版本）# 确认 XXF 版本
grep "xxf_ios" Package.resolved -A 5
# 搜索错误相关符号
Grep "ErrorSymbol" in Sources/
如果问题难定位，建议用户剥离到一个 最小 demo（只保留触发 bug 的代码），通常过程中就能自己找出原因。
确认是 XXF 框架 bug 后，引导用户提 issue：
https://github.com/NBXXF/xxf_ios/issues