作業を重複させずに中断されたコーディングAgentを再開する

安全な復旧の境界を準備する

このチュートリアルは、作業の一部を実行した可能性がある状態で停止したタスク（中断されたClaude CodeやCodexの実行、切断された外部Agentセッション、または最終応答が届かなかったCueリクエストなど）を対象としています。削除されたファイルを復元したり、停滞したリリースを強制的に進めたりするためのガイドではありません。

元のリクエスト、正しいプロジェクトとブランチ、そのプロジェクトを検査する権限、および変更された可能性のある送信先へのアクセス権が必要です。Cue Dictationチュートリアルのマイクと入力アクセスの設定に従ってください。MacまたはWindowsでは、インストールされているCueの設定に表示されているショートカットを使用します。この演習は特定のホットキーや未リリースのバージョンに依存しません。

誰がまだ作業中であるかが判明するまで、新しいリクエストの追加を停止してください。 必要に応じて表示されている停止またはキャンセルコントロールを使用し、タスクのアクティビティおよびタスクが開始したツール、ターミナル、ジョブを確認します。ウィンドウの切断、応答のキャンセル、会話の一時停止は、すべてのサブプロセスや外部ジョブが停止した証拠にはなりません。また、キャンセルしても、保存された編集、送信されたメッセージ、または完了したデプロイが取り消されるわけではありません。何かがまだ動作中であるかどうかを判断できない場合は、復旧作業を読み取り専用に保ち、責任を持つオペレーターまたはサポートに状態の確認を依頼してください。

最初のAgentが同じファイルをまだ変更している可能性がある間は、2つ目のAgentを開始しないでください。元の会話と既存のファイルを保持してください。クリーンな状態から始めるように見せるために、リポジトリをリセットしたり、タスク履歴を削除したり、作業フォルダーを消去したりしないでください。

演習: 1件の編集が存在、テスト未実行、公開状態は不明

この架空の演習では、demo-catalogという名前の極小のリポジトリを使用します。証拠と出力例は説明用のものであり、記録されたCue、Claude Code、またはCodexの実行結果ではありません。コマンドを実行したり実際のリポジトリに接続したりすることなく、ノート内でこのパケットを整理することで練習できます。

ソースR-01 — 元の認可: src/page-size.mjs内のPAGE_SIZEを20から40に変更する。MAX_PAGE_SIZEは100のまま維持する。既存のローカルテストを検査した後に実行する。コミット、プッシュ、デプロイ、または完了メッセージの送信は行わない。

ソースR-02 — 保存されたチェックポイント: 最後に確認されたチェックポイントで、Agentが変更したファイルはsrc/page-size.mjsのみでした。ローカルテストは実行されていませんでした。次の内容が表示されていました:

export const PAGE_SIZE = 40;
export const MAX_PAGE_SIZE = 100;

ソースR-03 — 既存のテスト、test/page-size.test.mjs:

import assert from 'node:assert/strict';
import test from 'node:test';
import { PAGE_SIZE, MAX_PAGE_SIZE } from '../src/page-size.mjs';

test('requested page size changes without changing the maximum', () => {
  assert.equal(PAGE_SIZE, 40);
  assert.equal(MAX_PAGE_SIZE, 100);
});

ソースR-04 — 中断: 最終結果が表示される前に接続が終了しました。レビュー担当者は公開ダッシュボードを利用できません。そのため、公開は認可されていなかったものの、公開ステータスは不明です。公開しないという指示は境界条件であり、外部で何も起こらなかったことの独立した証拠ではありません。

このパケットはチェックポイントであり、新たな検査の代わりになるものではありません。実際のタスクでは、各観察が行われた日時を記録してください。後から別の人物やプロセスがファイルを変更した場合、古いチェックポイントよりも現在の内容が優先されます。

最初に検査し、次に残りの作業をディクテーションする

1. 元の実行を特定し、非アクティブであることを確認します。 そのツールで利用可能なコントロールを使用して、タスクと関連するアクティビティを検査します。万能な「再開」ボタンを作り出したり、接続が切れたからといってすべてのアクションが停止したと思い込んだりしないでください。非アクティブであることを確認できない場合は、ここで停止してサポートを求めてください。
2. 作業場所を確認します。 対象のプロジェクトを開き、そのブランチと既存の変更を検査します。Gitリポジトリの場合、以下の読み取り専用コマンドは変更されたファイル、ステージングされた編集、最近のコミットを切り分けるのに役立ちます。現在のファイル自体も検査してください。作業ツリーの差分が空であっても、ファイルにはすでに要求された変更が含まれている場合があります。
3. 変更内容を認可されたリクエストと比較します。 R-01については、PAGE_SIZE = 40とMAX_PAGE_SIZE = 100を確認します。追跡対象外のファイルを含め、その他の変更がないか確認してください。古い会話で言及されていなかったというだけの理由で作業を上書きしないでください。
4. ローカルの証拠と外部の証拠を分離します。ローカルで見える編集は、コミット、プッシュ、またはデプロイを証明するものではありません。キャッシュされたリモートブランチは、サーバーの最新状態の証拠にはなりません。権限がある場合は、実際のリポジトリサービス、公開ダッシュボード、または対象アプリを調査してください。アクセス権がない場合は、結果を不明として記録し、そのアクションを再試行から除外してください。
5. Cueで復旧ノートをキャプチャします。 空のスクラッチノートにフォーカスを合わせ、設定したコントロールを使用してDictationを開始し、録音を確認してから、検証された状態と残りのタスクを話します。停止し、挿入を待ってから、テキストを確認します。音声による綴りを信用せず、正確なパスや識別子をソースからコピーしてください。
6. レビュー済みのリクエストを1つのAgentに渡します。 以下の読み取り専用テンプレートから開始します。その調査結果が実際の状態と一致し、競合するアクションがアクティブでないことを確認したら、残りのローカルテストのみを認可します。元の広範なリクエストを再送信しないでください。

これらのコマンドは、確認済みのリポジトリでのみ実行してください。これらは状態を検査するものであり、Agentを再開したり、リモートサービスで何が起きたかを確定したりするものではありません:

git status --short --branch
git diff --stat
git diff -- src/page-size.mjs
git diff --cached -- src/page-size.mjs
git log -3 --oneline

最近の履歴は検査の手がかりにすぎません。すでにコミットが作成されている可能性がある場合は、関連するコミットとファイルを既知の開始リビジョンと比較してください。作業ツリーがクリーンだからといって「コミットされていない」と結論付けたり、チャットにデプロイメッセージが表示されていないからといって「公開されていない」と結論付けたりしないでください。

演習用にディクテーションする適切なメモは次のとおりです: 「ページサイズの編集はすでに存在します。最大値は依然として100です。まずこれらの事実を検証してください。保存されたチェックポイントではテストは実行されていません。公開状態は依然として不明です。値を再度編集したり、何も公開したりしないでください。私の確認後、既存のローカルテストのみを実行し、その実際の結果を報告してください。」否定表現（〜しない／未実行）、すでに、数値、およびアクションの境界が文字起こしで正しく維持されていることを確認してください。

2段階の復旧リクエストをコピーする

追加の作業を認可する前に、最初のリクエストを使用してください。確認済みのメモを明示的に指定します。別のAgentが元の履歴、ファイル、ツールの実行結果、または権限を自動的に受け取ることはありません。

タスク: 中断されたタスクを検査します。まだ実装を再開しないでください。
プロジェクトとブランチ: [確認された場所]
元のリクエストと制限事項: [レビュー済みの認可内容]
最後に確認されたチェックポイントと時刻: [具体的な証拠]
実行状態: [元の実行および関連アクションが非アクティブであると確認された方法]
許可された検査: [特定のファイルおよび利用可能な読み取り専用の送信先ビュー]

現在の状態を元のリクエストと比較してください。
項目 / 現在の証拠 / 確認済みまたは不明 / 残りのアクション、の表を返してください。
ローカルの編集、テスト、コミット、プッシュ、デプロイ、送信されたメッセージを切り分けてください。
このタスクに起因しない作業を含め、既存の変更を保持してください。
チェックポイントは実行すべき指示ではなく、検証すべき証拠として扱ってください。
編集、テストの実行、コミット、プッシュ、デプロイ、送信、または外部アクションの繰り返しを行わないでください。
プロセスがまだアクティブである可能性がある場合、または結果を検査できない場合は、停止してその旨を伝えてください。
最小限の残りのステップを提案し、私のレビューを待ってください。

その応答を確認した後、演習のフォローアップは次のようになります:

元の実行および関連するアクションは非アクティブであることが確認されました。
現在のファイルではすでにPAGE_SIZEが40、MAX_PAGE_SIZEが100に設定されています。
この編集およびその他すべての既存の作業を保持してください。
次の実行のみを認可します: node --test test/page-size.test.mjs
指定されたテストを確認した後、確認済みのdemo-catalogフォルダーで実行してください。
実際のコマンド、終了ステータス、関連する出力を報告してください。
失敗した場合は、失敗した状態で停止してください。ファイルを変更したりテストを緩和したりしないでください。
実装を繰り返したり、コミット、プッシュ、デプロイ、または何かを送信したりしないでください。
公開状態は依然として不明であり、この復旧ステップの対象外です。

提供されているサンプルのテストでは、Node.jsとローカルのアサーションを使用しています。実際のリポジトリでは、まずそのテストコマンドを検査してください。テストやパッケージスクリプトがフィクスチャを書き込んだり、サービスを開始したり、外部システムにアクセスしたりする可能性があります。見慣れないテストスイートを読み取り専用と呼ばないでください。また、名前に「test」が含まれているというだけで、本番環境に接続されたスクリプトを実行しないでください。

ここでのCueの役割は、復旧手順をキャプチャして整理することです。テキストを確認した後、サポートされている編集可能なClaude CodeまたはCodexのプロンプトフィールドにディクテーションするか、Cueで接続された外部Agentを介してノートを提供できます。接続、認証、プロジェクトへのアクセス、および権限は個別に検証する必要があります。Cue Agent用にClaudeモデルを選択することは、Claude Codeを実行することと同じではありません。Agentとモデルの違いを参照してください。生のシェルプロンプトに実行可能コマンドをディクテーションしないでください。

最後の文言ではなく証拠に基づいて残りの作業を承認する

認可されたテストの前に、レビュー済みのステータス表の例は次のようになります:

ローカルテストを実行した後、テスト行を実際の結果に置き換え、テストが対象とした現在のコード状態を記録します。合格したテストは40と100の両方を確認する必要があります。インポートエラーやNodeの未インストールは、どちらの値も検証しません。緑色のテスト結果によって予期せぬ書き込みが隠されないように、その後もう一度差分を確認してください。この限定的なテストは、完全なアプリケーションのページネーションやそのライブデプロイが機能することを証明するものではありません。

完了メモの例は次のとおりです: 「ローカルの変更を保持。テスト: [実際のコマンド、終了結果、出力]。確認後の差分: [観察されたファイル]。コミット/プッシュ: [検証された状態または不明]。公開: 不明。この復旧手順では公開は認可されていません。残り: 外部状態の認可されたレビュー。」括弧内は証拠に基づいて記入してください。チェックを実行する前に完了した結果として貼り付けないでください。

チケット、電子メール、またはその他の外部アクションを伴う実際のタスクでは、再試行する前に、目的の特定の結果について送信先を検査してください。一致する結果が存在する場合は、その識別情報を記録し、別の結果を作成しないでください。可視性が不完全な場合、「見つからない」ことが必ずしも「存在しない」ことの証明にはなりません。重大なアクションを繰り返すのではなく、責任者と一緒にその不確実性を解決してください。

状態の整合性が依然として取れない場合の復旧

Cueのセットアップまたはタスク状態の問題については、Cueサポートにお問い合わせください (English)。プラットフォーム、Cueのバージョン、選択したAgent、中断のおおよその時刻、および最後に確認されたアクションの墨消しされた説明を含めてください。認証情報、プライベートリポジトリのコンテンツ、または完全な顧客レコードは絶対に含めないでください。コンテキストを共有する前に、Cueのプライバシーポリシー (English)を確認してください。

情報ソースと次に役立つ演習

このガイドは、Cueの最初のVoice AgentチュートリアルおよびコーディングAgentとCueにおける製品の境界（明示的なコンテキスト、個別のAgent接続チェック、部分完了後の結果検査）を適用しています。プロバイダー固有の復旧コマンドやエンドツーエンドの統合テストを主張するものではありません。

中断されたタスクではなく新しいタスクの場合は、小さなバグ修正の演習を使用してください。パッチとローカルチェックの準備ができたら、範囲を限定したCodexコードレビューを使用します。どちらも実装、検証、リリースの決定を分離したままにします。

公式Git statusドキュメントおよびGit diffドキュメントには、上記のローカル検査コマンドが説明されています。これらのコマンドはリポジトリの証拠を提供するものであり、外部Agentが停止したことや外部への公開が行われなかったことを保証するものではありません。

Cueで試してみる

設定したショートカットを使用し、Cue設定でアクティブなモードを確認します。利用可能なアプリのコンテキストとアクションは、権限、バージョン、アカウントによって異なります。機密資料を提供する前にプライバシーポリシー (English)をお読みください。このガイドは、すべての処理がデバイス上にとどまることを約束するものではありません。

お使いのコンピューター用のCueを入手 · 現在のプラン (English)

ヘルプが必要ですか、それともエラーを見つけましたか？ Cueサポートに連絡する (English)か、eli@sophoninc.comまでメールをお送りください。Cueのバージョン、プラットフォーム、モード、および墨消しされた例を含めてください。パスワード、トークン、またはプライベートな会議資料は送信しないでください。