xxf_ios

创建 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` 做分区治理。

产出 ADR/RFC 技术决策文档，明确背景、备选方案、权衡、风险、迁移与回滚策略，避免口头决策和重复争论。

接口契约治理，规范字段兼容、错误码、版本演进、回退策略与 Mock 对齐，降低前后端联调与发布风险。

进行架构评审与分层边界审查。用于识别依赖反转、跨层调用、模块耦合、职责漂移等问题，并输出可执行整改建议。

发现并执行当前改动最相关的自动化测试，优先选择最小验证范围，汇总失败根因与残余风险。适用于回归验证、测试失败排查与提交前校验。

CI 质量门禁策略，定义构建、测试、静态扫描、风险阈值、阻断条件与例外流程，保障合入和发布质量。

执行以 findings 为中心的代码评审，优先识别 correctness bug、行为回归、缺失测试、边界破坏与安全风险。适用于提交前审查与补丁风险评估。

xxf_ios 项目的功能模块架构规范——按 Feature 分层组织代码（Api / Domain / Repository / Service / Di / Presentation）。新增或重构功能模块时必须遵守。

xxf_ios 项目的 iOS/Swift 编码规范（强制约束）——文件组织与拆分、命名、注释、访问控制。写 Swift 代码时必须遵守。

线上事故响应与复盘流程，覆盖止血、分级、指挥、沟通、根因分析、行动项追踪，降低 MTTR 与重复事故率。

大规模迁移作战手册，覆盖分阶段迁移、双写/影子验证、灰度放量、监控回归和一键回滚，控制迁移风险。

为 XXF iOS 框架本身新增一个模块（面向框架维护者，不是业务方）。当用户说"给 XXF 加个新模块"、"贡献代码到 xxf_ios"、"新建 XXFXxx target"时使用。

建立可观测性规范，统一日志字段、埋点命名、错误码、性能指标与告警阈值，提升排障效率与数据一致性。

技术项目规划与推进，包含里程碑、工作分解、依赖管理、风险台账、资源分配与周报节奏，确保按期可交付。

XXF iOS 框架接入与模块选型助手。当用户说"新项目想用 XXF"、"怎么集成 XXF iOS"、"应该引入哪些模块"、"XXFArch 和单模块怎么选"、"最低系统版本要求"时使用。

管理发布流程与版本节奏，覆盖发布清单、灰度策略、回滚预案、沟通节奏和里程碑跟踪。

对需求或代码变更做风险分级与门禁建议，输出是否阻断发布、是否必须补测试、是否需要灰度与回滚方案。

iOS 安全与隐私基线，覆盖敏感数据存储、日志脱敏、权限最小化、传输安全、第三方 SDK 合规与审计清单。

XXFSwiftFormat 代码格式化集成。当用户要在项目里接入 SwiftFormat、配置规则、CI 校验，或询问"XXF 代码风格工具"时使用。

设计测试策略与测试矩阵，覆盖单元测试、集成测试、回归测试、故障注入，并给出可执行测试计划。

排查 XXF iOS 相关的编译错误、运行时崩溃、性能问题。当用户贴出编译错误日志、崩溃栈、卡顿报告、内存警告，或说"XXF 报错"、"用了 XXF 后变慢"时使用。

为当前改动补齐或修复单元测试，优先覆盖真实风险分支、历史 bug 与关键边界，并执行最小相关测试验证结果。适用于补测、回归加固与单测修复。

XXFArch 聚合模块。当用户想"一站式"引入所有 XXF 功能、做 Demo / 内部工具、或询问 XXFArch 和单模块引入的区别时使用。

XXFDatabase 持久化抽象层（接口规范）。当用户要定义 Repository 协议、设计 Model、规划分层、或询问"数据层怎么抽象"时使用。具体 ORM 实现见 xxf-database-grdb / xxf-database-objectbox。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。

使用 XXFFlow 做响应式编程，或从 RxSwift / Combine 迁移到 XXFFlow。当用户提到 Observable、Single、Flow、操作符、subscribeOn/observeOn、线程切换、事件流，或询问"RxSwift 怎么换成 XXFFlow"时使用。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。

使用 XXFHttp 写网络接口。当用户要封装 REST API、GET/POST 请求、文件上传下载、SSE 流式响应、请求拦截器、错误统一处理，或说"用 XXFHttp 怎么…"、"网络层用 XXF 实现"时使用。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。

XXFPerformance 性能监控（主线程卡顿 / FPS / CPU / 内存 / 悬浮窗）。当用户要检测卡顿、实时看 FPS / CPU / 内存、定位性能瓶颈时使用。

使用 XXFRouter 管理页面跳转。当用户要注册路由、配置页面导航、添加跳转拦截器、实现降级策略、处理 URL Scheme 或 Universal Link、解耦模块间跳转时使用。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。

XXFUIKit 对 UIKit 的增强封装。当用户要用 XXF 提供的 View / Controller / 手势 / 布局工具（iOS 侧），或询问"XXFUIKit 有什么"时使用。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。

使用 XXFQRCode 生成二维码（文本、链接、样式化二维码、导出图片）。当用户提到“二维码生成”“带 logo 的二维码”“二维码尺寸/容错等级”等场景时使用。

使用 XXFWebView 的 Bridge 做 Web 与 Native 双向通信。当用户要在 H5 与 iOS 之间发消息、发请求、注册处理器、约定事件协议，或询问“bridge 怎么接”时使用。

Hard execution contract for AI coding agents. Deny-by-default for architecture/framework edits without explicit scope, approval, and verifiable quality gates.

XXFAdapter 适配器模式基座。当用户要在可替换实现之间切换（如图片编辑器、HUD、Tracker 等 Provider），或询问 XXF 的适配器模式 / 协议注入机制时使用。

XXFAppkit 对 AppKit（macOS）的增强封装。当用户要写 macOS 原生 UI、共享部分 iOS 逻辑，或询问"XXF macOS 侧 UI 能力"时使用。

XXFBus 事件总线（RxBus 风格）。当用户要做跨模块事件广播、发布订阅、解耦通信，或询问"XXF 怎么做通知中心替代"、"RxBus 用法"时使用。