こんにちは、Unityエンジニアのオオバです。
AIにUnityの作業を任せていると、ファイルを直接書き換えたくなる場面があります。
Prefabにコンポーネントを足して参照をつなぐ作業は、YAMLを書き換えれば一瞬で終わりそうに見えますよね。
僕もAIにPythonとsedでPrefabのテキストを編集させ、そのまま進めました。
Unityを開いたままテキストで編集すると巻き戻る。AIにはエディタスクリプトで編集させる
結論から言うと、Unityを開いたままファイルを直接書き換えるのは避けたほうがよいです。
Unityは、メモリ上に読み込んでいるアセットを、自分の内容で保存し直すからです。
なので、PrefabやScriptableObjectの編集は、エディタスクリプトを通してUnityに保存させるのが安全でした。
起きたこと
Unityエディタを開いたまま、AIに .prefab をPythonとsedでテキスト編集させました。
編集の内容は、コンポーネントの追加と参照の配線です。
コンパイルもテストも通りました。
ところが、PlayModeで確認すると参照がnullのままでした。
しかも、ディスク上の差分まで消えていました。 git diff を見ると、何も出てこない状態です。
別の日には、もっと厄介なことが起きました。
SmartAddresserの設定アセット(LayoutRuleData.asset)のYAMLを直接書き換えたところ、開いたままだった Layout Rule Editor ウィンドウの古い状態で上書きされました。
追加したフォルダ指定が別グループのフィルタにずれてしまい、500件以上のアセットが別のグループへ移りました。
原因:Unityはメモリ上の内容で保存し直す
Unityは、メモリに読み込んでいるアセットを、compile、PlayModeへの切り替え、ウィンドウの保存といったタイミングで再保存します。
外部から書き換えたテキストは、Unityのメモリ側には反映されていません。
そのため次の再保存で、メモリ上の古い内容がディスクへ丸ごと書き戻されます。
Prefabの参照が消えたのも、設定アセットがずれたのも、同じ仕組みでした。
設定系のアセットは、開いているエディタウィンドウが状態を持っています。
つまり、テキストで正しく直しても、Unityに上書きされて消えるということ。
解決:エディタスクリプトで編集させる
Prefabは「読み込む、足す、保存する」の順番で
Prefabは、次の順番でエディタスクリプトから編集させるようにしました。
PrefabUtility.LoadPrefabContentsでプレハブをメモリに読み込むAddComponentでコンポーネントを追加するSerializedObjectを使って参照を入れるPrefabUtility.SaveAsPrefabAssetで保存するPrefabUtility.UnloadPrefabContentsで後片付けをする
AIには、このスクリプトを uLoopMCP の execute-dynamic-code で実行させています。
設定系のScriptableObjectは、ウィンドウを閉じてから
設定系のScriptableObjectは、手順が少し違います。
まず、関連するエディタウィンドウを閉じます。
次に、AssetDatabase で読み込んだオブジェクトを書き換えて、EditorUtility.SetDirty の後に AssetDatabase.SaveAssets で保存します。
補足・注意点
保存したら、次の2つを確認すると安心です。
git diff --statで、変更がディスクに反映されているかを見る- PlayModeで、参照が入っているかも見る
SaveAsPrefabAsset には癖があります。レイアウトの再計算で、無関係な m_SizeDelta の差分を混ぜることがあるんです。
単一の値を変えるだけなら、そのプレハブをメモリで開いていない状態でYAMLを書き、AssetDatabase.ImportAsset を ImportAssetOptions.ForceUpdate 付きで呼ぶと、差分が最小になりました。
ただし、この方法はそのプレハブをUnityで開いていないことが前提です。
まとめ
今回のポイントをまとめます。
- Unityを開いたままファイルを直接書き換えると、メモリ上の古い内容で巻き戻る
- Prefabは読み込み・追加・保存・解放の順にエディタスクリプトで編集する
- 設定系のScriptableObjectは関連ウィンドウを閉じてから書き換えて保存する
- 保存後はgit diff --statとPlayModeで反映を確認する
- 単一値の変更ならImportAssetで差分を最小にできる
AIに任せる範囲が広がるほど、テキストで直接いじりたくなる場面は増えると思います。
それでも、Unityが管理しているアセットは、Unityの中で編集させるのが結局いちばん確実でした。

筆者のXをフォローしよう
- Unity 6000.3






