Besty0728/Unity-Skills

UnitySkills – Unityエディタ自動化のためのAI駆動型REST API

概要 – UnitySkillsは、Unityエディタ内でローカルHTTPサーバーを実行するUnity 2022.3+用プラグインです。このサーバーは、805個の「スキル」（小規模で特定の動作）をRESTエンドポイントとして公開します。AIコーディングアシスタント（Claude Code、Antigravity、Codex、Cursor、Kimi Code、OpenCode）は、これらのエンドポイントを呼び出して、Unityのアセット、シーン、プレハブ、シェーダー、UI、物理演算、ネットワーク、XR設定、その他多くのエディタタスクを作成、変更、削除できます。

重要性 – エディタ操作を明確に定義されたAPIの背後に配置することで、UnitySkillsは大規模言語モデル（LLM）が真のUnity開発者として機能することを可能にします。単なるコード生成ではなく、具体的なコマンドを発行できるのです。本プロジェクトは、AIによるシーン編集における最大の懸念である「誤操作による破損」に対処するため、安全レイヤー（ドライラン計画、操作ごとの権限モード、監査ログ、トランザクションロールバック）を追加しています。

主要機能

機能	内容
805個のRESTスキル	54のカテゴリに分類された800以上の即戦力アクション（例：YooAsset、Cinemachine、Netcode、UI Toolkit、XR、ShaderGraphなど）。各スキルは、AIアシスタントからスクリプト化または呼び出し可能な、文書化された小さなHTTPコールです。
3段階の権限システム	承認（人間がトークンを付与）、自動（全自動実行、高リスク操作はブロック）、バイパス（制限なし）。モードはUnityパネルから設定可能で、Claude Codeの権限モデルにマッピングされます。
ドライラン / 計画モード	エンドポイントに `?mode=dryRun` または `?mode=plan` を付加することで、プロジェクトに影響を与えずにパラメータ検証と影響予測を取得できます。
トランザクションバッチ実行	`POST /skills/batch` は一連のスキルを単一のトランザクションとして実行します。フェイルファスト、オプションの `continueOnError`、ステップ間の `$ref`、失敗時の自動ロールバック、および変更の `?diff=1` プレビューをサポートします。
監査トレイル	すべての呼び出し、許可、取り消し、ブロックされたリクエストは `Library/UnitySkillsAudit.jsonl` に書き込まれます。ログはパネル内で確認でき、削除操作も記録されます。
ロールバックの粒度	5種類のスナップショットがドメインリロード後も保持されます。`workflow_undo_task` はプロジェクト全体ではなく、単一のタスクをロールバックします。
マルチインスタンス制御	サーバーは空きポートを自動的に検出し、グローバルレジストリを介して複数のUnityプロジェクトを同時に管理できます。
長寿命接続	設定可能なタイムアウト（デフォルト15分）と、ドメインリロード後の自動再接続機能を備えています。
ハルシネーション防止ガードレール	各スキルには「禁止」リストとルーティングルールが付属しており、AIが安全でない操作を発行するのを防ぎます。

対応AIターミナル（ワンクリックインストール）

ターミナル	ステータス
Antigravity	✅ (Codexと `.agents/skills/` を共有)
Claude Code	✅
Codex	✅
Cursor	✅
Kimi Code	✅
OpenCode	✅

他のツールを使用している場合でも、手動でスキルをインストール可能です（「手動スキルインストール」セクションを参照）。

クイックスタート（3ステップ）

Unityパッケージの追加 – Package Managerで、以下のGit URLを追加します：
```
https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity
```
（または #beta やタグ付きバージョンを使用してください）。
サーバーの起動 – Window → UnitySkills を開く（または Alt + Shift + U を押す）か、サーバーのスイッチを切り替えます。サーバーはドメインリロード後も自動的に維持されます。
AIスキルセットのインストール – 同じパネル内の AI Config タブに移動し、ターミナルのアイコンを選択して Install をクリックします。インストーラーは unity-skills~/ テンプレートをターミナルのスキルディレクトリにコピーし、必要な agent_config.json を作成して、AIツールにスキルを登録します。

安全性とガバナンス

実行前プレビュー – ?mode=dryRun/?mode=plan を使用して、スキルが何を変更するかを確認します。
権限ゲート – 高リスク操作（NeverInSemi とマークされたもの）は、ユーザーが許可リストを通じて明示的に許可しない限りブロックされます。
構造化ログ – すべてのアクティビティはJSONLとして保存され、監査やリプレイが容易です。
ロールバック – スナップショットはコンテンツアドレス指定されており、他の作業を失うことなく単一のタスクやバッチ全体を元に戻すことができます。

想定ユーザー

ゲーム開発者：ボイラープレートコードを書かずに、LLMでレベルレイアウトのプロトタイプ作成、UI生成、ネットワーク設定を行いたい方。
テクニカルアーティスト：AIコマンドを介してアセット（YooAssetバンドル、ShaderGraph調整、ProBuilderメッシュなど）をバッチ処理したい方。
ツール開発者：Unityを外部自動化パイプラインと統合するための、安定したバージョン管理されたAPIが必要な方。
研究者：複雑なエディタ環境における安全なAI支援コンテンツ作成を模索している方。

詳細情報

操作モードとガバナンス – docs/OPERATING_MODES.md
セットアップガイド – docs/SETUP_GUIDE.md (英語) / docs/SETUP_GUIDE_CN.md (中国語)
スキルカタログ – READMEの「805 Skills Category Overview」セクションに、すべてのスキルグループとその主要機能がリストされています。

要約

UnitySkillsは、UnityエディタをAIコーディングアシスタントが安全に呼び出せるREST駆動型サービスに変えます。数百の即戦力アクション、詳細な権限システム、監査ログ、トランザクションロールバックを備えており、AI主導のシーン編集を実際のプロジェクトで実用的なものにします。