SwiftUI API の更新

Sosumi MCP 経由で Apple の開発者ドキュメントを体系的にスキャンし、非推奨の SwiftUI API と最新の代替 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. 非推奨通知、「Deprecated」ラベル、「Use ... instead」のガイダンスを探します。
4. 最新の代替 API が利用可能になった iOS バージョンをメモします。
5. 必要に応じて、API の変更を発表する WWDC セッションの fetchAppleVideoTranscript を呼び出します。

効率化のため、関連する検索をまとめてバッチ処理します。latest-apis.md にまだ文書化されていない新しい非推奨 API を見つけることに注力します。

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

見つかった内容を既存のエントリと比較します。結果を分類します:

• 新しい非推奨 API: latest-apis.md にまだ文書化されていない API
• 修正: 更新が必要な既存エントリ(バージョン間違い、より良い代替 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+ |

ファイルの上部にある帰属行を保持します:

Based on a comparison of Apple's documentation using the Sosumi MCP, we found the latest recommended APIs to use.

6. プルリクエストを開く

1. main から update/latest-apis-YYYY-MM(現在の年月を使用)という名前のブランチを作成します。
2. swiftui-expert-skill/references/latest-apis.md への変更をコミットします。
3. gh pr create で PR を開きます:
   • タイトル: "Update latest SwiftUI APIs (Month Year)"
   • 本文: 新規/変更されたエントリの概要、Sosumi MCP への帰属

Sosumi MCP ツールリファレンス

ツール	パラメータ	返す内容
searchAppleDocumentation	query (文字列)	title、url、description、breadcrumbs、tags、type を含む results[] の JSON
fetchAppleDocumentation	path (文字列、例: /documentation/swiftui/view/foregroundstyle(_:))	Markdown ドキュメントコンテンツ
fetchAppleVideoTranscript	path (文字列、例: /videos/play/wwdc2025/10133)	Markdown トランスクリプト
fetchExternalDocumentation	url (文字列、完全な https URL)	Markdown ドキュメントコンテンツ

ヒント

• searchAppleDocumentation クエリで広く始めてから、fetchAppleDocumentation で特定のパスまで掘り下げます。
• Apple の非推奨ドキュメントは通常、ページに「Deprecated」と表示され、代替品へのリンクがあります。
• WWDC の「What's new in SwiftUI」セッションが、新たに導入された代替品の最良情報源です。
• 非推奨 API の正確な iOS バージョンが不確かな場合、取得したドキュメントの「Availability」セクションで確認します。
• API が非推奨だが直接的な代替品が存在しない場合、不正確な代替案を提案するのではなく、この事実をメモします。