Deep Reviewの仕組み

Deep Reviewは、Aikidoのエージェント型プルリクエストレビュアーです。差分だけを全体像とみなすのではなく、Aikidoは関連するコードを調べ、変更が及ぼすより広い影響を推論し、そのフィードバックをプルリクエストに直接投稿します。

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

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

プルリクエストには、すでに複数のAikidoチェックからコメントが付くことがあります。それぞれが答える問いは異なります。

Deep ReviewはSASTやCode Qualityの代わりではありません。これらはPR Checksで有効にし、すべてのコミットでオンにしておいてください。差分以上のコンテキストが必要な複雑な問題を見つけたいときにDeep Reviewを使ってください。

全体像は どの Aikido 製品を使うべきですか？.

差分を超えたコンテキスト

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

リポジトリの指示

Deep Reviewのチェック AGENTS.md, CLAUDE.md, .claude/、および .cursor/ 受け入れ済みのリスクについて。そのファイルがすでに受け入れているリスクは、プルリクエストがそのリスクを拡大しない限り、報告されません。

常設のガイダンスを記載してください AGENTS.md リポジトリのルートに: 信頼境界、意図した動作、および受け入れ済みのリスクを。参照 リポジトリファイルでエージェントをガイドする.

Aikido も構築します メモリ プルリクエストへの返信から。使用 AGENTS.md ガイダンスを自分で書きたい場合に。

リポジトリをまたぐコンテキスト

アプリケーションが複数のリポジトリにまたがる場合は、 関連するリポジトリをリンク して、レビュー対象のリポジトリに追加できます。するとDeep Reviewは、共有ライブラリ、API、サービスについて推論する際に、それらのリポジトリを追加コンテキストとして利用できます。

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

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

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

Deep Reviewは独自のステータスチェック（Aikido Security: Deep Review）も投稿します。そのチェックが失敗するかどうかは、同じ ゲーティング設定 をセキュリティレビューと同じように扱います。失敗判定のしきい値、 常に合格、および PRチェックを常に成功にする.

コメントで指摘された問題を修正すると、Aikidoはそのコメントを自動で解決済みにします。 問題を修正した後にAikidoがコメントをどう管理するかを確認する.

自然言語で返信する

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

パスとファイルを除外する

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

さらに多くのパスを .aikido ファイルで除外できます。Deep Reviewはそれらの除外パスも尊重します。

プルリクエストが除外されたファイルのみを変更している場合、AikidoはDeep Reviewをスキップし、料金は発生しません。

クレジット

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

また、 月間利用上限 をDeep Review向けに Wallet設定で設定できます。上限に達すると、クレジットを消費するDeep Reviewは翌暦月までスキップされます。

方法を学ぶ Deep Reviewを設定する.