SwiftUI API 更新维护技能
扫描 Apple 文档，持续更新 SwiftUI 弃用 API 的现代替代方案。
技能明确要求访问Apple文档并写入仓库，且流程透明、限定更新latest-apis.md；但要求创建分支、提交并通过gh创建PR，没有明确的用户确认、敏感数据处理、权限隔离、回滚或外部副作用控制，因此扣分。
工作流、扫描清单、工具参数和条目格式较具体，正常路径可理解；但未提供异常输入、Sosumi不可用、文档路径失效或写入失败时的诊断和恢复机制，也没有覆盖该技能关键路径的测试，因此受静态上限约束并扣分。
触发条件、维护者受众和目标文件清晰；但只适用于具备Sosumi MCP及仓库写权限的维护场景，未说明非适用范围、输出验收标准或中文使用支持，且中国大陆网络可达性未验证，因此扣分。
结构清晰，包含前置条件、分步流程、清单、工具参考和输出格式；README与许可证提供了仓库级许可和维护背景，但该技能自身没有版本、变更记录、责任人、更新路径、故障排查或回滚说明，因此扣分。
目标是扫描弃用API并更新参考文档，产物格式和Quick Lookup要求具有直接可用性；但静态材料没有证明扫描完整性、替换正确性或PR结果可用，且仍需人工审阅Apple文档和变更，因此仅给有限分数。
技能指向Apple文档、WWDC转录和Sosumi工具，并要求保留归因行，具备一定审计线索；但没有执行记录、测试套件或第三方验证证据，无法独立复现关键结论，因此低分。
- 执行流程依赖Sosumi MCP；其可用性、数据边界及中国大陆网络可达性未在材料中验证。
- 创建提交和PR属于外部副作用，技能未要求执行前确认，也未说明失败后的回滚步骤。
- 扫描结果、API替换和版本判断必须由维护者人工核验；静态材料没有证明覆盖完整或结果正确。
它能做什么 & 适用场景
这是 AvdLee/SwiftUI-Agent-Skill 仓库中的独立维护技能，专门维护 SwiftUI 专家技能的最新 API 参考。它通过 Sosumi MCP 扫描 Apple 开发者文档，识别弃用 API 及其替代方案，并更新 latest-apis.md。技能还规定了版本分段、条目格式和快速查找表的维护方式。它适合需要在新 iOS 或 Xcode 发布后刷新 API 指南的团队，但依赖 Sosumi MCP 和仓库写入权限。
读取 swiftui-expert-skill/references/latest-apis.md 和 references/scan-manifest.md；使用 Sosumi MCP 的 searchAppleDocumentation、fetchAppleDocumentation，并可选调用 fetchAppleVideoTranscript；比较新发现与现有条目，分类新增弃用、修正和新版本分段；更新 latest-apis.md；创建 update/latest-apis-YYYY-MM 分支，提交变更，并使用 gh pr create 创建拉取请求。
- 维护 SwiftUI 专家技能的团队在发布新 iOS 或 Xcode 版本后扫描 API 变化。
- 需要查找尚未记录的 SwiftUI 弃用 API 及官方现代替代方案的开发者。
- 希望通过统一版本段落和快速查找表审查 API 迁移内容的维护者。
- 拥有 Sosumi MCP 和仓库写入权限、希望以拉取请求提交维护更新的贡献者。
优缺点一览
- 流程明确，覆盖扫描、比较、格式化、提交和创建 PR。
- 以 Apple 开发者文档为主要依据，并要求记录现代替代方案的 iOS 版本。
- 包含 scan manifest，便于按 API 类别系统化检查。
- 必须启用 Sosumi MCP，否则无法执行核心文档扫描。
- 需要仓库写入权限以及 GitHub CLI 才能完成分支、提交和 PR 流程。
- 源材料没有提供测试套件或对其他 MCP 实现的兼容性证据。
- 它只维护 latest-apis.md，不是用于一般 SwiftUI 编程指导的独立技能。
如何安装
源材料没有说明如何单独安装此维护技能。该仓库整体支持通过 skills.sh、Claude Code、Cursor、Codex/OpenAI-compatible 工具、pi 或手动方式安装；README 明确说明维护技能保留为仓库工作流工具。
如何使用
在已启用 Sosumi MCP 且具有仓库写入权限的环境中使用。可提出“update latest APIs”“refresh deprecated SwiftUI APIs”“check for new SwiftUI deprecations”或“scan for API changes”等请求，也可在新的 iOS/Xcode 发布后触发。技能完成扫描、比较、文件更新并准备拉取请求。