> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ultra Review エージェント

Ultra Review は Qoder の次世代コードレビュー機能です。従来の一括レビューとは異なり、レビューを複数の独立したディメンションに分解して並行実行し、結果をマージ・重複排除することで、S/N 比が高く、問題箇所をより正確に特定する構造化レポートを出力します。

## コア機能

* **多次元並行レビュー**：要件の網羅性、コーディングの正確性、変更の影響範囲を同時に評価し、1 回のレビューでカバー
* **厳格な検出基準**：各検出項目は「確定的な問題（推測ではない）」「今回の変更によって導入」「引用可能な証拠がある」の 3 条件を同時に満たす必要があり、推測的・無関係な問題をフィルタリング
* **正確なコード位置特定**：すべての問題が具体的なファイルと行番号に紐づけられ、証拠スニペットと実行可能な修正提案を付記
* **重大度による分類**：Critical（修正必須）/ Warning（修正推奨）/ Suggestion（検討推奨）の 3 段階で分類出力
* **単一障害点耐性**：特定のディメンションが対象範囲の特性により結果を出せない場合でも、他のディメンションの結論は正常に返され、レポートに欠落項目として記載

## 3 つの並行視点

Ultra Review はレビューを 3 つの独立したディメンションに分解して並行実行します。各ディメンションは 1 つの観点のみに集中し、ディメンション間の干渉や深度の希薄化を防ぎます：

* **Completeness（要件の網羅性）**：変更は要件の意図を本当に実現しているか？受け入れ基準、API コントラクト、状態分岐がすべてカバーされているか、漏れや半実装のロジックがないか。
* **Correctness（コーディングの正確性）**：ロジックの欠陥、null ポインタと境界外アクセス、エラー処理とエッジケース、並行処理とリソースリーク、明らかなセキュリティまたはパフォーマンスリスク。
* **Impact（変更の影響範囲）**：今回の変更で導入された副作用（グローバル状態、IO、並行処理、ライフサイクル hooks）、および既存コントラクトへの破壊的変更（API、デフォルト値、スキーマ、後方互換性のある設定）。

3 つのディメンションの検出結果は統一されたマージと重複排除を経ます。同じコード箇所に該当する問題は 1 件に統合され、証拠が最も充実したものが保持されます。

## レビュー範囲

`/ultra-review` はデフォルトで以下の範囲をレビューします：

1. 未コミットのコード変更（staged と unstaged の両方）を優先的にレビュー
2. 未コミットの変更がない場合、直近のコミットに自動的にフォールバック
3. コミットハッシュ、ファイルパス、Pull Request、コードスニペットなど、ターゲットを明示的に指定することも可能

## 使い方

Ultra Review は Qoder に組み込まれており、追加設定は不要です。入力ボックスでスラッシュコマンド `/ultra-review` を使用し、必要に応じてレビュー範囲を指定してください。

<Note>
  Ultra Review は現在、Quest window のエージェントモードでは利用できません。
</Note>

## ベストプラクティス

大規模な変更の場合は、モジュールごとまたはコミットごとにバッチでレビューすることで、より詳細なフィードバックが得られます。

変更に特定のビジネス背景や暗黙の制約が含まれる場合は、リクエストにコンテキストを簡潔に説明すると、より的確なレビュー結論が得られます。