mcpField
U
unity-primetween

unity-primetween

github.com/besty0728開発1.9k50 回インストール今日更新
リポジトリ

unity-primetween について

unity-primetween は、PrimeTween の確認と、Transform を対象とするトゥイーンやシーケンスのスクリプト生成を行う Unity Editor 用スキルです。PrimeTween を使う Unity 開発者向けで、DOTween 型の設定アセットではなく、ライブラリのファクトリーとランタイム設定を扱います。

主な機能

  1. 01PrimeTween の導入状態とバージョン確認
  2. 02プロセス全体のランタイム設定の取得
  3. 03公開静的 API メソッドの一覧表示
  4. 04Transform トゥイーンスクリプトの生成
  5. 05連結またはグループ化したシーケンスの生成

活用シーン

  1. 01プロジェクトへの PrimeTween 導入確認
  2. 02利用可能なトゥイーンファクトリーの調査
  3. 03Transform アニメーションコンポーネントの作成
  4. 04連結・グループ化したステップによるシーケンス構築

MCP 対応

PrimeTween の調査とスクリプト生成を行う Unity Editor スキルを MCP クライアントに提供します。スクリプト生成には Bypass モードまたはユーザー管理の Allowlist エントリーが必要です。

インストール

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

$npx skills add https://github.com/besty0728/unity-skills --skill unity-primetween

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

詳細

このモジュールのスキルを呼び出す前に： 名前や説明から推測したパラメーターでスキルを呼び出そうとしている場合は、いったん中止し、まずこのファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。

トリガー

  • PrimeTween のインストール状態を確認する
  • 対応するアニメーション API を調べる
  • Transform/Sequence アニメーションコードを生成する
  • PrimeTween のインストール状態の確認、アニメーション API の調査、Transform/Sequence アニメーションコードの生成

PrimeTween スキル

PrimeTween Free のサポートは、DOTween を模倣するのではなく、意図的に PrimeTween の API に合わせています。静的ファクトリーを検出し、プロセス全体の設定を読み取り、Tween または Sequence のハンドルを所有して停止するランタイムスクリプトを生成します。DOTween 形式の設定アセットを構成したり、PrimeTween Pro のコンポーネントを作成したりすることはありません。

ガードレール

  • PrimeTween は com.kyrylokuzyk.primetween としてインストールされている必要があります。
  • クエリスキル（primetween_get_status、primetween_get_config、primetween_list_factories）は、すべての動作モードで直接実行できます。
  • このモジュールでは、2 つのスクリプトジェネレーター primetween_generate_tween_script と primetween_generate_sequence_script は自動的に禁止されています（どちらも MayTriggerReload = true、RiskLevel = "high" であり、新しい .cs ファイルを書き込むとコンパイルと Domain Reload が発生します）。Approval モードでも Auto モードでも MODE_FORBIDDEN を返します。Bypass モード、またはユーザーが管理する Allowlist エントリー経由でのみ実行できます。許可フローも MODE_FORBIDDEN を返すため、試みないでください。
  • primetween_get_config は読み取り専用です。PrimeTweenConfig はランタイム状態であり、シリアル化されたプロジェクト設定アセットではありません。
  • 生成されるスクリプトは、Transform の Position、LocalPosition、EulerAngles、LocalEulerAngles、Scale に対応しています。このジェネレーターが対応する範囲外の API を要求する前に、primetween_list_factories を使用してください。
  • PrimeTween のハンドルは再利用できません。生成されるスクリプトは、DOTween の SetLink 相当を使用する代わりに、無効化時に自身が所有する実行中のハンドルを停止します。

Free スキル

primetween_get_status

PrimeTween がインストールされているか、そのパッケージバージョン、アセンブリ、および確認可能なコア型を報告します。

パラメーター： なし。

primetween_get_config

PrimeTweenConfig が公開する現在のグローバルランタイム値を読み取ります。

パラメーター： なし。

primetween_list_factories

PrimeTween API 型のパブリック静的メソッドを一覧表示します。

パラメーター： typeName="Tween"（Tween、Sequence、Shake、または PrimeTweenConfig）、methodPrefix?、limit=100。

primetween_generate_tween_script

Tween を所有し、無効化時に停止する、Transform に特化した PrimeTween MonoBehaviour を作成します。

パラメーター： className、folder="Assets/Scripts/PrimeTween"、namespaceName?、tweenKind="LocalPosition"、duration=1、ease="OutQuad"、cycles=1、cycleMode="Restart"、autoPlay=true。

primetween_generate_sequence_script

対応する Transform tween ファクトリーと Sequence.Chain、Sequence.Group を使用する PrimeTween MonoBehaviour を作成します。

パラメーター： className、folder="Assets/Scripts/PrimeTween"、namespaceName?、tweenKind="Scale"、duration=0.2、ease="OutBack"、cycles=1、sequenceCycleMode="Restart"、autoPlay=true、stepsJson?。

stepsJson は { "op": "Chain|Group", "tweenKind": "Scale", "duration": 0.2 } の配列を含む JSON です。

正確なシグネチャ

正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく、GET /skills/schema または unity_skills.get_skill_schema() で定義されています。

コメント

Markdown 対応