用途:审查使用 CloudKit 的代码,重点检查容器配置、数据库与分区、记录读写、订阅推送同步以及共享协作模式。适用于代码出现 import CloudKit、CKContainer 等场景。
主要能力:按四类参考文档组织检查——容器设置(CKContainer、数据库、zone、entitlements)、记录(CKRecord、引用、资源、批量操作)、订阅(CKSubscription、推送通知、静默同步)、共享(CKShare、参与者、权限、接受)。检查清单包括:私有/共享库操作前检查账户状态;生产数据使用自定义 zone 而非默认 zone;处理 CloudKit 错误并遵守 retryAfterSeconds;处理 serverRecordChanged 冲突并用正确合并逻辑;解析 CKErrorPartialFailure;使用批量操作而非逐条保存;超过 1MB 的二进制数据存为 CKAsset;记录键使用类型安全枚举;回调中更新 UI 需切回主线程;观察 CKAccountChangedNotification;订阅使用唯一 ID 防重复;CKShare 使用自定义 zone。
使用方式:按审查内容加载对应参考文档;以 [FILE:LINE] ISSUE_TITLE 格式报告问题,例如 [AppDelegate.swift:24] CKContainer not in custom zone。报告前需完成硬性门槛:位置须来自当前文件内容且路径可解析;须通读所属类型或函数的完整上下文;若结论依赖容器标识、公共/私有库选择、自定义 zone、iCloud 账户状态、entitlements 或生产 schema,须指明具体检查过的产物,否则降级为开放问题;并满足 review-verification-protocol 的预报告步骤。
限制:该技能为代码审查清单与流程说明,未提供自动修复或具体实现代码;参考文档的具体内容、安装与调用命令资料中暂未提供。