mcpField
R
realitykit-visionos-developer

realitykit-visionos-developer

github.com/tomkrikorian開発66166 回インストール19 週間前に更新
リポジトリ

realitykit-visionos-developer について

realitykit-visionos-developerは、visionOS開発者向けのRealityKitスキルです。シーン設定、エンティティ読み込み、入力、アンカリング、同期を扱い、作業内容に応じて専門スキルやリファレンスへ案内します。シーン変更は文書化された入口で行う方針です。

主な機能

  1. 01RealityViewのシーン設定ガイド
  2. 02コンポーネント選択とエンティティ読み込み
  3. 03入力、アタッチメント、アンカリングの処理
  4. 04ポータルとエンティティ同期の対応
  5. 05専門スキルへのタスク振り分け

活用シーン

  1. 01RealityKitシーンの構築
  2. 02エンティティの入力とアタッチメント設定
  3. 03空間アンカーやポータルの処理
  4. 04ARKitやSwiftUIへ切り替える判断

インストール

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

$npx skills add https://github.com/tomkrikorian/visionosagents --skill realitykit-visionos-developer

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
accessibilitycomponent.md
anchoringcomponent.md
arkitanchorcomponent.md
attachedtransformcomponent.md
billboardcomponent.md
component-index.md
component-selection.md
dockingregioncomponent.md
entity-loading-and-stored-entities.md
environmentblendingcomponent.md
gesturecomponent.md
hovereffectcomponent.md
imagepresentationcomponent.md
inputtargetcomponent.md
manipulationcomponent.md
portal-volumes-and-accessory-anchoring.md
portalcomponent.md
portalcrossingcomponent.md
presentationcomponent.md
referencecomponent.md
sceneunderstandingcomponent.md
spatialtrackingsession.md
synchronizationcomponent.md
textcomponent.md
transientcomponent.md
usdstagecomponent.md
videoplayercomponent.md
viewattachmentcomponent.md
worldcomponent.md

詳細

RealityKit visionOS 開発者

クイックスタート

  1. リクエストを、コアシーンのセットアップ、レンダリング／マテリアル、 アニメーション／物理、オーディオ、カスタム ECS、USD 作成、Spatial Preview、 SwiftUI UI、ARKit プロバイダーの処理、またはビルド／デバッグ関連に分類します。
  2. RealityView のセットアップ、エンティティの読み込み、コンポーネントの 選択、入力、アタッチメント、アンカリング、ポータル、同期、およびローカルの USDStageComponent ブリッジについては、このスキルを使用します。
  3. 主なタスクが視覚表現、アニメーション、物理、オーディオ、またはカスタム ECS の 振る舞いに関する場合は、該当する RealityKit スキルに切り替えます。
  4. タスクに必要な範囲に絞って、参照ファイルを読み込みます。
  5. すべてのシーン変更を、ドキュメント化された RealityKit のエントリーポイント内で 行います。 RealityView のコンテンツ／更新クロージャー、イベントハンドラー、または登録済み システムを使用します。

RealityKit の振り分け

タスク使用するもの
RealityKit 全般のトリアージ、コンポーネントの選択、エンティティの読み込み、入力、アタッチメント、アンカリング、ポータル、同期、ローカルの USDStage ブリッジこのスキル
メッシュ表示、マテリアル、カメラ、ライト、シャドウ、ポストプロセス、Gaussian splats、デカール、LOD、オクルージョン、ライトマップ、プローブrealitykit-rendering-materials
アニメーションクリップ、キャラクターコントローラー、スケルタルポーズ、IK、ボディトラッキング、リターゲティング、ナビゲーション、ビヘイビアツリー、コリジョン、物理、ジョイント、力、パーティクル、クロスrealitykit-animation-physics
空間オーディオ、環境音またはチャンネルオーディオ、オーディオライブラリ、ミックスグループ、リバーブ、音響シミュレーションrealitykit-audio-spatial
カスタムコンポーネント、システム、ECS クエリ、登録、更新順序、フレームごとの複数エンティティの振る舞いrealitykit-ecs-systems
Spatial Preview を使用した、Mac アプリから Vision Pro へのドキュメントまたはライブ USD ステージのストリーミングspatial-preview-developer
Swift の USDKit ステージ／レイヤー／プリム APIusdkit-runtime-developer
作成済み USD の編集、またはコマンドラインでの USD 検査usd-editor
USDA での ShaderGraph または RealityKit マテリアルグラフの編集shadergraph-editor
ARKitSession プロバイダー、権限、アンカーストリームの直接的な調整arkit-visionos-developer
SwiftUI のレイアウト、オーナメント、ウィンドウ、イマーシブスペース、または対象を絞ったジェスチャーの使いやすさspatial-swiftui-developer
ビルド、起動、シミュレーター／デバイスのログ、または実行時のデバッグbuild-run-debug

リファレンスを読み込むタイミング

リファレンス使用するタイミング
references/component-selection.mdドキュメント化された RealityKit コンポーネント、SwiftUI の対象を絞ったジェスチャー、SpatialTrackingSession、ARKit、RealityKit に特化したスキル、カスタム ECS 作業の中から選択するとき。
references/component-index.mdコンポーネントのカテゴリと、次に開くべき担当スキル／リファレンスを確認するとき。
references/entity-loading-and-stored-entities.md名前付きの保存済みエンティティ、明示的なファイル URL、パッケージにバンドルされたアセット、USD/USDZ、.reality、または Reality Composer Pro の出力を読み込むとき。
references/inputtargetcomponent.mdエンティティをヒットテストと入力の対象にするとき。必要に応じて、realitykit-animation-physics のコリジョンに関する詳細と併用してください。
references/manipulationcomponent.mdカスタムの変換スタックを作成する前に、組み込みの直接操作を使うとき。
references/gesturecomponent.mdSwiftUI のジェスチャーを RealityKit エンティティに直接アタッチするとき。
references/hovereffectcomponent.md および references/accessibilitycomponent.mdインタラクティブなエンティティにホバー時の視覚的手がかりやアクセシビリティメタデータを追加するとき。
references/viewattachmentcomponent.mdSwiftUI ベースのビューをエンティティグラフに埋め込むとき。
references/presentationcomponent.md、references/textcomponent.md、references/imagepresentationcomponent.md、references/videoplayercomponent.mdRealityKit でテキスト、画像、ビデオ、またはプレゼンテーション形式のコンテンツを表示するとき。
references/anchoringcomponent.md、references/arkitanchorcomponent.md、references/spatialtrackingsession.md空間ターゲットにコンテンツをアンカーするとき、または RealityKit によるトラッキングで十分かを判断するとき。
references/sceneunderstandingcomponent.md、references/dockingregioncomponent.md、references/referencecomponent.md、references/attachedtransformcomponent.md空間リファレンス、ドッキング、シーン理解、または変換アタッチメントを扱うとき。
references/portalcomponent.md、references/portalcrossingcomponent.md、references/worldcomponent.md、references/environmentblendingcomponent.md、references/portal-volumes-and-accessory-anchoring.mdポータル、ワールド、環境ブレンディング、visionOS 27 の新しいポータル／アクセサリーのアンカリング動作を組み合わせるとき。
references/synchronizationcomponent.md、references/transientcomponent.mdマルチユーザー／セッションの動作のためにエンティティの状態を同期またはマークするとき。
references/usdstagecomponent.mdRealityKit 内でライブの USDKit ステージをレンダリングするとき、またはエンティティ階層を USD にエクスポートするとき。Swift の USDKit ステージ作成については usdkit-runtime-developer に切り替えてください。Spatial Preview のストリーミングについては spatial-preview-developer に切り替えてください。

ガードレール

  • RealityView を使用してください。visionOS では ARView は利用できません。
  • アセットは非同期で読み込み、メインアクターをブロックしないようにしてください。
  • SwiftUI の body コードは宣言的に保ち、RealityKit のコンテンツは RealityView、イベント、またはシステムを通じて変更してください。
  • カスタム ECS よりも、ドキュメント化されたコンポーネントを優先してください。
  • カスタムコンポーネントとシステムは、それらに依存するシーンやアセットの読み込み前に、アプリの起動時に一度だけ登録してください。
  • 組み込みの直接操作で要件を満たせる場合は、ManipulationComponent.configureEntity(...) を優先してください。
  • SpatialPreview は macOS 27 の送信元アプリからのみ使用してください。Vision Pro では組み込みのシステムビューアーを使用し、visionOS の SpatialPreview モジュールはありません。

出力時の要件

以下を提示してください。

  • RealityKit のタスクカテゴリ
  • 使用した特化スキルまたはリファレンス
  • 選択したコンポーネント、アタッチメント、エンティティ読み込み、またはシステムの方法
  • 主な制約または注意点
  • 必要に応じて SwiftUI、ARKit、USD、Spatial Preview、またはビルド／デバッグへの案内

コメント

Markdown 対応