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 ドキュメントをスキャンする
マニフェスト内の各カテゴリについて以下を実行します。
- リストされたクエリで
searchAppleDocumentationを呼び出し、関連ページを検出します。 - 特定のドキュメントパスで
fetchAppleDocumentationを呼び出し、完全な API 詳細を取得します。 - 非推奨通知、「Deprecated」ラベル、「代わりに...を使用」のガイダンスを探します。
- 最新の代替 API が利用可能になった iOS バージョンを確認します。
- オプションで、API 変更を発表する WWDC セッションの
fetchAppleVideoTranscriptを呼び出します。
効率化のために、関連する検索をまとめてバッチ処理します。latest-apis.md にまだない新しい非推奨を見つけることに重点を置きます。
4. 比較し、変更を特定する
調査結果を既存のエントリと比較します。結果を次のように分類します。
- 新しい非推奨:
latest-apis.mdにまだ文書化されていない API - 修正: 更新が必要な既存のエントリ(間違ったバージョン、より良い代替 API があるなど)
- 新しいバージョンセグメント: 新しい iOS バージョンで非推奨が導入された場合、新しいセクションを追加
5. latest-apis.md を更新する
確立されたフォーマットに正確に従います。各エントリには以下を含める必要があります。
セクション配置 -- 正しいバージョンセグメントの下に配置します。
- 長期間非推奨の API は「常に使用(iOS 15+)」
- バージョンゲートされた変更は「iOS 16+ をターゲットにする場合」/「17+」/「18+」/「26+」
エントリ形式:
**`deprecatedAPI()` の代わりに常に `modernAPI()` を使用してください。**
\```swift
// 最新
View()
.modernAPI()
// 非推奨
View()
.deprecatedAPI()
\```
クイックルックアップテーブル -- ファイルの下部に行を追加します。
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
ファイルの先頭にある帰属行は保持します。
Apple のドキュメントを Sosumi MCP を使用して比較した結果、使用すべき最新の推奨 API を発見しました。
6. プルリクエストを作成する
mainからupdate/latest-apis-YYYY-MMという名前のブランチを作成します(現在の年と月を使用)。swiftui-expert-skill/references/latest-apis.mdに変更をコミットします。gh pr createで PR を作成します。- タイトル: