Communitygithub.com

ComeOnOliver/skillshub

掃描 Apple 的 SwiftUI 文件以找出已棄用的 API,並使用現代替代方案更新 SwiftUI Expert Skill。在要求「更新最新 API」、「重新整理已棄用的 SwiftUI API」、「檢查新的 SwiftUI 棄用項目」、「掃描 API 變更」時,或是在新的 iOS/Xcode 版本發布後使用。需要提供 Sosumi MCP 才能運作。

skillshub 是什麼?

此技能旨在自動化追蹤與更新 Apple SwiftUI 框架中已棄用 API 的流程。它會透過 Sosumi MCP(一個專門用來存取 Apple 開發者文件的工具)掃描官方文件,找出被標記為「已棄用」的 API,並找出其現代的替代方案。接著,它會將這些變更新增或更新到位於 `swiftui-expert-skill/references/latest-apis.md` 的參考檔案中,確保開發人員總是可以取得最新的最佳實務。該技能支援 iOS 15+、16+、17+、18+ 及 26+ 等多個版本區間,並產生結構化的條目,包含 Swift 程式碼範例和一個快速查詢表,以便於參考。工作流程的最終產出是一個 Pull Request,其中包含對該參考檔案的所做變更摘要,並歸功於 Sosumi MCP 所獲取的資料。對於使用 Claude Code、Coder 或任何支援 MCP 的 AI 代理程式的 SwiftUI 開發人員來說,這項技能非常寶貴,可以幫助他們在不斷演進的生態系統中保持程式碼庫的現代化與穩定性。

相容平台~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. 可選地,為宣布 API 變更的 WWDC 場次呼叫 fetchAppleVideoTranscript。

批次處理相關的搜尋以提高效率。專注於尋找尚未收錄在 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. 開啟 Pull Request

  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

相關技能