Apple Documentation Router

Xcode には、LLM 向けのマークダウンドキュメンテーションが バンドルされています。これらは Apple エンジニアが執筆した権威あるガイドと診断です。Claude Code のネイティブな Read ツールで直接読み取ることができます。MCP サーバーや特別なツールは不要です。

使用場面

• Apple から API の正確なシグネチャまたは動作を確認する必要がある
• Axiom スキルが Apple フレームワークを参照しており、公式ドキュメントを確認したい
• Swift コンパイラ診断の説明が必要
• ユーザーが特定の Apple フレームワーク機能について質問している

優先順位: Axiom スキルは意見のあるガイダンス (決定木、アンチパターン、プレッシャーシナリオ) を提供します。Apple ドキュメントは権威あるAPI 詳細を提供します。両者を組み合わせて使用します。

これらのドキュメントの読み方

セッション開始フックが Xcode の場所を解決し、リテラルベースディレクトリをセッションコンテキストに出力します (「Apple for-LLM Documentation: Xcode detected at <path>」を探してください)。Read ツールを使用して <that base>/<filename> で読み取ります。

デフォルト Xcode ロケーション (/Applications/Xcode.app) のベースディレクトリ:

コンテンツ	ベースディレクトリ
AdditionalDocumentation ガイド	/Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/
Swift コンパイラ診断	/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/

Claude が生成すべき実行例:

Read /Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/SwiftUI-Implementing-Liquid-Glass-Design.md

Xcode ベータユーザーの場合: セッション開始フックは AXIOM_XCODE_PATH を尊重し、解決されたパスをセッションコンテキストにレポートします。そのパスを使用してください。上記のデフォルトではなく。

ガイドファイル (AdditionalDocumentation)

20 個のファイル。パターン {guides base}/{filename} でお読みください。

UI & デザイン

トピック	ファイル名
SwiftUI での Liquid Glass	SwiftUI-Implementing-Liquid-Glass-Design.md
UIKit での Liquid Glass	UIKit-Implementing-Liquid-Glass-Design.md
AppKit での Liquid Glass	AppKit-Implementing-Liquid-Glass-Design.md
WidgetKit での Liquid Glass	WidgetKit-Implementing-Liquid-Glass-Design.md
SwiftUI 新ツールバー機能	SwiftUI-New-Toolbar-Features.md
SwiftUI スタイル付きテキスト編集	SwiftUI-Styled-Text-Editing.md
SwiftUI WebKit 統合	SwiftUI-WebKit-Integration.md
SwiftUI AlarmKit 統合	SwiftUI-AlarmKit-Integration.md
Swift Charts 3D ビジュアライゼーション	Swift-Charts-3D-Visualization.md
Foundation AttributedString 更新	Foundation-AttributedString-Updates.md

データ & 永続性

トピック	ファイル名
SwiftData クラス継承	SwiftData-Class-Inheritance.md

並行処理 & パフォーマンス

トピック	ファイル名
Swift 並行処理更新	Swift-Concurrency-Updates.md
InlineArray と Span	Swift-InlineArray-Span.md

Apple Intelligence

トピック	ファイル名
Foundation Models (オンデバイス LLM)	FoundationModels-Using-on-device-LLM-in-your-app.md

システム統合

トピック	ファイル名
App Intents 更新	AppIntents-Updates.md
StoreKit 更新	StoreKit-Updates.md
MapKit GeoToolbox PlaceDescriptors	MapKit-GeoToolbox-PlaceDescriptors.md
visionOS 用ウィジェット	Widgets-for-visionOS.md

アクセシビリティ

トピック	ファイル名
iOS でのアシスティブアクセス実装	Implementing-Assistive-Access-in-iOS.md

コンピュータビジョン

トピック	ファイル名
iOS での Visual Intelligence 実装	Implementing-Visual-Intelligence-in-iOS.md

Swift コンパイラ診断

診断ディレクトリに 46 個のファイル。パターン {diagnostics base}/{filename} でお読みください。

並行処理診断

診断	ファイル名
nonisolated コンテキストからの actor-isolated 呼び出し	actor-isolated-call.md
適合性の分離	conformance-isolation.md
Isolated 適合性	isolated-conformances.md
デフォルトで nonisolated nonsending	nonisolated-nonsending-by-default.md
Sendable クロージャキャプチャ	sendable-closure-captures.md
Sendable メタタイプ	sendable-metatypes.md
明示的な Sendable アノテーション	explicit-sendable-annotations.md
Sending クロージャはデータレース危険	sending-closure-risks-data-race.md
Sending はデータレース危険	sending-risks-data-race.md
可変グローバル変数	mutable-global-variable.md
Preconcurrency インポート	preconcurrency-import.md
動的排他性	dynamic-exclusivity.md
排他性違反	exclusivity-violation.md

型システム診断

診断	ファイル名
Existential any	existential-any.md
Existential メンバアクセス制限	existential-member-access-limitations.md
Nominal 型	nominal-types.md
多重継承	multiple-inheritance.md
プロトコル型非適合	protocol-type-non-conformance.md
Opaque 型推論	opaque-type-inference.md
外部参照型	foreign-reference-type.md

ビルド & マイグレーション診断

診断	ファイル名
非推奨宣言	deprecated-declaration.md
将来の Swift バージョンでのエラー	error-in-future-swift-version.md
厳密言語機能	strict-language-features.md
厳密メモリ安全性	strict-memory-safety.md
実装のみ非推奨	implementation-only-deprecated.md
メンバインポート可視性	member-import-visibility.md
既知パスのモジュール不在	missing-module-on-known-paths.md
モジュールテスト不可	module-not-testable.md
モジュールバージョン不在	module-version-missing.md
Clang 宣言インポート	clang-declaration-import.md
可用性未認識名	availability-unrecognized-name.md
Always-available ドメイン	always-available-domain.md
近日公開の言語機能	upcoming-language-features.md
不明な警告グループ	unknown-warning-group.md
コンパイルキャッシング	compilation-caching.md
Embedded 制限	embedded-restrictions.md

Swift 言語診断

診断	ファイル名
動的呼び出し可能要件	dynamic-callable-requirements.md
プロパティラッパー要件	property-wrapper-requirements.md
結果ビルダーメソッド	result-builder-methods.md
文字列補間適合性	string-interpolation-conformance.md
末尾クロージャマッチング	trailing-closure-matching.md
一時ポインタ	temporary-pointers.md
セマンティックコピー	semantic-copies.md
パフォーマンスヒント	performance-hints.md

インデックス

診断	ファイル名
診断グループ (分類法)	diagnostic-groups.md
すべての診断インデックス	diagnostics.md

上記に記載されていない診断が必要な場合は、診断ディレクトリをリストします:

ls $AXIOM_XCODE_PATH/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/

ファイル名は診断の短い名前に従います (小文字、ハイフン区切り)。

ルーティング決定木

Apple API/フレームワークに関するユーザーの質問?
├── 特定のコンパイラエラー/警告 → Read {diagnostics base}/<diagnostic-name>.md
├── Liquid Glass 実装 → Read {guides base}/<Framework>-Implementing-Liquid-Glass-Design.md
├── Swift 並行処理パターン → Read {guides base}/Swift-Concurrency-Updates.md
├── Foundation Models / オンデバイス AI → Read {guides base}/FoundationModels-Using-on-device-LLM-in-your-app.md
├── SwiftData 機能 → Read {guides base}/SwiftData-Class-Inheritance.md
├── StoreKit / IAP → Read {guides base}/StoreKit-Updates.md
├── App Intents / Siri → Read {guides base}/AppIntents-Updates.md
├── Charts / ビジュアライゼーション → Read {guides base}/Swift-Charts-3D-Visualization.md
├── テキスト編集 / AttributedString → Read {guides base}/SwiftUI-Styled-Text-Editing.md または Foundation-AttributedString-Updates.md
├── SwiftUI での WebKit → Read {guides base}/SwiftUI-WebKit-Integration.md
├── ツールバー機能 → Read {guides base}/SwiftUI-New-Toolbar-Features.md
└── その他 → ベースディレクトリを ls して利用可能なものを確認

Xcode が利用不可な場合のフォールバック

AXIOM_XCODE_PATH が設定されていない場合、パスが存在しない場合、または IDEIntelligenceChat.framework ディレクトリがない場合 (古い Xcode):

1. sosumi.ai (developer.apple.com のマークダウンミラー — axiom-tools/apple-docs-research.md を参照)
2. WebFetch による同等の developer.apple.com URL
3. 最新の Xcode をインストール して、Apple ドキュメントの完全なカバレッジを得るよう提案

静かに失敗しないでください。Xcode ドキュメントがローカルで利用できない場合、およびどのフォールバックを使用したかをユーザーに伝えます。

MCP 便利パス

axiom-mcp を使用するクライアントは、axiom_read_skill をレガシー ID で呼び出すこともできます (例: apple-guide-swiftui-implementing-liquid-glass-design)。MCP サーバーは同じ Xcode ファイルを読み取り、同じコンテンツを返します。両方のパスがサポートされます。ファイル Read パスはどこでも機能します。MCP パスはカタログ/検索ワークフローの便宜です。

研究方法論

WWDC トランスクリプトキャプチャ (Chrome 自動キャプチャ)、sosumi.ai ドキュメンテーションアクセス、マルチセッション研究ワークフローについては、skills/apple-docs-research.md を参照してください。

リソース

スキル: axiom-swiftui, axiom-concurrency, axiom-data, axiom-ai, axiom-integration