Communitygithub.com

ComeOnOliver/skillshub

扫描 Apple 的 SwiftUI 文档以查找已弃用的 API,并使用现代替代方案更新 SwiftUI 专家技能。请在询问“更新最新 API”、“刷新已弃用的 SwiftUI API”、“检查新的 SwiftUI 弃用”、“扫描 API 变更”时使用,或在新 iOS/Xcode 版本发布后使用。需要 Sosumi MCP 可用。

skillshub 是什么?

此技能旨在通过系统扫描 Apple 的开发者文档,识别已弃用的 SwiftUI API 及其现代替代方案,并自动更新 `swiftui-expert-skill/references/latest-apis.md` 文件。它特别适用于开发者希望在新 iOS/Xcode 版本发布后,快速检查和更新 SwiftUI 代码库中已弃用 API 的场景。该技能依赖于 Sosumi MCP 提供的搜索和文档获取工具,并支持 Claude Code、Cursor 或 Codex 等 AI Agent 平台。工作流程包括读取当前覆盖范围、加载扫描清单、使用 Sosumi MCP 扫描 Apple 文档、比较并识别新的弃用项,最后按照既定格式更新 `latest-apis.md` 并创建一个包含变更摘要的拉取请求。该技能自动处理版本分段(如 iOS 15+、16+ 等)和快速查询表的维护,确保 API 参考始终与 Apple 的最新推荐保持一致。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/AvdLee/SwiftUI-Agent-Skill/update-swiftui-apis

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

更新 SwiftUI API

通过 Sosumi MCP 系统扫描 Apple 的开发者文档,识别已弃用的 SwiftUI API 及其现代替代方案,并更新 swiftui-expert-skill/references/latest-apis.md。

前提条件

  • Sosumi MCP 必须启用并可用(提供 searchAppleDocumentation、fetchAppleDocumentation、fetchAppleVideoTranscript、fetchExternalDocumentation)
  • 对此仓库(或其分支)的写权限

工作流程

1. 了解当前覆盖范围

阅读 swiftui-expert-skill/references/latest-apis.md 以了解:

  • 哪些已弃用到现代的转换已被记录
  • 正在使用的版本分段(iOS 15+、16+、17+、18+、26+)
  • 底部的快速查询表

2. 加载扫描清单

读取 references/scan-manifest.md(相对于此技能)。它包含分类的 API 区域列表、文档路径、搜索查询以及要扫描的 WWDC 视频路径。

3. 扫描 Apple 文档

对于清单中的每个类别:

  1. 调用 searchAppleDocumentation 并传入列出的查询,以发现相关页面。
  2. 调用 fetchAppleDocumentation 并传入具体的文档路径,以获取完整的 API 详细信息。
  3. 查找弃用通知、“已弃用”标签以及“改用 ... ”的指导。
  4. 记录现代替代方案可用的 iOS 版本。
  5. 可选地调用 fetchAppleVideoTranscript 获取公布 API 变更的 WWDC 会议记录。

为提高效率,批量执行相关搜索。重点查找新的弃用项,即尚未包含在 latest-apis.md 中的项。

4. 比较并识别变更

将发现与现有条目进行比较。将结果分类:

  • 新的弃用项:尚未在 latest-apis.md 中记录的 API
  • 更正项:需要更新的现有条目(版本错误、更好的替代方案可用)
  • 新的版本分段:如果新 iOS 版本引入了弃用,则添加新的章节

5. 更新 latest-apis.md

严格遵循既定格式。每个条目必须包含:

章节位置 -- 放置在正确的版本分段下:

  • “始终使用(iOS 15+)”用于长期弃用的 API
  • “当目标为 iOS 16+” / “17+” / “18+” / “26+” 用于版本限制的变更

条目格式:

**始终使用 `modernAPI()` 代替 `deprecatedAPI()`。**

\```swift
// 现代方式
View()
    .modernAPI()

// 弃用方式
View()
    .deprecatedAPI()
\```

快速查询表 -- 在文件底部添加一行:

| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |

保持文件顶部的署名行:

基于使用 Sosumi MCP 对 Apple 文档的比较,我们找到了最新推荐的 API。

6. 创建拉取请求

  1. 从 main 创建分支,命名为 update/latest-apis-YYYY-MM(使用当前年月)。
  2. 提交对 swiftui-expert-skill/references/latest-apis.md 的更改。
  3. 通过 gh pr create 创建 PR,包含:
    • 标题:“更新最新 SwiftUI API(月份 年份)”
    • 正文:新增/更改条目的摘要,并对 Sosumi MCP 进行署名

Sosumi MCP 工具参考

工具参数返回
searchAppleDocumentationquery(字符串)包含 results[] 的 JSON,字段为 title、url、description、breadcrumbs、tags、type
fetchAppleDocumentationpath(字符串,例如 /documentation/swiftui/view/foregroundstyle(_:))Markdown 格式的文档内容
fetchAppleVideoTranscriptpath(字符串,例如 /videos/play/wwdc2025/10133)Markdown 格式的转录内容
fetchExternalDocumentationurl(字符串,完整的 https URL)Markdown 格式的文档内容

提示

  • 从使用 searchAppleDocumentation 查询开始广泛搜索,然后使用 fetchAppleDocumentation 深入特定的路径。
  • Apple 的弃用文档通常会在页面中显示“已弃用”,并链接到替代方案。
  • WWDC“SwiftUI 新特性”会议是获取新引入替代方案的最佳来源。
  • 如果对某个弃用项的确切 iOS 版本不确定,请通过检查获取的文档中的“可用性”部分来验证。
  • 如果 API 已弃用但没有直接的替代方案,则应注明,而不是建议不正确的替代方案。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能