开发与工程

SwiftUI API 更新维护技能

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

52/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 3.7k
最近更新
19 天前
License
MIT
swiftuiiosapi-migrationapple-documentation
+2sosumi-mcpgithub-cli

这个 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?

使用前请注意
  • 该 skill 强依赖 Sosumi MCP 访问 Apple 海外文档,中国大陆网络环境下可能不可用,使用前请确认 MCP 可达。
  • PR 创建步骤未要求人工确认,建议在执行前审查将要提交的变更内容。
  • manifest 中的文档路径锚点可能随 Apple 站点结构调整而失效,产出需人工复核。
  • 该 skill 为仓库维护工具,未包含在任何测试或 CI 验证范围内,属静态审查、未经验证。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
  • MCP Server
需要预先安装
  • Sosumi MCP
  • GitHub CLI

源材料没有说明如何单独安装此维护技能。该仓库整体支持通过 skills.sh、Claude Code、Cursor、Codex/OpenAI-compatible 工具、pi 或手动方式安装;README 明确说明维护技能保留为仓库工作流工具。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/AvdLee/SwiftUI-Agent-Skill.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.agents/skills/update-swiftui-apis" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • update latest APIs
  • refresh deprecated SwiftUI APIs
  • check for new SwiftUI deprecations
  • scan for API changes

在已启用 Sosumi MCP 且具有仓库写入权限的环境中使用。可提出“update latest APIs”“refresh deprecated SwiftUI APIs”“check for new SwiftUI deprecations”或“scan for API changes”等请求,也可在新的 iOS/Xcode 发布后触发。技能完成扫描、比较、文件更新并准备拉取请求。

这个 Skill 有哪些优点和局限?

优点
  • 流程明确,覆盖扫描、比较、格式化、提交和创建 PR。
  • 以 Apple 开发者文档为主要依据,并要求记录现代替代方案的 iOS 版本。
  • 包含 scan manifest,便于按 API 类别系统化检查。
局限
  • 必须启用 Sosumi MCP,否则无法执行核心文档扫描。
  • 需要仓库写入权限以及 GitHub CLI 才能完成分支、提交和 PR 流程。
  • 源材料没有提供测试套件或对其他 MCP 实现的兼容性证据。
  • 它只维护 latest-apis.md,不是用于一般 SwiftUI 编程指导的独立技能。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
SwiftUI API 更新维护技能 本页 52 · 谨慎使用 ★ 3.7k 19 天前 MIT
Expo 原生 UI 构建助手 59 · 推荐 ★ 2.9k 20 天前 MIT
SwiftUI WCAG 无障碍审计技能 58 · 推荐 ★ 13 7 个月前 —
SwiftUI 专家技能 待评估 ★ 3.7k 19 天前 MIT
DeepChat SDD 文档清理技能 50 · 谨慎使用 ★ 6.4k 12 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
52/ 100 五分制 2.6 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
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,实际证据类型单一。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月8日 审查版本 4c6a97d15aa5 评估证据[1][2][3][4][5][6][7][8]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能是否免费?
源材料只说明仓库采用 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