القائمة
排查 XXF iOS 相关的编译错误、运行时崩溃、性能问题。当用户贴出编译错误日志、崩溃栈、卡顿报告、内存警告，或说"XXF 报错"、"用了 XXF 后变慢"时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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创建 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` 做分区治理。