mcpField
R
reuse-scripts

reuse-scripts

github.com/playcanvas開発31309 回インストール1 週間前に更新
リポジトリ

reuse-scripts について

動作を実装する前に、PlayCanvas Engine に同梱されたコードを再利用する開発スキルです。スクリプトやエクスポートの調査、公式サンプルの適応、描画結果の確認を支援します。

主な機能

  1. 01同梱 Engine スクリプトの一覧化
  2. 02スクリプト以外の主要エクスポートの特定
  3. 03プロパティと依存関係の確認
  4. 04公式サンプルの適応
  5. 05描画フレームとエラーの検証
  6. 06同梱コードの入力動作を維持

活用シーン

  1. 01コントローラーの自作前に既存実装を探す
  2. 02必要なアセットや設定とともに Engine スクリプトを組み込む
  3. 03コンソールやシェーダーのエラーを確認

インストール

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

$npx skills add https://github.com/playcanvas/skills --skill reuse-scripts

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

同梱ファイル

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

references/
direct-engine.md
react.md
web-components.md

詳細

同梱されている Engine コードを再利用する

動作を実装する前に、インストール済みの playcanvas パッケージで何が提供されているか確認してください。

スクリプトは scripts/esm/** 配下にあります。次のコマンドで一覧表示します。

rg 'static scriptName =' node_modules/playcanvas/scripts/esm \
  | sed "s|.*/scripts/esm/||; s|:.*static scriptName = ['\"]|  ->  |; s|['\"].*||" \
  | sort

よく使われるものには、CameraControls、FirstPersonController、ThirdPersonController、 ShadowCatcher、ProceduralSky、Water、Grid のほか、XR とスプラットのスクリプトがあります。 scripts/esm/parsers 配下のモジュールはスクリプトではなく、リソースハンドラーのクラスです。

スクリプトではないコアのエクスポートには、ポストプロセス用の CameraFrame、Picker （getSelectionAsync）、TransformGizmo、OutlineRenderer、MiniStats、GltfExporter、 UsdzExporter があります。

統合する

  1. エクスポート、@attribute プロパティ、デフォルト値、必要なコンポーネントを確認するため、ソースを読みます。
  2. find-examples で公式の例を探し、その例が依存するアセット、レイヤー、シーン設定、レンダー設定をコピーします。
  3. 設定と拡張ポイントを調整します。適合するものがなければ、不足している部分だけを実装し、何が不足していたかを明記します。
  4. フレームをレンダリングした後、コンソール、シェーダー、またはアセット不足のエラーがあれば失敗とします。

特に指示がない限り、同梱スクリプトの入力マッピングと減衰設定は維持し、符号を記憶から推測せず、実際に入力して入力方向を確認してください。

グループ化されたプロパティの更新方法はサーフェスによって異なります。変更しないデフォルト値は維持してください。コードに合ったリファレンスだけを読みます：direct Engine、 React、または Web Components。

コメント

Markdown 対応