mcpField
U
update-swiftui-apis

update-swiftui-apis

github.com/avdlee開発3.8k2.4k 回インストール3 週間前に更新
リポジトリ

update-swiftui-apis について

SwiftUI API の非推奨リファレンスを保守するワークフロー用スキルです。Sosumi MCP で Apple の資料を調査し、一覧を更新してプルリクエストを準備します。

主な機能

  1. 01既存 API の収録状況を確認
  2. 02Apple のドキュメントを調査
  3. 03非推奨 API と代替を特定
  4. 04API 検索リファレンスを更新
  5. 05プルリクエストを準備

活用シーン

  1. 01非推奨 API の一覧を更新
  2. 02代替 API の利用可能バージョンを確認
  3. 03資料に基づく API 更新を提出

MCP 対応

Sosumi MCP のツールで Apple のドキュメントや動画トランスクリプトを検索・取得し、API の変更点を特定します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/avdlee/swiftui-agent-skill --skill update-swiftui-apis

インストール後、Claude Code で/update-swiftui-apisを入力して読み込まれたか確認します。

同梱ファイルreferences/scan-manifest.md

詳細

SwiftUI API を更新する

Sosumi MCP を使って Apple の開発者向けドキュメントを体系的に確認し、非推奨の SwiftUI API とその最新の代替手段を特定して、skills/swiftui-expert-skill/references/latest-apis.md を更新します。

前提条件

  • Sosumi MCP が有効で、利用可能であること（searchAppleDocumentation、fetchAppleDocumentation、fetchAppleVideoTranscript、fetchExternalDocumentation を提供）
  • このリポジトリ（またはフォーク）への書き込み権限

ワークフロー

1. 現在の対象範囲を把握する

skills/swiftui-expert-skill/references/latest-apis.md を読み、以下を確認します。

  • すでに記載されている非推奨 API から最新 API への移行
  • 使用されているバージョン区分（iOS 15+、16+、17+、18+、26+）
  • 最下部のクイック参照表
2. スキャンマニフェストを読み込む

（このスキルを基準とする相対パスの）references/scan-manifest.md を読みます。スキャンする API 領域、ドキュメントのパス、検索クエリ、WWDC ビデオのパスがカテゴリ別に記載されています。

3. Apple のドキュメントをスキャンする

マニフェストの各カテゴリについて、次の手順を実行します。

  1. 記載されたクエリを使って searchAppleDocumentation を呼び出し、関連するページを見つけます。
  2. 特定したドキュメントのパスを使って fetchAppleDocumentation を呼び出し、API の詳細を取得します。
  3. 非推奨の通知、「Deprecated」ラベル、「Use ... instead」という案内を確認します。
  4. 最新の代替手段が利用可能になった iOS のバージョンを記録します。
  5. 必要に応じて、API の変更を発表した WWDC セッションについて fetchAppleVideoTranscript を呼び出します。

効率化のため、関連する検索をまとめて実行します。latest-apis.md にまだ記載されていない新しい非推奨 API の発見に重点を置きます。

4. 比較して変更点を特定する

調査結果を既存の項目と比較し、結果を次のように分類します。

  • 新しい非推奨 API：latest-apis.md にまだ記載されていない API
  • 修正：更新が必要な既存項目（バージョンの誤り、より適切な代替手段の存在など）
  • 新しいバージョン区分：新しい iOS バージョンで非推奨 API が導入された場合は、新しいセクションを追加します
5. latest-apis.md を更新する

既存の形式に正確に従います。各項目には次の内容を含めます。

セクションの配置 -- 適切なバージョン区分に配置します。

  • 長期間にわたって非推奨となっている API は「Always Use (iOS 15+)」
  • バージョンによって適用対象が決まる変更は「When Targeting iOS 16+」／「17+」／「18+」／「26+」

項目の形式：

**Always use `modernAPI()` instead of `deprecatedAPI()`.**

\```swift
// Modern
View()
    .modernAPI()

// Deprecated
View()
    .deprecatedAPI()
\```

クイック参照表 -- ファイルの最下部に行を追加します。

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

ファイル先頭の帰属表示行はそのまま残します。

Sosumi MCP を使って Apple のドキュメントを比較した結果、最新の推奨 API が見つかりました。

6. プルリクエストを作成する
  1. main から、update/latest-apis-YYYY-MM という名前でブランチを作成します（現在の年と月を使用）。
  2. skills/swiftui-expert-skill/references/latest-apis.md の変更をコミットします。
  3. 次の内容で gh pr create を使って PR を作成します。
    • タイトル：「最新の SwiftUI API を更新（年月）」
    • 本文：追加・変更した項目の概要と、Sosumi MCP への帰属表示

Sosumi MCP ツールのリファレンス

ツールパラメーター戻り値
searchAppleDocumentationquery（文字列）title、url、description、breadcrumbs、tags、type を含む results[] を含む JSON
fetchAppleDocumentationpath（文字列。例：/documentation/swiftui/view/foregroundstyle(_:)）Markdown 形式のドキュメント内容
fetchAppleVideoTranscriptpath（文字列。例：/videos/play/wwdc2025/10133）Markdown 形式のトランスクリプト
fetchExternalDocumentationurl（https から始まる完全な URL）Markdown 形式のドキュメント内容

ヒント

  • まずは searchAppleDocumentation のクエリで広く検索し、その後 fetchAppleDocumentation を使って特定のパスを詳しく確認します。
  • Appleの非推奨に関するドキュメントには、通常、ページ内に「Deprecated」と記載され、代替手段へのリンクがあります。
  • 新たに導入された代替手段を調べるには、WWDCの「What's new in SwiftUI」セッションが最適な情報源です。
  • 非推奨となった正確なiOSバージョンがわからない場合は、取得したドキュメントの「Availability」セクションを確認してください。
  • APIが非推奨で、直接の代替手段がない場合は、不適切な代替案を提案せず、その旨を記載してください。

コメント

Markdown 対応