用途:系统性地通过 Sosumi MCP 扫描 Apple 开发者文档,识别已弃用的 SwiftUI API 及其现代替代方案,并更新 skills/swiftui-expert-skill/references/latest-apis.md。
前提条件:Sosumi MCP 必须启用并可用(提供 searchAppleDocumentation、fetchAppleDocumentation、fetchAppleVideoTranscript、fetchExternalDocumentation);需对本仓库或 fork 有写入权限。
工作流:1) 先阅读 latest-apis.md,了解已记录的弃用至现代转换、使用的版本分段(iOS 15+、16+、17+、18+、26+)以及底部 Quick Lookup Table。2) 读取 references/scan-manifest.md,其中包含待扫描的 API 领域、文档路径、搜索查询与 WWDC 视频路径的分类清单。3) 按清单逐类扫描 Apple 文档:用 searchAppleDocumentation 发现相关页面,用 fetchAppleDocumentation 获取完整 API 细节,查找弃用通知、“Deprecated”标签和“Use ... instead”指引,记录现代替代方案可用的 iOS 版本,可选调用 fetchAppleVideoTranscript 获取宣布 API 变更的 WWDC 会话文字稿;批量合并相关搜索以提高效率,重点寻找 latest-apis.md 中尚未记录的新弃用。4) 与现有条目对比,归类为新弃用、修正(版本错误或存在更好替代)或新版本分段。5) 严格按既定格式更新 latest-apis.md:条目放入正确的版本分段(长期弃用放入“Always Use (iOS 15+)”,版本受限变更放入“When Targeting iOS 16+/17+/18+/26+”),条目格式为加粗句子说明应使用现代 API 替代弃用 API,并附 Swift 代码块对比现代与弃用写法,同时在文件底部 Quick Lookup Table 添加一行(弃用 API、现代 API、iOS 版本),并保留文件顶部的来源说明行。6) 从 main 创建名为 update/latest-apis-YYYY-MM 的分支,提交对 latest-apis.md 的修改,并用 gh pr create 创建 PR,标题为“Update latest SwiftUI APIs (Month Year)”,正文概述新增或变更条目并注明基于 Sosumi MCP。
提示:先用宽泛查询再深入具体路径;Apple 弃用文档通常标注“Deprecated”并链接替代方案;WWDC“What's new in SwiftUI”是获取新替代方案的最佳来源;不确定弃用的确切 iOS 版本时,核对获取文档中的“Availability”部分;若某 API 已弃用但无直接替代,应注明而非给出错误替代。
限制:依赖 Sosumi MCP 的可用性;需要仓库写入权限;具体平台、定价、效果等信息暂未提供。