Git レビュー、意味ベースの差分、3-way merge のための Unity Editor extension

MergeSight

Unity アセットをレビューしてマージ


変更を理解し、不安なくマージする。

意味ベースレビュー 3-way merge CLI 自動化
Unity 構造の理解 Unity が見る形で変更を確認できます。
安全性を前提に設計 プレビュー、検証、バックアップ。その後で適用。
CLI で自動化 CI チェック、マージドライバー、標準 VCS workflows。

Unity チーム向け。Git に対応。

MergeSight の Unity アセット意味ベースレビュー画面

課題

Unity アセットは通常のテキストレビュー向けには作られていません。

Git が見るのは YAML の行です。Unity チームに必要なのはオブジェクト、コンポーネント、階層、参照、プロパティ変更です。

Assets/Game/Scenes/MainPreview.unity

GameObject &1001オブジェクト識別
156--- !u!1 &1001
157GameObject:
158 m_ObjectHideFlags: 0
159 m_CorrespondingSourceObject: {fileID: 0}参照
160- m_Name: Main Camera
160+ m_Name: Cameraリネーム
161 m_TagString: MainCamera
164- m_StaticEditorFlags: 0
164+ m_StaticEditorFlags: 1フラグ
165... unrelated serialized fields ...
Camera component &2050分割ブロック
243--- !u!20 &2050
244Camera:
246 m_CorrespondingSourceObject: {fileID: 1001}ソース
249 m_GameObject: {fileID: 1001}接続
251- m_FieldOfView: 60
251+ m_FieldOfView: 45プロパティ
252 m_NearClipPlane: 0.3
253 m_FarClipPlane: 1000

大きな階層変更を伴う実際のシーンリファクタリングでは、raw YAML の中で移動したノード、並び替えられた子要素、プロパティ編集がノイズの多いテキストブロックに混ざります。

階層

YAML の行だけでは配置が見えません。

WorldEnvironmentCamera

参照

fileID のつながりは目視で検証しづらいです。

プロパティ

値は変わっても Unity 上の意図は見えません。

FOV 60FOV 45

コンポーネント

一つの Unity 変更が複数ブロックに分かれます。

GameObjectCamera

複雑な Unity アセットのマージのために設計

Unity アセット変更のレビュー、競合解決、自動化を一つのツールで。

MergeSight は Unity アセット変更の理解からマージ判断の安全な適用までをカバーします。

意味ベースレビュー

Unity の文脈でアセット変更を確認できます。

raw YAML を読まずにシーン、Prefab、階層、コンポーネント、参照、Git コンテキストをレビューできます。

変更アセットのみ変更されたシーンと Prefab から確認。
レビュー範囲フィルター種別、状態、パス、変更量で絞り込み。
GUID と参照GUID、fileID、参照先アセットを確認できます。
ブランチコンテキストレビュー中も元リビジョンを確認。
変更された Unity シーンアセットの意味ベースレビュー

3-way merge

コンテキストを見ながら競合を解決。

Base、Ours、Theirs を適切なレベルで選び、結果をプレビューし、必要な判断がすべて解決・検証された後にだけ適用します。

  • Base / Ours / Theirs完全な Unity コンテキストで変更を横並び比較します。
  • 競合の分類競合を自動分類し、リスクをハイライトします。
  • 安全な自動解決安全な判断だけを自動適用し、残りをレビューします。
  • 適用前のプレビュー変更を書き込む前に正確な結果を確認できます。
  • バックアップと検証元ファイルをバックアップし、マージ後に検証します。
MergeSight 3-way merge workflow preview

CLI 自動化

CI pipeline 向けマージチェック

同梱の .NET CLI で高速な CI チェック、意味ベースのマージ成果物、Git merge-driver mode、検出された VCS merge-tool workflows を利用できます。

  • CI チェックinspect, check, auto-plan, validate-plan
  • Git merge-driverGit ワークフローから安全な意味ベース判断を実行
  • VCS out of the boxGit、Perforce、Unity Version Control、SVN workflows
同梱 .NET CLI
CI 対応
Libraries/StandaloneCLI/bin/mergesight.dll

実行

$ dotnet Libraries/StandaloneCLI/bin/mergesight.dll check

Unity text assets に CI-safe な検証を実行し、未解決または危険な merge 状態があれば失敗します。

merge-check.json 終了コード 0

Use Cases

あらゆる Unity asset workflow のために。

Developers、artists、designers、automation pipelines が Unity assets を安全に review / merge するための context を提供します。

Unity Developers

  • Scene、prefab、material、.asset changes を review
  • BASE / OURS / THEIRS conflicts を解決
  • Broken asset merges から main branch を保護
  • Object、component、property、reference diffs を inspect
  • PR reviews 用に Markdown または JSON summaries を export

Technical Artists

  • Prefab overrides と nested prefab changes を理解
  • Material keywords と saved property changes を review
  • GUIDs を探さずに object references を確認
  • Hierarchy、ownership、missing scripts を validate
  • 曖昧な merge decisions だけを escalate

Level Designers

  • Hierarchy、reparenting、reorder、add/remove changes を確認
  • Push または PR 前に scene edits を review
  • 意図しない object、transform、component edits を早期に発見
  • Merge 前に teammate scene changes を理解
  • Raw YAML を読まずに level work を進める

Automation / CI / VCS

  • Unresolved decisions で失敗する CI checks を実行
  • Merge models、decision plans、previews、reports を生成
  • Engine-proven safe decisions だけを auto-resolve
  • Safe automated merges に Git merge-driver mode を使用
  • Git、Perforce、UVCS、SVN、generic VCS workflows と統合

VCS support

標準 VCS ですぐにレビューとマージ。

MergeSight がリポジトリを検出すると、Git、Perforce、Unity Version Control、SVN workflows で Unity-aware review と 3-way merge をすぐに使えます。

GitRepository detected
PerforceWorkspace detected
Unity Version ControlProject detected
SVNWorking copy detected
MergeSight Unity-aware VCS engine Repository detected
意味ベースレビューObject-level Unity changes
3-Way MergeBASE / OURS / THEIRS

ワークフロー

raw Unity YAML から信頼できるマージへ。

MergeSight は text-serialized Unity assets を構造化されたレビュー手順に変換し、危険な判断を明示し、プレビューと検証の後にだけ書き込みます。

01

Unity YAML を解析

アセットファイルを安定した Unity 識別子として解析します。

104--- !u!1 &381924
105GameObject:
-m_Name: EnemySpawner
+m_Name: WaveSpawner
131m_Component:
+- component: {fileID: 99172}
148m_LocalPosition: {x: 4, y: 0, z: 2}
02

Unity 構造でレビュー

オブジェクト、コンポーネント、階層、プロパティを確認できます。

S
SampleScene.unityシーンルート
変更あり
G
WaveSpawnerGameObject 名変更
名称変更
C
EnemyWaveControllerコンポーネント追加
add
P
Transform.positionx が 2 から 4 に変更
03

安全にプレビューして適用

変更ファイルを書き込む前に結果を検証します。

OK
安全な判断意図が明確な場合は自動解決します。
5
!
レビューが必要曖昧な競合は表示されたままです。
3
->
プレビュー、バックアップ、検証マージ結果のチェックが通った後にだけ適用します。
準備完了

サポート対象アセットと要件

MergeSight は text serialization を使う Unity プロジェクト向けの Editor / automation ワークフローです。

主なサポート対象

主なサポート対象は以下の text-serialized Unity asset types です。

.unity .prefab .asset .mat

VCS detection は Unity text asset patterns も認識できます: .physicMaterial, .anim, .controller, .overrideController.

要件

  • アセットに text serialization を使う Unity project。
  • Git workflow には project checkout からの Git access が必要です。
  • Standalone CLI の利用には compatible .NET runtime が必要です。
  • Editor と automation workflow 向けで、runtime build 向けではありません。

機能一覧

領域 機能 重要な理由
レビュー 意味ベースの差分ツリー オブジェクト単位の変更をすばやく理解できます。
レビュー ブランチ / コミット比較 実際の Git workflow 上で Unity アセット変更をレビューできます。
レビュー 要約のエクスポート 読みやすい変更レポートをチームに共有できます。
マージ 3-way 競合モデル Unity コンテキストで Base/Ours/Theirs を解決できます。
マージ 安全な自動解決 安全と判断できる決定だけをツールに任せます。
マージ プレビューと検証 結果の準備ができてからだけ書き込みます。
CLI CI チェック 自動化で未解決の Unity アセットマージを検出します。
CLI Git merge-driver mode Git から安全な意味ベース auto-merge を使えます。
VCS Out-of-box VCS support Git、Perforce、Unity Version Control、SVN workflows でレビューとマージ。

Unity Asset Merge Tools

Unity merge workflows comparison

多くのツールは問題の一部だけを解決します。MergeSight は review、merge、validation、automation をまとめてカバーします。

Feature MergeSight Recommended UnityYAMLMerge Git merge driver File locking Generic text diff
Text YAML merge Partial
Unity semantic context
Visual Unity YAML asset diff Partial
GUID & reference visibility Partial
Review asset filters Partial
Branch/commit comparison Partial
Prefab overrides & nested prefabs Partial Partial
3-way merge Partial Partial
Preview before apply
Validation checks
CI automation Partial Partial

Conclusion: MergeSight は、単なる merge command ではなく full Unity asset merge workflow が必要なチームに最適です。

FAQ

MergeSight は runtime で動作しますか?

いいえ。MergeSight は Editor と automation 用のツールです。runtime package ではなく、player build に含めることを目的としていません。

Web サービスは必要ですか?

いいえ。主要なレビューとマージ機能はローカルで動作します。

すべての merge conflict を自動解決できますか?

いいえ。MergeSight は安全性を重視しています。安全なケースは自動解決できますが、曖昧または未対応の競合では明示的な判断または手動 cleanup が必要です。

Unity アセットのマージにはどのツールを使えますか?

Unity チームは通常、UnityYAMLMerge、Git または VCS merge drivers、Perforce または Unity Version Control locking、generic diff tools、そして semantic review、transparent 3-way decisions、preview、validation、CI artifacts 用の MergeSight を組み合わせます。

Scenes と Prefabs に最適な Unity merge tool は何ですか?

UnityYAMLMerge は automatic scene and prefab Smart Merge の built-in baseline です。Reviewers が Unity context、transparent Base/Ours/Theirs decisions、preview、validation、CI automation を必要とする場合は MergeSight が適しています。

MergeSight は Unity アセットをマージできますか?

はい。MergeSight は .unity、.prefab、.asset、.mat など text-serialized Unity assets の 3-way merge workflows をサポートし、semantic conflict classification、preview before apply、backups、validation を提供します。

MergeSight は UnityYAMLMerge と一緒に使えますか?

はい。UnityYAMLMerge は simple automatic cases に使い続けられます。MergeSight は black-box merge result では不十分なときに transparent review、explicit conflict decisions、preview、validation、CI-readable artifacts を追加します。

UnityYAMLMerge ではなく MergeSight を選ぶべきタイミングは?

UnityYAMLMerge は automatic scene and prefab YAML merges の baseline Smart Merge tool として使います。変更の semantic review、visible Base/Ours/Theirs decisions、conflict classification、merge preview、validation warnings、CI artifacts が必要で、black-box merge result だけでは不十分な場合は MergeSight を選びます。

MergeSight は Unity scene / prefab changes を raw YAML ではなく視覚的に表示できますか?

はい。MergeSight は text-serialized Unity assets を Unity-aware review data として表示し、objects、components、properties、references、prefab overrides、hierarchy changes として確認できます。raw YAML lines だけを見る必要はありません。

MergeSight は GUID、fileID、Unity references を表示できますか?

はい。MergeSight は GUID、fileID、object references、changed asset links などの Unity identity / reference data を表示し、YAML change が何を指しているかを merge 前に理解しやすくします。

MergeSight は Unity assets を branches や previous commits 間で比較できますか?

はい。MergeSight は Unity assets の branch and commit comparison workflows をサポートし、scene、prefab、material、YAML asset changes を merge や pull request の前にレビューできます。

UnityYAMLMerge が失敗したり結果が分かりにくい場合はどうすればよいですか?

UnityYAMLMerge は baseline automatic merge tool として使い、結果の review が必要な場合に MergeSight を使います。MergeSight は Base/Ours/Theirs state、merged output preview、validation warnings、CI-readable evidence を確認できるようにします。

MergeSight は prefab variants、nested prefabs、prefab overrides に役立ちますか?

はい。MergeSight は prefab overrides、nested prefab relationships、variant-style changes の Unity-aware review に重点を置き、apply merge 前に何が変わり何が書き込まれるかを確認できます。

Artists や non-programmers も MergeSight で Unity merge conflicts をレビューできますか?

はい。MergeSight は Unity Editor GUI workflow として設計されているため、technical artists、level designers、non-programmers も YAML conflict markers を手で読む代わりに Unity asset changes を確認できます。

Level designers は YAML を読まずに Unity scene merge conflicts をレビューできますか?

はい。MergeSight は scene merge conflicts を GameObjects、components、properties、references、hierarchy changes、prefab overrides など Unity の文脈で表示するため、level designers は raw YAML を読まずに結果をレビューできます。

MergeSight は merge を適用する前に Unity scene の変更を表示できますか?

はい。MergeSight は Unity scenes、prefabs、materials、YAML assets の preview-before-apply workflows をサポートし、merged result を書き込む前に object placement、component values、references、overrides を確認できます。

複数の level designers が同じ scene や prefab を編集した場合に MergeSight は役立ちますか?

はい。MergeSight は high-risk assets の file locking を置き換えるものではありませんが、Git、Perforce、Unity Version Control、SVN workflows で parallel edits が起きたときに scene や prefab conflicts の review、classification、preview、validation を支援します。

どのアセット種別をサポートしていますか?

主なサポート対象は text-serialized Unity assets の .unity、.prefab、.asset、.mat です。

Perforce や Unity Version Control と統合できますか?

はい。MergeSight は Git、Perforce、Unity Version Control / Plastic SCM、SVN repositories を検出し、Unity-aware review と 3-way merge workflows をすぐに有効にします。

独立したデスクトップ用マージツールはありますか?

いいえ。MergeSight には Unity Editor 内の UI と standalone .NET CLI library が含まれますが、独立した desktop mergetool app はありません。

Asset Store リリースの準備ができたら MergeSight を入手。

ローンチ情報、ドキュメント更新、MergeSight の提供状況を受け取るために email を登録してください。

短いフォームです。spam はありません。ローンチに関する重要な更新だけを送信します。