axiom-apple-docs-research

Apple のドキュメント調査

このスキルを使うタイミング

✅ 次の場合にこのスキルを使用します：

• Apple のフレームワークや API（WidgetKit、SwiftUI など）を調査する場合
• コードサンプル付きの WWDC セッションの完全なトランスクリプトが必要な場合
• Apple Developer のドキュメントを探す場合
• WWDC のプレゼンテーションからコード例を抽出する場合
• Apple のテクノロジーを基に包括的なスキルを作成する場合

❌ 次の場合はこのスキルを使用しないでください：

• サードパーティ製フレームワークのドキュメント
• 一般的なウェブ調査
• 既存のスキルですでに回答されている質問
• Swift 言語の基本的な質問（Swift のドキュメントを使用してください）

関連スキル

• インタラクティブなブラウザー操作には superpowers-chrome:browsing を使用します
• Apple のドキュメントを基に新しいスキルを作成する場合は writing-skills を使用します
• Apple のドキュメントに関するスキルを検証するには reviewing-reference-skills を使用します

基本理念

Apple Developer のビデオページには、タイムスタンプ付きの完全な逐語トランスクリプトと、コードサンプルが掲載されています。Chrome の自動キャプチャ機能を使えば、手作業でコピーしなくてもすぐにこのコンテンツを利用できます。

重要なポイント：WWDC のビデオからトランスクリプトを書き起こしたり、コードを手動でコピーしたりする必要はありません。トランスクリプトはすでにページ上にあり、タイムスタンプと書式が整っています。

Chrome を使った WWDC セッションのトランスクリプト取得

手順

Apple Developer のビデオページ（developer.apple.com/videos/play/wwdc20XX/XXXXX/）には、Chrome が自動キャプチャする完全なトランスクリプトが含まれています。

手順

1. Chrome ブラウザーの MCP ツールを使って移動します：

   {
     "action": "navigate",
     "payload": "https://developer.apple.com/videos/play/wwdc2025/278/"
   }
   

   ツール名：mcp__plugin_superpowers-chrome_chrome__use_browser

   呼び出しの全体：

   Use the mcp__plugin_superpowers-chrome_chrome__use_browser tool with:
   - action: "navigate"
   - payload: "https://developer.apple.com/videos/play/wwdc2025/278/"
   

2. 自動キャプチャされたファイルを見つけます：

   • Chrome の保存先：~/.../superpowers/browser/YYYY-MM-DD/session-TIMESTAMP/
   • セッションディレクトリ名にはミリ秒単位の Unix タイムスタンプが使われます（例：session-1765217804099）
   • ファイル名のパターン：NNN-navigate.md（例：001-navigate.md）

   最新のセッションを見つける方法：

   # List sessions sorted by modification time (newest first)
   ls -lt ~/Library/Caches/superpowers/browser/*/session-* | head -5
   

3. キャプチャされたトランスクリプトを読みます：

   • タイムスタンプ付きの完全な発話内容（例：[0:07]、[1:23]）
   • コードや API の使い方の説明（発話内容であり、コード形式ではありません）
   • チャプターマーカーとリソースへのリンク

取得できる内容

✅ WWDC のトランスクリプトに含まれるもの：

• タイムスタンプ付きの完全な発話内容（例：[0:07]、[1:23]）
• 登壇者が言及する API 名（例：widgetRenderingMode、supportedMountingStyles）
• コードの動作に関する説明（「widgetRenderingMode 環境変数を追加します」など）
• 実装の段階的な説明
• チャプターマーカーとリソースへのリンク

❌ WWDC のトランスクリプトに含まれないもの：

• コピーしてすぐに使える、書式付きの Swift コードブロック
• 完全な実装
• 構造化されたコード例

重要な注意点：トランスクリプトはコードではなく発話内容です。「widgetRenderingMode 環境変数をウィジェットビューに追加します」のような文を読み、説明を基に自分でコードを再構成する必要があります。

トランスクリプトだけではコードが明確でない場合

トランスクリプトのコード説明が不十分な場合は、次の代替ワークフローに従います。

1. Resources タブを確認する

   • WWDC セッションのページに戻ります
   • 「Resources」タブをクリックします
   • 「Download Sample Code」または「View on GitHub」を探します
   • 完全に動作する実装を含む Xcode プロジェクトをダウンロードします

2. API の詳細を sosumi.ai で確認する

   • トランスクリプトで言及された特定の API を調べます
   • 例：トランスクリプトに「widgetAccentedRenderingMode」とある場合は、sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode を調べます
   • 正確なシグネチャ、パラメーター、使い方を確認します

3. ビデオをタイムスタンプから再生する

   • トランスクリプトのタイムスタンプを使って、ビデオ内のコード説明に直接移動します
   • 例：トランスクリプトにコードの説明が [4:23] とある場合は、その30秒の区間を視聴します
   • 45分のセッション全体を視聴するよりも効率的です

4. 情報源を組み合わせる

   • トランスクリプト＝概念の理解とワークフロー
   • リソース＝完全なコード
   • sosumi.ai＝API の詳細
   • 結果：すべてを手作業で再構成しなくても全体像を把握できます

トランスクリプトの構成例：

# Session Title - WWDC## - Videos - Apple Developer

## Chapters
- 0:00 - Introduction
- 1:23 - Key Topic 1

## Transcript
0:00
Speaker: Welcome to this session...

[timestamp]
Now I'll add the widgetAccentedRenderingMode modifier...

セッション例

WWDC 2025-278「ウィジェットの最新情報」：

• 移動先：https://developer.apple.com/videos/play/wwdc2025/278/
• 保存先：001-navigate.md
• 内容：約15分の完全なトランスクリプト。API リファレンスとコードの概念を含みます

sosumi.ai を使った Apple のドキュメント

sosumi.ai を使う理由

Developer.apple.com のドキュメントは HTML が多く、解析が困難です。sosumi.ai では、同じ内容を読みやすい Markdown 形式で利用できます。

URL パターン

代わりに：

https://developer.apple.com/documentation/widgetkit

こちらを使用：

https://sosumi.ai/documentation/widgetkit

URL パターンのルール

形式：https://sosumi.ai/documentation/[framework]

フレームワーク名のルール：

1. 小文字 - フレームワーク名が大文字で始まる場合も、小文字を使用します（SwiftUI → swiftui）
2. スペースなし - スペースをすべて削除します（Core Data → coredata）
3. ハイフンなし - ハイフンをすべて削除します（App Intents → appintents。「app-intents」ではありません）
4. 大文字と小文字を区別しない - SwiftUI と swiftui のどちらも使用できますが、小文字を推奨します

よくある間違い：

• ❌ app-intents → ✅ appintents
• ❌ axiom-core-data → ✅ coredata
• ❌ AVFoundation → ✅ avfoundation

例：

フレームワーク名	sosumi.ai の URL
SwiftUI	sosumi.ai/documentation/swiftui
App Intents	sosumi.ai/documentation/appintents
Core Data	sosumi.ai/documentation/coredata
AVFoundation	sosumi.ai/documentation/avfoundation
UIKit	sosumi.ai/documentation/uikit

WebFetch または Read ツールでの使用

WebFetch:
  url: https://sosumi.ai/documentation/widgetkit/widget
  prompt: "Extract information about Widget protocol"

Result: Clean markdown with API signatures, descriptions, examples

フレームワークの例

フレームワーク	sosumi.ai の URL
WidgetKit	https://sosumi.ai/documentation/widgetkit
SwiftUI	https://sosumi.ai/documentation/swiftui
ActivityKit	https://sosumi.ai/documentation/activitykit
App Intents	https://sosumi.ai/documentation/appintents
Foundation	https://sosumi.ai/documentation/foundation

よくある調査ワークフロー

ワークフロー 1：新しい iOS 機能の調査

目標：新しい iOS 26 の機能について、包括的なスキルを作成します。

1. WWDC セッションを探す — 「WWDC 2025 [feature name]」を検索します
2. トランスクリプトを取得する — Chrome で各セッションに移動します
3. トランスクリプトを読む — 重要な概念、コードパターン、注意点を抽出します
4. API ドキュメントを取得する — sosumi.ai を使ってフレームワークを参照します
5. 相互参照する — コードサンプルがドキュメントと一致することを確認します
6. スキルを作成する — トランスクリプトの知見と API リファレンスをまとめます

節約できる時間：動画の視聴と手作業での文字起こしに比べて3～4時間

ワークフロー 2：API の詳細調査

目標：特定の API またはプロトコルを理解します。

1. sosumi.ai のドキュメント — プロトコル／クラスの定義を取得します
2. WWDC セッション — その API に言及しているセッションを検索します
3. コードサンプル — トランスクリプトのコードブロックから抽出します
4. パターンを検証する — 例が最新の API と一致することを確認します

ワークフロー 3：複数セッションの調査

目標：複数年にわたる内容（例：ウィジェットの進化）を包括的に把握します。

1. 並行して移動する — Chrome を使って3～6件のセッションを開きます
2. すべてのトランスクリプトを読む — API の進化を比較します
3. 変遷を抽出する — iOS 14 → 17 → 18 → 26 の変更点をまとめます
4. 統合する — バージョン注記を付けた統一スキルを作成します

例：Extensions & Widgets スキルでは、WWDC の6件のセッション（2023～2025年）を使用しました

アンチパターン

❌ しない：動画を手作業で視聴する

BAD:
1. Play WWDC video
2. Pause and take notes
3. Rewind to capture code
4. Type out examples manually

Result: 45 minutes per session

✅ 推奨：Chrome の自動キャプチャ

GOOD:
1. Navigate with Chrome
2. Read captured .md file
3. Copy code blocks directly
4. Reference timestamps for context

Result: 5 minutes per session

❌ しない：developer.apple.com の HTML をスクレイピングする

BAD:
Use WebFetch on developer.apple.com/documentation
Result: Complex HTML parsing required

✅ 推奨：sosumi.ai を使用する

GOOD:
Use WebFetch on sosumi.ai/documentation
Result: Clean markdown, instant access

トラブルシューティング

Chrome のセッションディレクトリが見つからない

症状：001-navigate.md ファイルが見つからない

解決策：

1. Chrome が実際にページに移動したことを確認します（URL の確認メッセージを探してください）
2. 最新のセッションを見つけます：ls -lt ~/Library/Caches/superpowers/browser/*/
3. セッションディレクトリの形式：YYYY-MM-DD/session-TIMESTAMP/

トランスクリプトが不完全

症状：ファイルは存在するものの、トランスクリプトが含まれていない

解決策：

1. ページの読み込み中である可能性があります。2～3秒待ってください
2. もう一度移動を試してください
3. セッションによっては、すべてのコンテンツを読み込むためにスクロールが必要です

sosumi.ai がエラーを返す

症状：404 または URL が無効

解決方法：

1. フレームワーク名のスペルを確認します
2. sosumi.ai の形式を確認します：/documentation/[frameworkname]
3. フォールバック：developer.apple.com を使用しますが、HTML が返されることを想定してください

検証チェックリスト

取得したコンテンツを使用する前に：

• ☐ 文字起こしにタイムスタンプが含まれている
• ☐ コードサンプルが完全である（途中で切れていない）
• ☐ 話者名とチャプターマーカーが含まれている
• ☐ 複数の話者が適切に明記されている
• ☐ コードの構文ハイライトが保持されている

リソース

スキル：superpowers-chrome:browsing、writing-skills、reviewing-reference-skills

---

節約できる時間：この手法を使うと、WWDC のセッションごとに、手動で動画を視聴して文字起こしする場合と比べて 30〜40 分節約できます。複数のセッションにまたがる包括的な調査では、節約時間は積み重なり、スキルごとに 3〜4 時間になります。