SwiftUI API 更新维护技能
扫描 Apple 文档,持续更新 SwiftUI 弃用 API 的现代替代方案。
技能权限相对收敛:仅读写本仓库文件、通过 gh 创建 PR、通过 Sosumi MCP 拉取 Apple 文档;无凭据处理、无隐蔽外传。扣分点:PR 创建步骤未要求用户显式确认,fetchExternalDocumentation 接受任意 https URL 但无域名限制说明,缺少对异常结果或回滚路径的约定。
工作流步骤自洽,manifest 分类清晰,含工具参数表和'无替代时如实记录'的失败指引;但未执行验证,且强依赖外部 Sosumi MCP 的可用性,仅以 prerequisite 一句带过,MCP 不可用时的失败反馈和降级行为未定义。
description 中触发语句明确('update latest APIs'、新 iOS/Xcode 发布后等),前置条件和目标文件边界清楚;扣分点:核心功能完全依赖 Sosumi MCP 访问 Apple 海外文档,对中国大陆网络可达性存在风险且未声明,未说明不适用范围。
文档分层良好(SKILL.md + scan-manifest.md),仓库有 MIT LICENSE、语义化版本发布 CI、CONTRIBUTING 指引、README 维护章节并明确该 skill 为仓库内部维护工具不对外发布;扣分点:该 skill 自身无版本号或变更记录,manifest 依赖人工更新,引用文件(latest-apis.md)格式依赖未在本次范围内全文验证。
任务目标(扫描弃用 API 并按固定格式更新 latest-apis.md、开 PR)描述完整,输出格式有明确模板,边际价值在于系统化替代人工翻文档;但静态审查无法确认产出正确性,文档路径和锚点(如 toolbar(content:)-5w0tj)可能随 Apple 站点变动失效。
仅有源文件可审计:manifest 中列出的 Apple 文档路径和 WWDC 会话可作为主要材料核对;但本 skill 无任何测试或 CI 覆盖(现有测试仅针对 trace 脚本),无第三方执行证据,静态评分上限 5,实际证据类型单一。
- 该 skill 强依赖 Sosumi MCP 访问 Apple 海外文档,中国大陆网络环境下可能不可用,使用前请确认 MCP 可达。
- PR 创建步骤未要求人工确认,建议在执行前审查将要提交的变更内容。
- manifest 中的文档路径锚点可能随 Apple 站点结构调整而失效,产出需人工复核。
- 该 skill 为仓库维护工具,未包含在任何测试或 CI 验证范围内,属静态审查、未经验证。
这个 Skill 能做什么,适合哪些场景?
这是 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 和仓库写入权限、希望以拉取请求提交维护更新的贡献者。
这个 Skill 有哪些优点和局限?
- 流程明确,覆盖扫描、比较、格式化、提交和创建 PR。
- 以 Apple 开发者文档为主要依据,并要求记录现代替代方案的 iOS 版本。
- 包含 scan manifest,便于按 API 类别系统化检查。
- 必须启用 Sosumi MCP,否则无法执行核心文档扫描。
- 需要仓库写入权限以及 GitHub CLI 才能完成分支、提交和 PR 流程。
- 源材料没有提供测试套件或对其他 MCP 实现的兼容性证据。
- 它只维护 latest-apis.md,不是用于一般 SwiftUI 编程指导的独立技能。
如何安装这个 Skill?
源材料没有说明如何单独安装此维护技能。该仓库整体支持通过 skills.sh、Claude Code、Cursor、Codex/OpenAI-compatible 工具、pi 或手动方式安装;README 明确说明维护技能保留为仓库工作流工具。
如何使用这个 Skill?
在已启用 Sosumi MCP 且具有仓库写入权限的环境中使用。可提出“update latest APIs”“refresh deprecated SwiftUI APIs”“check for new SwiftUI deprecations”或“scan for API changes”等请求,也可在新的 iOS/Xcode 发布后触发。技能完成扫描、比较、文件更新并准备拉取请求。