SuperAPI AI 工具集

axiom-audit-icloud

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

该技能是一个 iCloud 审计智能体,用于排查 iCloud 同步失败、CloudKit 错误、ubiquitous 容器问题。

用途:对 Swift 工程做 iCloud 集成审计,既检测已知反模式,也检查缺失或不完整模式导致的同步失败、数据损坏、冲突丢失与静默 CloudKit 错误。要求实际运行工具扫描(Glob、Grep、Read),不能凭训练数据推断;排除测试、预览、Pods、Carthage、.build、DerivedData 等路径。

主要能力分五个阶段。阶段一绘制 iCloud 使用面:识别 CloudKit、iCloud Drive、NSUbiquitousKeyValueStore、SwiftData+CloudKit、entitlement,账号与可用性检查(ubiquityIdentityToken、accountStatus、账号变更通知),错误与冲突处理面,并读取 2-3 个关键集成文件,输出 5-10 行 iCloud Map。阶段二检测 8 类反模式:ubiquitous I/O 缺少 NSFileCoordinator、缺少 CloudKit 错误处理、缺少 entitlement/可用性检查、SwiftData+CloudKit 不支持的 @Attribute(.unique) 与必填关系、iCloud Drive 缺少冲突解决、iOS 17+ 仍用旧 CloudKit API、CKSyncEngine 变更批超过 250 条上限、持久化或传输 ExportedAssetID。阶段三推理完整性缺口,如每次访问前的 token 检查、6 个关键 CKError 码覆盖、账号变更观察、跨进程协调、订阅、NSMetadataQuery 生命周期、离线回退、KV 迁移、partialFailure 重试、同步遥测等。阶段四交叉引用叠加严重度(如缺协调+多进程、缺检查+写入路径、unique 约束+cloudKitDatabase)。阶段五给出健康评分 SAFE/FRAGILE/DANGEROUS 及协调覆盖率、可用性检查覆盖率、CKError 码覆盖等指标。

输出格式为 Markdown 审计报告:iCloud Map、按严重度汇总、健康评分表、按严重度的问题详情(文件、阶段、问题、影响、修复)、建议与测试计划;超过 50 条同类或 100 条总量时做截断汇总。

适用场景:含 iCloud 同步的 iOS/macOS/watchOS 项目审计,多设备应用、扩展/小组件/Watch 共享容器、SwiftData+CloudKit 迁移、CKSyncEngine 迁移评估。

限制:面向 Swift/Apple 平台;未提供价格、平台支持范围、安装命令或调用方式;误报排除项包括非 iCloud 容器本地文件、CloudKit Console/Web Services、测试代码、未配置 cloudKitDatabase 的模型、有版本门控的旧 API、单次并在首个结果后停止的 NSMetadataQuery、明确单设备应用、同一流程内导出并保存且不持久化 ExportedAssetID 的情况。