> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/reby/how-deep-review-works.md).

# Deep Reviewの仕組み

Deep ReviewはAikidoのエージェント型プルリクエストレビュアーです。差分を全体像として扱うのではなく、Aikidoは関連コードを探索し、変更のより広い影響を推論し、フィードバックをプルリクエストに直接投稿します。

対象は **セキュリティと品質の両方**。アクセスチェックの不足や、大きな結果セットでページネーションを壊すリファクタリングなど、問題がこのプルリクエストの影響に現れる限り検出できます。

## Deep Review と他の PR チェックの比較

プルリクエストには、すでに複数の Aikido チェックからコメントを受け取ることができます。それらは異なる質問に答えます。

| 確認                                                                                                                                                                                         | 確認対象                         | 頻度          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------- |
| [SAST](/docs/docs-ja/kdosukyan/scanning-practices/sast-by-aikido-supported-languages-and-security-focus.md) で [PR gating](/docs/docs-ja/prtorirsugtingu/aikido-ci-gating-functionality.md) | 差分上の既知のセキュリティパターン            | 有効化後は新規コードで |
| [コード品質](/docs/docs-ja/kdo/code-quality-overview.md)                                                                                                                                        | 変更行に対する品質ルール                 | 有効化後は新規コードで |
| ディープレビュー                                                                                                                                                                                   | 差分を超えた文脈を含む、変更のセキュリティと品質への影響 | PRごとのクレジット  |

Deep ReviewはSASTやコード品質の代わりにはなりません。それらは PR チェックで有効にし、すべてのコミットでオンにしておいてください。差分だけではなく、より多くの文脈が必要な複雑な問題を見つけたいときに Deep Review を使ってください。

全体像は次を参照してください [どのAikido製品を使うべきですか？](/docs/docs-ja/hajimeni/which-aikido-product-should-i-use.md).

## 差分を超えた文脈

差分は何が変わったかを示しますが、その変更がアプリケーションの他の部分とどのように関わるかまでは、常に示すとは限りません。Deep Review は、コメントするかどうかを判断する前に、変更行の外側から関連する文脈を取り込みます。そのため、コードベースの別の場所にある既存の動作に依存する変更もレビューできます。

## リポジトリをまたぐ文脈

アプリケーションが複数のリポジトリにまたがる場合は、 [関連リポジトリをリンクできます](/docs/docs-ja/reby/link-repositories.md) レビュー対象のリポジトリに。すると Deep Review は、共有ライブラリ、API、サービスについて推論する際に、それらのリポジトリを追加の文脈として使用できます。

リンクできるリポジトリ数は Aikido プランによって異なります。

## プルリクエスト内でのフィードバック

Deep Review に共有するフィードバックがあると、Aikido はコメントをプルリクエストに直接投稿します。結果を見るため、または議論するために、既存のレビューの流れを離れる必要はありません。

Deep Review は独自のステータスチェック（**Aikido Security: Deep Review**）も投稿します。そのチェックが失敗するかどうかは、セキュリティレビューと同じ [ゲーティング設定](/docs/docs-ja/reby/configure-deep-review.md#pr-check-gating) に従います。つまり、失敗しきい値、 **常に合格**、および **PR チェックを常にグリーンにする**.

コメントで指摘された問題を修正すると、Aikido はそのコメントを自動的に解決済みにします。 [問題修正後に Aikido がコメントをどう管理するかを学ぶ](/docs/docs-ja/prtorirsugtingu/aikido-ci-gating-functionality/autofix-suggestions-and-inline-commenting-for-pr-checks.md#what-happens-to-comments-after-you-fix-an-issue).

### 自然言語で返信

Deep Review のコメントには、平易な言葉で返信できます。Aikido をタグ付けしたり、特別なコマンド形式を使ったりする必要はなく、Aikido の UI に切り替えずにプルリクエスト内に留まれます。

| あなたの発言              | 例                             | ステータス                                                                |
| ------------------- | ----------------------------- | -------------------------------------------------------------------- |
| **検出結果を無視**         | 「これは誤検知なので、無視してください。」         | 今すぐ利用可能です。Aikido はその検出結果を無視します。                                      |
| **背景を共有する、または反論する** | 「サーバー側で検証しているので、これは意図した動作です。」 | 今すぐ利用可能です。Aikido はこのフィードバックを今後のレビュー改善に活用します。レビュー間で共有されるメモリは近日提供予定です。 |
| **説明を求める**          | 「なぜこれが問題なのか説明してもらえますか？」       | 近日公開                                                                 |
| **追加対応を依頼**         | 「より安全な代替案を提案してください。」          | 近日公開                                                                 |

## パスとファイルを除外

Aikido は標準で、多くのパスをすでに無視します。Deep Review は、依存関係フォルダ、ビルド出力、生成ファイル、ロックファイル、バイナリ、メディアなどの一般的なノイズをスキップするため、通常は追加設定は不要です。

さらに多くのパスを除外するには [`.aikido` ファイル](/docs/docs-ja/kdosukyan/scanning-practices/ignore-via-code-with-aikido-files.md)を使えます。Deep Review はそれらの除外済みパスも考慮します。

プルリクエストで変更されるのが除外対象ファイルのみの場合、Aikido は Deep Review をスキップし、課金もされません。

## クレジット

Deep Review の料金は **プルリクエスト 1 件につき 1 クレジット**です。同じ PR に対する追加レビュー（たとえば新しいコミット後など）に追加料金はかかりません。クレジットがなくなると、Deep Review はスキップされます。

次の設定もできます [月間支出上限](/docs/docs-ja/reby/configure-deep-review.md#set-a-monthly-spending-limit) を Deep Review について [ウォレット設定](https://app.aikido.dev/settings/wallet/settings)で設定できます。上限に達すると、クレジットを消費する Deep Review は翌暦月までスキップされます。

{% hint style="info" %}
チームで Deep Review を使うといくらか気になりますか？当社の [見積もりツール](https://app.aikido.dev/repositories/deep-review) は、直近 30 日間の利用状況に基づいて目安を示します。
{% endhint %}

方法を学ぶ [Deep Review を設定する](/docs/docs-ja/reby/configure-deep-review.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/reby/how-deep-review-works.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.