Communitygithub.com

vectojs/vectojs-skills

Codex、Claude Code、Cursor、GitHub Copilot で VectoJS プロジェクトのビルド、最適化、埋め込み、エクスポートを行うためのエージェントスキルです。

vectojs-skills とは?

このスキルは、VectoJS の 2D インターフェースを Three.js のテクスチャとして埋め込み、3D 空間内で動作させるための統合ワークフローを提供します。ThreeAdapter を使用して VectoJS パネルをテクスチャ化し、ホストの Three.js シーンに追加することで、VR/AR 環境や一般的な 3D シーン内に高品質な UI を配置できます。ポインター入力(クリック、ホイールなど)は、レイキャスティングされた UV 座標を通じて VectoJS の 2D シーンにルーティングされるため、3D 変換が適用されたメッシュ上でも正確なヒットテストが可能です。対応プラットフォームは Codex、Claude Code、Cursor、GitHub Copilot で、SKILL.md には具体的な実装手順、制約、バージョン別の注意点、よくあるミスとその修正方法が詳細に記載されています。このスキルを活用することで、開発者は複雑な 3D 環境下でも VectoJS の柔軟な 2D UI をシームレスに統合できます。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add vectojs/vectojs-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

VectoJS Three

このスキルを使用すると、ライブの VectoJS 2D インターフェースを Three.js テクスチャ上に配置し、3D ポインター入力を VectoJS シーンにルーティングできます。

統合ワークフロー

  1. @vectojs/core、@vectojs/three、three、および UI コンポーネントを使用する場合は @vectojs/ui をインストールします。
  2. VectoJS パネルテクスチャごとに 1 つの ThreeAdapter を作成します。
  3. VectoJS エンティティを adapter.vectoScene に追加し、内部シーンを起動します。
  4. adapter.mesh またはアダプターのテクスチャ/マテリアルをホストの Three.js シーンに追加します。
  5. ホストのポインター/ホイールループで、アダプターメッシュに対してレイキャストを実行し、adapter.updateIntersection(...) を呼び出します。
  6. パネルを削除するときは adapter.dispose() を呼び出します。

詳細なスニペットについては references/three-recipes.md を参照してください。

制約

  • デフォルトの出力は平らなテクスチャ付きプレーンであり、3D 空間で DOM レンダリングされるわけではありません。
  • VectoJS の論理的なヒットテストは、メッシュがワールド空間で変換されても 2D のままです。
  • ホストアプリケーションがカメラ、レンダラー、コントロール、XR セッション、レイキャスター、およびオクルージョンルールを所有します。
  • レイキャスト UV はアダプターの論理的な width/height にマッピングする必要があります。レイアウト計算にバッキングストアサイズを使用しないでください。
  • テクスチャ解像度はシャープネスとアップロードコストに影響します。視聴距離に合わせた寸法を選択してください。

よくあるミス

ミス修正方法
オフスクリーンアダプターキャンバスを DOM に追加するadapter.mesh を Three.js に追加します。キャンバスはテクスチャをバックアップします。
updateIntersection の呼び出しを忘れるホストのレイキャスターイベントを各ポインター/ホイールイベントごとにアダプターにルーティングします。
画面座標でディスパッチするThreeAdapter を通じてレイキャスト UV を使用します。
破棄されたテクスチャを保持し続けるadapter.dispose() を呼び出し、ホストの参照を削除します。
XR 内で完全な DOM アクセシビリティを期待する3D パネルをキャンバステクスチャとして扱い、必要に応じてホストレベルのセマンティクスを提供します。

バージョンおよびバックエンドの注意点(ソース確認済み)

  • three ≤ 0.1.3: ThreeRenderer.flush() は完全な GL レンダリングを実行し、Scene はすべての非バッチノードの周りでフラッシュします。そのため、エンティティ数に応じてフレームコストが O(N²) で増加しました。three 0.1.4 では present() フックを介して 1 フレームに 1 回レンダリングします。他のプロファイリングを行う前にアップグレードしてください。
  • テクスチャ内のネイティブ入力は制限されています。 アダプターのキャンバスはオフスクリーンであるため、Scene の投影されたアクセシビリティ要素はドキュメントに接続されません。updateIntersection は VectoJS 独自のイベントディスパッチにフォールバックします。ボタン、ホバー、ホイールは動作しますが、完全なネイティブ IME/テキスト編集は動作しません。テキスト入力は 3D パネルの外部に保持するか、簡略化された入力を許容してください。
  • stroke() の線幅はほとんどのプラットフォームで実質的に 1px です(LineBasicMaterial.linewidth は既知の WebGL の制限です)。太い線は塗りつぶし形状として描画してください。
  • ThreeRenderer.drawImage は呼び出しごとにテクスチャを割り当てます(clear() で破棄されます)。可能な場合はソースキャンバスを再利用してください。fillText は three 0.1.4 からキャッシュされます(font|color|text をキーとし、256 エントリの LRU)。≤ 0.1.3 では呼び出しごとに同じコストがかかるため、その場合は MSDFTextEntity を優先的に使用してください。

関連スキル