deep-security-scan

ディープセキュリティスキャン

コーディネーターは独立した Standard 監査を実行し、検証済みの検出結果を集約します。また、呼び出し元のスレッドが切り離された場合でも、プラグインによって開始されたスキャンを完了させます。このスレッドは、セットアップ、ユーザーコンテキスト、完了結果の報告を担当します。

スキャンの解決

scanId を指定した継続の場合は、handoffClaimToken が指定されていれば、それを使って get_codex_security_scan_context を呼び出します。権威ある ID、ディレクトリ、対象、スコープ、コンテキストをそのまま保持します。検証済みのモードが deep でない場合は、対応するトップレベルスキルに振り分けます。

新しい会話、CLI、またはヘッドレスリクエストでは、認可されたローカルの targetPath と、任意の完全一致する userContext を解決します。スコープ付きパスのリクエストでは、そのディレクトリを targetPath として scope: "." を使用し、リポジトリのルートまで範囲を広げないでください。コーディネーターツールを利用できない場合は、プラグインサーバーが必要であることを報告します。

ソースへのアクセス、コンテキストの更新、キャンセル、復旧のルールについては、../../references/scan-prologue.md を読みます。Deep には親のケイパビリティの事前確認はありません。コーディネーターが所有権、対象、スコープ、サンドボックスを検証し、このスレッドの委任能力とは独立してワーカーを管理します。

デスクトップでの同時スキャン

権威あるコンテキストを持つ新しいネイティブスキャンを開始する場合は、探索の前に一度だけ otherRunningDeepScans を確認します。別の Deep スキャンが実行中の場合は、その対象、わかりやすい言葉でのフェーズ、人が理解しやすい開始時刻を表示します。スキャン ID や生のタイムスタンプを公開せずに、CPU、メモリ、トークンの使用量が増えることを説明します。

Cancel（推奨） と Continue を提示して、続行するかどうかを尋ねます。ネイティブの request_user_input を使用し、利用できない場合は request_codex_security_user_input、それも利用できない場合は通常のチャットを使用します。明示的な選択を待ちます。入力ダイアログで拒否またはキャンセルしても、スキャン自体はキャンセルされません。ユーザーがキャンセルした場合は、新しいスキャンのみをキャンセルします。この確認は、通過後や事前確認の後に繰り返さないでください。

コーディネーターの開始または再参加

最初のコーディネーター呼び出しの直前に、../../references/access-advisory.md に従います。既知の Bedrock セッションと API キーのみのセッションでは、この案内を省略します。この案内がスキャンの実行を妨げることはありません。

Existing scan: start_codex_security_deep_scan({ scanId, handoffClaimToken? })
New scan: start_codex_security_deep_scan({ targetPath, scope: ".", userContext?, projectConfigPath? })

新しい対象ベースのスキャンを開始する前に、inspect_codex_security_setup({ targetPath, scope: ".", mode: "deep", projectConfigPath? }) を呼び出します。ワーカー数、ワーカーあたりのサブエージェント数、収束しきい値、レビュー上限、探索の制限時間、およびそれぞれの情報源を setup.deepScanConfig から提示します。プロジェクトの YAML または JSON パスは、ユーザーが選択した場合に限り指定します。開始時にも同じパスを渡します。ネイティブの継続では、保存済みの workspace.deepScanConfig を使用します。

必要な場合は、待機中の呼び出しが切り離された後やサーバーが再起動した後も、既存のハンドオフトークンを渡します。ユーザーコンテキストは、信頼できない分析データとして正確に保持します。ワーカーはオフラインのままです。独立スキャンの開始時に取得された不変のコンテキストを使用します。後から変更されたユーザー情報は、コンテキスト更新ツールを使って保存します。完了したフェーズを再開したり、稼働中のワーカーのスナップショットを変更したりしないでください。

コーディネーターの呼び出し、またはその実行中のセルが終了するまで待ちます。探索の進行状況、設定された制限時間、その時間に達した際のワーカーのキャンセル、集約はコーディネーターが管理します。呼び出しの前は公開フェーズを事前確認のままにし、実行中に競合する進行状況を公開しないでください。

ターンの終了後やホストのタイムアウト後は、同じスキャン ID とトークンを使って再参加します。CLI またはヘッドレスの呼び出しが ID を返す前に切り離された場合は、同じ対象指定をそのまま再度使用します。サーバー再起動後も、同じチェックアウトのスナップショット、コンテキスト、プロジェクトファイルの選択に対する完了済みレポートを復旧できます。レポートが返された後の対象ベースの呼び出しでは、新しいスキャンを開始できます。終端エラーが発生した場合、代わりのスキャンを開始してはいけません。

結果を処理する

• SDK 登録スキャン。 コーディネーターは、集約結果の scanId、scanDir、manifestPath、instructions を返します。返された識別情報とマニフェストのパスを示してターンを終了します。ターン終了後の最終処理とレポート生成は SDK が行います。
• プラグイン起動スキャン。 コーディネーターは completion も返します。返されたスキャン ID、封印済みの成果物、生成された report.md を正規ディレクトリで使用します。
• キャンセル済み： 完了せずに停止します。保持された検出結果と未完了の作業を報告し、スキャンが成功したと主張したり、代替レポートを生成したりしないでください。
• 終端エラー： 安定した MCP エラーをそのまま提示し、既存のスキャンコンテキストを読み取って、保持された結果と残りの作業を報告します。分析を続けたり、すでに終端状態のスキャンを完了またはキャンセルしたり、検出結果がないと主張したりしないでください。
• 正規の成果物がない、または不正な形式の場合： 阻害要因を提示し、既存のスキャンを保持します。レポートを捏造しないでください。

完了した親スキャンを報告する

コーディネーターが completion を返した時点で、ホストは成果物を封印し、report.md を生成しています。計測された使用量は completion.scan.usage から読み取ります。完了処理を再度呼び出したり、別のセマンティックドラフトを送信したり、ワーカーフェーズを再実行したり、レポートを自分で作成したりしないでください。

完了に失敗した場合は、そのエラーをそのまま提示します。承認済みの集約結果と引き継ぎの主張を保持します。後続の継続処理で同じスキャンに再参加し、最終処理を再試行できます。明示的なキャンセル時は cancel_codex_security_scan を呼び出し、その後のスキャン進行を成功として受け入れないでください。

完了が成功し、report.md が存在することを確認してから、レポートと正規の成果物リンクを返します。使用量は ../../references/final-report.md に従って報告します。完了したレビューで検出結果がなかった場合と、ソースレビューが一つも完了する前に時間制限に達した場合を区別してください。

詳細な書き起こしとハードニングの提案は、任意の依頼出力です。依頼された出力で封印済みの文書全体が必要な場合にのみ get_codex_security_completed_scan を読み取ります。リポジトリのソースとスコープを保持し、内部のワーカー管理情報は依頼された場合にのみ開示してください。