开发与工程 swiftuiiosapi-migrationapple-documentationsosumi-mcpgithub-cli

SwiftUI API 更新维护技能

扫描 Apple 文档,持续更新 SwiftUI 弃用 API 的现代替代方案。

FollowSkills 评估 · FSRS-2.0
谨慎使用
52/ 100 五分制 2.6 / 5
1 2 3 4 5 6
1信任安全14 / 25 · 2.8/5

技能权限相对收敛:仅读写本仓库文件、通过 gh 创建 PR、通过 Sosumi MCP 拉取 Apple 文档;无凭据处理、无隐蔽外传。扣分点:PR 创建步骤未要求用户显式确认,fetchExternalDocumentation 接受任意 https URL 但无域名限制说明,缺少对异常结果或回滚路径的约定。

2可靠稳定9 / 20 · 2.3/5

工作流步骤自洽,manifest 分类清晰,含工具参数表和'无替代时如实记录'的失败指引;但未执行验证,且强依赖外部 Sosumi MCP 的可用性,仅以 prerequisite 一句带过,MCP 不可用时的失败反馈和降级行为未定义。

3适用触发9 / 15 · 3.0/5

description 中触发语句明确('update latest APIs'、新 iOS/Xcode 发布后等),前置条件和目标文件边界清楚;扣分点:核心功能完全依赖 Sosumi MCP 访问 Apple 海外文档,对中国大陆网络可达性存在风险且未声明,未说明不适用范围。

4规范维护11 / 15 · 3.7/5

文档分层良好(SKILL.md + scan-manifest.md),仓库有 MIT LICENSE、语义化版本发布 CI、CONTRIBUTING 指引、README 维护章节并明确该 skill 为仓库内部维护工具不对外发布;扣分点:该 skill 自身无版本号或变更记录,manifest 依赖人工更新,引用文件(latest-apis.md)格式依赖未在本次范围内全文验证。

5有效结果6 / 15 · 2.0/5

任务目标(扫描弃用 API 并按固定格式更新 latest-apis.md、开 PR)描述完整,输出格式有明确模板,边际价值在于系统化替代人工翻文档;但静态审查无法确认产出正确性,文档路径和锚点(如 toolbar(content:)-5w0tj)可能随 Apple 站点变动失效。

6证据核验3 / 10 · 1.5/5

仅有源文件可审计:manifest 中列出的 Apple 文档路径和 WWDC 会话可作为主要材料核对;但本 skill 无任何测试或 CI 覆盖(现有测试仅针对 trace 脚本),无第三方执行证据,静态评分上限 5,实际证据类型单一。

证据充分度: 评估于 2026年9月8日 审查版本 4c6a97d15aa5
使用前请注意
  • 该 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 创建拉取请求。

  1. 维护 SwiftUI 专家技能的团队在发布新 iOS 或 Xcode 版本后扫描 API 变化。
  2. 需要查找尚未记录的 SwiftUI 弃用 API 及官方现代替代方案的开发者。
  3. 希望通过统一版本段落和快速查找表审查 API 迁移内容的维护者。
  4. 拥有 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 发布后触发。技能完成扫描、比较、文件更新并准备拉取请求。

常见问题

这个技能是否免费?
源材料只说明仓库采用 MIT 许可证,没有说明 Sosumi MCP、GitHub CLI 或相关运行环境的额外成本。
没有 Sosumi MCP 可以使用吗?
不能完成其核心扫描流程,因为 SKILL.md 明确要求 Sosumi MCP 可用。
它会直接修改主分支吗?
规定的流程是在 main 上创建 update/latest-apis-YYYY-MM 分支,提交变更并创建拉取请求。
它会更新整个 SwiftUI 技能集合吗?
不会。该技能的目标文件是 swiftui-expert-skill/references/latest-apis.md;本资料要求仅将其视为独立维护技能。

同仓库的其他 Skills

均来自 AvdLee/SwiftUI-Agent-Skill

相关 Skills