# デジタルツイン学習-R2R2R バックアップ構造の見直し

- 記録: LOG75（デジタルツイン学習-R2R2R（Real to Render to Real））
- 公開: 2026/2/20
- 記事のページ: https://pixelstomotors.com/record/day75
- サイト: Pixels to Motors（ADAPT DESIGN / 島津 栄一） https://pixelstomotors.com/
- 要約: Unityプロジェクトの「実験場の原則」に基づいた、R2R2R専用の復旧手順書。メタデータ保護を考慮した「Unity終了後のGit操作」や、シーン単位の破棄・再複製フローを詳説。AIエージェントによる自動生成と、人間による最終決定権を分離し、デジタルツイン実装における技術的負債とリスクを最小化する。

> AI が読むための記事の全文です（コード・実行ログを含む）。引用するときは上の「記事のページ」の住所を使ってください。

---

R2R2Rプロジェクトの運用憲法に基づき、Unityプロジェクトに不具合が生じた際の「迅速かつ安全な復旧手順」を策定しました。

現在のバックアップ構造（Git + Googleドライブ）を前提とした、最適なリカバリフローは以下の通りです。

##### ※注釈：デジタルツイン学習（R2R2R）の検証プロセス 本プロジェクトは、AIの判断を物理的動作へ変換する設計を検証するものです。現実空間をデジタルツイン化し、仮想空間での大量試行（Real-to-Render）から得た最適解を、実世界のモーター駆動（to-Real）へ還元する「R2R2Rパイプライン」の実装過程を記録・考察します。

## 推奨される復旧手順（リカバリ・プロトコル）

不具合の規模に応じて、以下の3段階で対応します。

### 作業単位の差し戻し（Git使用）

Clineによるコード変更や、小さな設定ミスが原因の場合、最も速い方法です。

-   **Unityを閉じる**: メタデータの競合を防ぐため必須です。
    
-   **Gitの状態確認**: `git status` で変更箇所を特定します。
    

**特定ファイルの復元**

-   `git checkout [ファイル名]` で、正常だった最新のコミット状態に戻します。
    

-   **全破棄（最終手段）**:
    

-   `git reset --hard HEAD` で、直近のコミット時点まで全ての変更をリセットします。
    

### シーン単位の復旧（Unity内作業）

「実験用シーン」での作業原則 を守っている場合、本番シーンは無傷のはずです。

-   不具合が出ている「実験用シーン」を破棄します。
    
-   バックアップ（または本番シーン）から再度「実験用シーン」を複製し、作業をやり直します。
    

### 完全復旧（Googleドライブ等の外部バックアップ）

Git履歴すら破損した場合や、大規模なアセット消失時の手順です。

-   現在のプロジェクトフォルダを「作業中\_OLD」などにリネームして退避させます。
    
-   Googleドライブから、正常に動作していたタイムスタンプのZIP（またはフォルダ）をローカルにダウンロードします。
    
-   Unity Hubから新しいパスとして追加し、動作確認を行います。
    

## 手順の適切性チェック（憲法との整合性）

提示された運用ルールに照らし合わせ、以下の通り評価します。

**チェック項目**

**判定**

**理由・補足**

物理憲法の遵守

適合

復旧後、直ちに `Stiffness: 20,000` / `Damping: 2,000` が維持されているか再確認が必要です。

役割分担の徹底

適合

復旧作業（Git操作・ファイル置換）は「ユーザー」が担当する領域であり、Clineに操作させてはいけません。

実験場の原則

適合

「実験用シーン」で作業していれば、復旧は「シーンの削除と再複製」だけで済むため、リスクが最小化されています。

履歴管理の活用

適合

Clineに出力させた「Gitコミット用の要約」 があれば、どのコミットまで戻すべきかの判断が容易になります。

## リスク検知とアドバイス

現在の体制で一点注意が必要なのは、「Unity特有のメタデータ (.meta)」です。

Gitで戻す際、`.meta` ファイルが欠落したり不整合を起こすと、インスペクター上の参照が外れて（Missing）プロジェクトが壊れる原因になります。

### **Geminiの論理チェック**

復旧作業を行う際は、必ず 「Unityを完全に終了させた状態」 でGit操作またはファイル置換を行ってください。起動したまま行うと、Unityの自動保存機能が復旧したファイルを上書きしてしまう恐れがあります。
