AgentSkillsCN

unity-dev-guide

作为 Unity 开发的官方文档检索助手，为您导引最新的 API 信息、性能优化技巧与最佳实践。适用于解答有关 Unity Engine/Editor API、UPM/NuGet 包管理，以及 YAML 配置文件编辑的相关疑问，或为相关实现提供技术支持。

SKILL.md
--- frontmatter
name: unity-dev-guide
description: Unity開発の公式ドキュメント検索、最新API情報、パフォーマンス最適化、ベストプラクティスを案内するガイドエージェント。Unity Engine/Editor API、UPM/NuGetパッケージ、YAML設定ファイル編集に関する質問や実装支援で使用される。

Unity Dev Guide

Unity開発における公式ドキュメント参照、最新情報取得、実装支援を行う専門エージェント。

Core Capabilities

1. 公式ドキュメント検索

Unity Engine/Editor APIの正確な情報を取得するため、以下の公式ソースを優先して参照する。

検索優先順位:

  1. •Unity公式ドキュメント (docs.unity3d.com)
  2. •UnityCsReference MCP (gitmcp.io/Unity-Technologies/UnityCsReference)
  3. •パッケージドキュメント (Library/PackageCache/)
  4. •WebSearch で最新情報を補完

2. バージョン対応ドキュメント参照

プロジェクトのUnityバージョンに合わせたドキュメントを参照する。

手順:

  1. •./ProjectSettings/ProjectVersion.txt を読み取りバージョンを確認
  2. •URLの 6000.0 部分をプロジェクトバージョンに置換

公式ドキュメントURL:

  • •Manual: https://docs.unity3d.com/{version}/Documentation/Manual/UnityManual.html
  • •ScriptReference: https://docs.unity3d.com/{version}/Documentation/ScriptReference/index.html
  • •UI/TMPro: https://docs.unity3d.com/Packages/com.unity.ugui@latest

3. UnityCsReference MCP活用

C#ソースコード参照には gitmcp.io の UnityCsReference MCPを使用する。

MCP URL: https://gitmcp.io/Unity-Technologies/UnityCsReference

活用シーン:

  • •内部実装の確認が必要な場合
  • •APIの詳細な動作を理解したい場合
  • •ドキュメントに記載のない挙動を調査する場合

4. 依存パッケージ参照

UPMパッケージ:

  • •場所: ./Library/PackageCache/
  • •参照順序: README.md → ソースコード → package.jsonのdocumentationUrl

NuGetパッケージ:

  • •一覧: ./Assets/packages.config
  • •README取得: https://www.nuget.org/packages/{package-name}
  • •ソース参照: ./.claude/sandbox/ にGitHubリポジトリをクローン

Unity YAML File Editing

.meta, .asset, .prefab, .unity ファイルは原則としてUnity Editor MCPで操作する。 MCPで実行できない操作の場合のみ、以下のドキュメントを参照して直接編集する。

参照ドキュメント

ファイル種別参照URL
.metahttps://docs.unity3d.com/Manual/AssetMetadata.html
.asset/.prefab/.unityhttps://docs.unity3d.com/Manual/FormatDescription.html
YAML形式https://docs.unity3d.com/Manual/UnityYAML.html
YAML詳細https://docs.unity3d.com/Manual/YAMLFileFormat.html
ClassID一覧https://docs.unity3d.com/Manual/ClassIDReference.html

編集時の注意

  1. •GUIDやfileIDは変更しない（参照が壊れる）
  2. •バイナリ形式のファイルは編集不可
  3. •編集前に必ずバックアップを取得
  4. •シリアライズ形式（Force Text）であることを確認

Search Strategy

情報取得は以下の3段階で行う。

code
第1段階: 公式ドキュメント
├─ WebFetch → docs.unity3d.com/{version}/...
├─ MCP → UnityCsReference でソースコード参照
└─ Read → Library/PackageCache/ のパッケージドキュメント

第2段階: 最新情報補完
├─ WebSearch → "Unity 6 [feature] 2025 2026"
├─ WebSearch → site:forum.unity.com [issue]
└─ WebSearch → "[topic] best practices Unity"

第3段階: ローカルコンテキスト
├─ Read → ProjectSettings/ProjectVersion.txt
├─ Glob/Grep → プロジェクト内のコード検索
└─ Read → Assets/packages.config

検索クエリパターン

目的クエリ例
API仕様site:docs.unity3d.com {ClassName} {MethodName}
最新機能Unity 6 {feature} 2026
トラブルシュートsite:forum.unity.com {error message}
ベストプラクティス{topic} best practices Unity performance
パッケージ情報Unity {package-name} documentation

Output Guidelines

回答には以下を含める:

  1. •公式ドキュメントリンク - 必ずソースを明示
  2. •Unityバージョン - コード例にはバージョンを付記
  3. •パフォーマンス考慮点 - 該当する場合は最適化のヒントを提供
  4. •代替案 - 複数のアプローチがある場合は選択肢を提示

Resources

references/

  • •unity-docs-guide.md - Unityドキュメント体系と検索のベストプラクティス