Orca SSH Worktree チュートリアル: Codex のリモート実行、ポート転送、携帯電話の承認

Orca によるこのチュートリアルは、タイトルにある特定のタスクのみを扱います。 Orca の SSH ワークツリーはエージェントの実行をリモート ホストに配置しますが、各タスクは引き続き独立したブランチにバインドする必要があります。モバイル バージョンは、指示のフォローアップと補足に適しており、差分、テスト、およびマージの承認をバイパスしないでください。

以下のすべての操作は、最初に、ループバックアドレスのみでリッスンするテストリポジトリ、テスト アカウント、またはサービスに配置されます。コマンド内のドメイン名、ユーザー名、パス、およびキーはプレースホルダーであるため、実行前に置き換える必要があります。

リモート Orca ワークフローのコンポーネントは何ですか?

このセクションでは、「リモート Orca ワークフローのコンポーネントは何ですか?」について説明します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

Orca の場合、判断基準は次のとおりです。Orca の SSH ワークツリーはエージェントの実行をリモート ホストに配置し、各タスクは独立したブランチにバインドされている必要があります。携帯電話はフォローアップや補足的な指示に適しており、差分、テスト、マージの承認をバイパスしないでください。この段階で誤ってさらに許可を開かないでください。

1
2

git remote -v
git worktree list

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

SSH キーとホストのフィンガープリントが最初に処理されます

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

ssh-keygen -F builder.example.com

ここでの完了基準は、インターフェイスが表示されることではなく、「SSH キーとホストのフィンガープリントが最初に処理され」、再現可能な結果が得られることです。

エージェントごとに独立したワークツリーを作成する

1

git worktree add ..\task-a -b agent/task-a

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

リモート ディレクトリはローカルの倉庫にどのように対応するのでしょうか?

「リモートディレクトリとローカルウェアハウスの対応関係」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

ssh user@builder 'pwd && git status --short'

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

Codex タスクを開始する前にベースラインを保存します

このセクションでは、「Codex タスクを開始する前にベースラインを保存する」という問題を解決します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

Orca の場合、判断基準は次のとおりです。Orca の SSH ワークツリーはエージェントの実行をリモート ホストに配置し、各タスクは独立したブランチにバインドされている必要があります。携帯電話はフォローアップや補足的な指示に適しており、差分、テスト、マージの承認をバイパスしないでください。この段階で誤ってさらに許可を開かないでください。

1
2

git rev-parse HEAD
git status --short

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

タスクに必要なポートのみを転送します

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

ssh -L 3000:127.0.0.1:3000 user@builder

ここでの完了基準は、インターフェイスが表示されることではなく、「タスクに必要なポートのみを転送する」ことで再現可能な結果が得られることです。

携帯電話でできること、してはいけないこと

1

git log --oneline -5

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

複数のエージェントが同じファイルを変更した場合の対処方法

「複数のエージェントが同じファイルを変更した場合の対処方法」を中心に、成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

git diff agent/task-a...agent/task-b

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

直接混合するのではなく、候補ブランチを比較します

このセクションでは、「直接混合するのではなく、候補ブランチを比較する」について説明します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

Orca の場合、判断基準は次のとおりです。Orca の SSH ワークツリーはエージェントの実行をリモート ホストに配置し、各タスクは独立したブランチにバインドされている必要があります。携帯電話はフォローアップや補足的な指示に適しており、差分、テスト、マージの承認をバイパスしないでください。この段階で誤ってさらに許可を開かないでください。

1

git diff --stat main...agent/task-a

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

リモートホストでテストとレビューを実行する

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

ssh user@builder 'npm test'

ここでの完了基準は、インターフェイスが表示されることではなく、「リモート ホスト上でテストとレビューを実行する」ことで再現可能な結果が得られることです。

マージ後に Worktree を安全に削除する

1
2

git worktree remove ..\task-a
git branch -d agent/task-a

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

切断、孤立したプロセス、および回復

「切断・孤立プロセス・復旧」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

ssh user@builder 'ps aux | grep -E "codex|claude|pi"'

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

リモートのディスク容量不足を事前に検出する

このセクションでは、「リモートのディスク容量不足を事前に検出する」という問題を解決します。まず現在の状態を記録し、次に最小限のアクションを実行し、最後に独立した証拠で結果を確認します。

Orca の場合、判断基準は次のとおりです。Orca の SSH ワークツリーはエージェントの実行をリモート ホストに配置し、各タスクは独立したブランチにバインドされている必要があります。携帯電話はフォローアップや補足的な指示に適しており、差分、テスト、マージの承認をバイパスしないでください。この段階で誤ってさらに許可を開かないでください。

1

ssh user@builder 'df -h'

実行後にコマンド出力とタイムスタンプを保持します。出力が現在のターミナルの一時変数に依存している場合は、新しいターミナルを開いて再度確認してください。

転送ポートはローカル ループバックにのみバインドされます

次の順序で処理します。

1. 実際のバージョンと現在の構成を読み取ります。
2. このセクションに関連する設定を 1 つだけ変更します。
3. 読み取り専用または取り消し可能なリクエストを実行します。
4. ログ、終了コード、および最終ファイルを確認します。
5. 失敗した場合は、以前の変更を元に戻します。

1

ssh -L 127.0.0.1:3000:127.0.0.1:3000 user@builder

ここでの完了基準は、インターフェイスが表示されることではなく、「転送ポートがローカル ループバックにのみバインドされている」ことで再現可能な結果が得られることです。

候補ブランチの提出 ID を確認する

1

git log --format='%h %an <%ae>' -5

表に停止信号が表示されたら、まずこのセクションの変更を元に戻し、後続の自動化を続行しないでください。

Worktree を削除する前にコミットされていない変更を保存する

「ワークツリーを削除する前にコミットされていない変更を保存する」を中心に成功サンプルと失敗サンプルを用意します。成功したサンプルでは通常のパスが検証され、失敗したサンプルでは制限が実際に有効かどうかが検証されます。

1

git -C ..\task-a status --short

以下の4項目を記録することをお勧めします。

• 実行前バージョンまたは Git コミット。
• 実際の入力。秘密の値は記録されません。
• 観察可能な出力、ステータス コード、または差分。
• 回復アクションと回復後の結果の確認。

失敗の原因がまだ不明な場合は、一度に 1 つの変数のみを変更してください。ポート、ランタイム、プロバイダー、およびプロキシを同時に変更しないでください。

オルカのよくある質問

テスト環境をスキップして、Orca を公式プロジェクトで直接使用することは可能ですか?

お勧めしません。まず、少なくとも 1 つの最小限の成功リクエスト、1 つの意図的な失敗、および 1 つの回復訓練を完了します。

Orca コマンドは実行できますが、結果が正しくありません。最初にどこを確認すればよいですか?

まず入力範囲、実際の有効構成、および上流の応答を確認し、次にモデルの概要を確認します。プロセスが正常であっても、ビジネス結果が正しいとは限りません。

Orca キーまたはトークンが Git に入るのを防ぐにはどうすればよいですか?

システム環境変数、シークレット管理、またはプロジェクト外部の構成ファイルを使用し、コミットする前に差分を検索します。侵害が発見された後は、キーをローテーションする必要があります。

Orca をアップグレードするときに見逃しがちなことは何ですか?

最も見逃しやすいのは、構成形式、デフォルトのリスニング アドレス、アクセス許可の範囲、キャッシュの互換性です。アップグレードする前に、バージョンと検証サンプルを保存してください。

Orca の受け入れに関する問題

完了すると、次の質問に答えられるようになります。

• 正確にどのバージョンを使用していますか?
• どのディレクトリ、ポート、アカウント、外部サービスにアクセスできますか?
• 成功結果を元のデータまたは Git diff に戻すにはどうすればよいですか?
• アップストリームに障害が発生した場合、エラーが報告されるか、再試行されるか、または切り替えられますか?
• キーがログまたは履歴に表示される可能性はありますか?
• 10分以内に修正前の状態に戻すにはどうすればよいですか?

これらのいずれかに回答できない場合、Orca はまだ試用段階にあるため、権限を拡張したり、運用自動化を利用したりすべきではありません。