メインコンテンツへスキップ
Devin Review は、プルリクエスト内の関連する変更をグループ化して diff と並べて解説し、潜在的なバグやセキュリティ上の問題を指摘します。チームで自動レビューを有効にしなくても、個別の PR に対してレビューをリクエストできます。

プルリクエストをレビューする

PRコメントからレビューを開始する

  1. GitHub のオープンなプルリクエストまたは GitLab のマージリクエストに、/devin review という新しいコメントを投稿します。
  2. Devin の返信に記載されたリンクを開きます。概要を読んだら、関連する変更のグループを開き、それらがどのように連携しているかを確認します。
  3. 分析サイドバーまたは バグ ビューで検出結果を選択し、コードと照らし合わせて確認します。さらに前提情報が必要な場合は、その検出結果をチャットに引用します。コードは自身で修正することも、Devin に編集を依頼することもできます。
このコマンドは会話コメントとインラインコメントのどちらでも使用できます。Git アカウントを Devin にリンクし、Devin 組織がそのリポジトリにアクセスできることを確認してください。 /devin review は分析をリクエストするコマンドです。一方、/devin fix the failing test のようなコメントは、Devin セッションに PR 上での作業を依頼します。GitHub については PRコメントからDevinを起動を、GitLab については MR コメントから Devin を起動を参照してください。

レビューを開くその他の方法

  • Devin から: Devin Review を開き、自分が作成した PR、自分に割り当てられた PR、またはレビューを依頼された PR を選択します。PR リンクのフィールドに PR の URL を貼り付けることもでき、GitHub Enterprise や Azure DevOps の PR にも対応しています。GitHub.com の PR の場合は、https:// を省略したり、owner/repo#123 の形式を使用したりできます。
  • GitHub.com から: PR の URL の github.com を devinreview.com に置き換えます。公開 PR は Devinアカウントがなくても閲覧できます。非公開 PR の場合は、アクセス権のあるアカウントでサインインしてください。
  • Devin セッションから: PR カードの Analyze を選択します。カードに Analyze once と Analyze の両方が表示されている場合、1 回だけレビューするには Analyze once を選択します。Analyze を選択すると、この PR への今後のプッシュでも自動的にレビューが行われるようになります。
その他の Gitホストについては、サポートされているGitプロバイダーを参照してください。 Review 一覧では、オープンなPRごとに CI failing、Changes requested、Review required、Ready to merge などの現在の状態が表示されます。幅の広い画面 (1280px 以上) では、PR を選択すると一覧の横のペインに表示され、別の PR を選択するとペインの内容が切り替わります。ペインは、ページを再読み込みするか、ページから移動すると閉じます。Cmd キーまたは Ctrl キーを押しながらクリックすると、PR を新しいブラウザタブで開けます。 一覧では、j または k で次または前の PR を選択し、o または l でペインに開き、Enter でレビューページ全体を開きます。PR で許可されている場合は、a で承認して次の PR に進み、m で PR をマージするかキューに追加して次に進みます。これらの一覧用ショートカットは、PR ページのショートカットとは異なります。

Devin Review の動作例

レビューの読み方

まず概要を読み、PR によって挙動がどう変わるのかを把握します。Guide view では、diff をグループ単位で読み進めます。1 つのグループには、複数のファイルにまたがる関連した編集がまとめられることがあります。コードのコピーや移動を検出した場合、Devin はそれを削除と同一内容の追加としてではなく、移動として表示します。 Bug Catcher の検出結果は、分析サイドバーまたは バグ ビューに表示されます。チャットで PR について質問すると、コードベースの他の部分から関連する前提情報を踏まえた回答が得られます。また、diff ビュー内の任意のコメント、バグ、フラグから直接 Devin に質問することもできます。 モバイルでは、レビューは Changes タブで開きます。バグ、フラグ、セキュリティに関する finding を確認するには バグ に切り替えてください。PR のその他の詳細は Description、Discussion、Commits で確認できます。 GitHub のコメントやレビューへのリンクを Devin Review で開くと、対象の箇所までスクロールしてハイライト表示されます。これは Devin セッション内のレビュータブでも同様に動作し、PR の diff に含まれるファイルへの GitHub リンクを開くと、そのファイルが表示されます。 最後のレビュー以降にコミットがプッシュされ、それらをレビューするルールがない場合は、Devin hasn’t analyzed the latest changes バナーに、最後にレビューされたコミットと新しいコミットの数が表示されます。Analyze latest を使うと、自動レビューを有効にしないまま、現在のコミットをもう一度だけレビューできます。Analyze automatically を使うと、このプルリクエスト、あなたが作成するすべてのプルリクエスト、またはリポジトリのレビュー設定を管理する権限がある場合はリポジトリ内のすべてのプルリクエストに対して、自動レビューを有効にできます。Devin セッション内のレビュータブでは、See changes で最後のレビュー以降にプッシュされた内容を確認できます。 新しいレビューが利用可能になった場合、New commit を選択すると、レビューを開いている間にプッシュされたコミットに切り替わります。View latest commit を選択すると、Review が既に把握していたコミットの新しい diff に切り替わります。New analysis を選択すると、表示中のコミットはそのままで分析が更新されます。
  • ファイルを Viewed にすると進捗を追跡できます。ファイル一覧から、すべてのファイルを閲覧済み・未閲覧に一括で切り替えることもできます。
  • 変更箇所の前後のコンテキスト行を展開できます。ファイルのヘッダーにある Expand all lines でファイル全体を表示し、Collapse expanded lines で元に戻します。Markdown ファイルは、レンダリングされた diff とソースを切り替えて表示できます。
  • diff の新しい側で行を選択して Add to Chat を選ぶか、Suggest change を選びます。Suggest change では、選択した行の現在のテキストを含む suggestion ブロックが入力済みのレビューコメントが開きます。
  • 空白のみの変更を非表示にすると、実質的な編集に集中できます。
  • PR ヘッダーと Review 一覧に表示される行数には、デフォルトでテストと生成コードが含まれません。行数にカーソルを合わせるとカテゴリ別の内訳が表示され、そこで Relevant、Both、Full のいずれかを選ぶと、表示する行数を切り替えられます。行数をクリックするたびに、これら 3 つの表示が順に切り替わります。選択内容は両方の場所に適用されます。
  • Cmd+F または Ctrl+F を押すと、レビュー内を検索できます。検索フィールドのフィルターアイコンから Match case、Changed lines only、Skip collapsed files を選択できます。デフォルトでは、閲覧済みかどうかにかかわらず、折りたたまれたファイルの内容は検索対象外です。ただし、ファイル名とフォルダ名は検索にヒットします。
  • 以前の分析を確認するには、ヘッダーのアクションメニューにある Analysis history を利用します。Select commits to view では、レビュー済みコミットの並び順を逆にできます。GitHub では、ピッカーにそれらのコミットに紐づく承認と変更リクエストも表示されます。古いコミットに固定されたリンクでは、最新の結果は自動的に表示されません。表示されている場合は Switch to latest または Run analysis on latest を利用してください。
  • CI のステータスは Checks ビューで確認できます。対応しているプロバイダーでは、Review を離れずにレビュアー、ラベル、担当者を管理できます。
  • diff の設定メニューでは Layout を選択できます。File tree view はグループ化されていない diff をファイルツリーとともに表示し、Guide view は関連する変更を説明付きでグループ化して表示します。
利用できるタブやコントロールは、プロバイダーとあなたのアクセス権によって異なります。

生成ファイルと diff サイズの上限

Git リポジトリのルートにある .gitattributes で linguist-generated とマークされたファイルは、Devin Review の diff サイズの上限にカウントされません。これらのファイルについては、追加行数と削除行数のみが表示され、変更内容は分析されません。 Devin Review は PR の head コミットから .gitattributes を読み取るため、PR 内で追加したルールはその PR のレビューに適用されます。一方、カスタムレビュアーと Autoapprover は、マージベース(PR の diff の算出に使用される共通の祖先)にすでに存在するルールのみを適用します。そのため、PR 自身のファイルをこれらの対象から除外することはできません。たとえば、src/generated/ 配下のファイルを生成ファイルとしてマークするには、ルートの .gitattributes に次のルールを追加します。
この除外設定によって、Git プロバイダ側の diff の上限が変わることはありません。たとえば、diff が大きすぎて GitHub から diff が返されない場合、Devin Review は除外を適用できません。

Bug Catcher

Bug Catcherは、PR を分析して潜在的な問題を検出します。検出結果には バグ、フラグ、セキュリティ があります。ベータ版のカスタムレビュアーは、それぞれ独自の検出結果を報告します。 Devin セッションがコードスキャンの検出結果を修正するために PR を作成した場合、埋め込みレビューには、関連する検出結果を表示する Finding または Findings タブが別途表示されます。検出結果へのアクセス権がある場合、このタブはセッションの PR タブのほか、Review ペインや Inbox ペインにも表示されます。

バグ

Devin は、エラーの可能性が高い箇所をバグとしてマークします。重大なバグから優先的に調査してください。重大なバグには赤いバグアイコンが、重大度の低いバグにはオレンジ色の警告アイコンが表示されます。表示されている場合は Learn more を展開すると、障害が発生するシナリオと推奨される対処法を確認できます。コピーボタンを使うと、該当箇所、説明、および提案された編集内容 (ある場合) がまとめてコピーされます。

フラグ

要調査フラグは、コードに関する疑問点を示すものです。修正が必要かどうかを判断する前に、フラグが付いた行をチェックしてください。情報フラグは変更内容を説明するためのもので、修正を求めるものではありません。

セキュリティ

Devin Review はセキュリティ脆弱性をスキャンし、他の検出結果と並べて表示します。セキュリティスキャンはフルレビューの一部です。セキュリティの finding を PR コメントとして投稿するかどうかは、投稿設定で制御できます。利用上限により自動レビューが一時停止されている場合など、diff のみを対象とした分析は、セキュリティレビューを完了したことにはなりません。 スキャナーは、次の脆弱性カテゴリをチェックします。
  • インジェクション (SQL、XSS、コマンド、テンプレート)
  • 認証・認可の不備 (アクセス制御の欠如または不備、権限昇格、認証バイパス)
  • シークレットの漏洩 (ハードコードされたキー、ログ内のトークン、ソース内の認証情報)
  • SSRF およびパストラバーサル
  • 安全でないデシリアライズ、プロトタイプ汚染
  • 信頼できないデータに対する入力検証の不足
  • 脆弱な暗号 (アルゴリズム、鍵管理)
  • 通信/クッキーのセキュリティ (HTTPS 強制の欠如、緩い CORS、安全でないクッキーフラグ)
  • PR によって導入された安全でないデフォルト設定や設定不備
検出結果は、次の 2 つの重要度レベルで表示されます。
  • 重大 — マージ前に修正すべき、確度の高い 脆弱性
  • 警告 — 調査に値する 潜在的なセキュリティ上の弱点
各検出結果には、問題の説明、対処法の推奨事項、および該当する場合は脆弱性の種類を分類する CWE 識別子が含まれます。 セキュリティスキャンは、指示ファイル内のセキュリティ関連の指示にも従います。たとえば、REVIEW.md にセキュリティポリシー、機微な領域、脅威モデルを追加して、スキャナーが何を検出するかを絞り込めます。 リポジトリのセキュリティモデルに関する前提情報を利用できる場合、built-in のレビューと、Security-related としてマークされたカスタムレビュアーは、リポジトリのルートにある SECURITY_MODEL.md、THREAT_MODEL.md、および SECURITY.md 内の脅威モデルやセキュリティモデルに関するセクションも読み込みます。

次のプッシュ時の動作

Devin がすでにレビューした PR に新しいプッシュがあった場合、通常は前回のレビュー以降の変更によって新たに発生したバグや、変更の影響を受けたバグを探します。以前の検出結果を引き継ぎ、新しいコミットでそれらが修正されたかどうかをチェックします。新しいコミットによって PR の内容が大きく変わった場合や、新しい diff が増分レビューで扱うには大きすぎる場合は、Devin が PR 全体を改めてレビューすることがあります。 PR ごとの自動レビュー費用上限は、プッシュごとではなく、その PR のすべてのレビューを通じて適用されます。上限に達すると、その PR での以降の自動レビューは一時停止されますが、手動レビューは引き続き実行できます。

レビューコメントの言語

設定 > 環境設定 の Devin Review セクションで、Devin Review がコメントと分析に使用する言語を選択できます。
  • 表示言語に従う (デフォルト) — レビューコメントは、表示言語の設定に従います。
  • 特定の言語 — コメントの言語 ドロップダウンで言語を選択すると、表示言語ではなくその言語でレビューコメントが作成されます。
REVIEW.md 内の言語に関する指示は、この設定より優先されます。

レビューへの対応

検出結果の解決

バグ タブでは、検出結果が対応状況ごとに一覧表示されます。
  • Needs your attention — あなたがトリアージする必要がある未対応の検出結果です。
  • Devin is fixing — PR の Devin セッションが対応中の検出結果です。自動修正 を参照してください。
  • Fixed — あなたまたは Devin が修正済みとしてクローズした検出結果です。
  • Invalidated — あなたまたは Devin が修正不要としてクローズした検出結果です。
検出結果を展開すると、詳細を確認して対応できます。対処が済んだら Mark fixed を選択します。修正が不要な場合は、必要に応じて理由を添えて Mark invalid を選択します。無効にした検出結果は、Reopen を選択すると Needs your attention に戻ります。 完了しなかったレビュアーがある場合は、タブの上部に警告が表示され、失敗したレビュアーがそれぞれ示されます。Retry を選択すると再実行できます。 検出結果のフィルターを利用すると、特定のカテゴリや未解決の課題に絞り込めます。また、検出結果を既読・未読にしたり、チャットに引用してフォローアップの質問をしたりすることもできます。同じ PR を再度レビューする際、Devin はすべての結果を新規として扱うのではなく重複をチェックし、以前に指摘したバグやフラグが対処済みであれば解決済みにします。その場合、検出結果は元のテキストのまま残り、Devin marked this as resolved というラベルが付きます。

コメントとレビュー

GitHub では、Devin Review からコメントを残したり、PR を承認したり、変更をリクエストしたりできます。その他のホストについては、プロバイダーリファレンスを参照してください。

レビューを開始する

トップレベルのコメント、新しいインラインコメント、または既存のスレッドへの返信を書く際、送信ボタンでは 2 つのアクションを選択できます。Start a review はコメントを個別に投稿せず、保留中のレビューにまとめます。Comment はすぐに投稿します。Devin Review は最後に選択したアクションを記憶してデフォルトに設定します。これは Cmd+Enter または Ctrl+Enter ショートカットにも適用されます。レビューを開始すると、ボタンは Add to review に変わり、送信するまでの間、以降のコメントはそのレビューに追加されます。これは作成者に向けたあなた自身のレビューであり、Devin に再度の分析をリクエストするものではありません。

コメントの解決

対応が完了したディスカッションスレッドは解決済みにしてください。GitHub では、ボットが作成したレビューのスレッドがすべて解決されると、Devin はそのレビューを最小化します。スレッドが再オープンされた場合は、レビューが再び表示されます。

コードオーナーの表示

サイドバーでレビュアーの横に盾アイコンが表示されている場合は、そのレビュアーがコードオーナーとしてリクエストされたことを示します。

チャットによるコード変更

チャットエージェントにコードの編集を依頼できます。提案された変更を確認したうえで、Devin Review を離れることなく、それらを PR ブランチにコミットとして適用できます。これは、Devin セッションを利用して検出結果に対処する自動修正とは異なります。

PR ワークフロー操作

Devin Review では、GitHub に切り替えることなく、レビュー ページから直接 PR に対する操作を行えます。
  • Merge — リポジトリで許可されている任意のマージ方法 (merge commit、squash、または rebase) で PR をマージします。複数の方法が許可されている場合は、マージ ボタンのドロップダウンから選択します。Devin Review は、リポジトリとベース ブランチごとに最後に選択した方法をブラウザに記憶します。マージ ボタンには、PR の現在のマージ可否のステータスと必要なチェックが反映されます。
  • Close — PR をマージせずにクローズします。マージ ボタンの横にあるドロップダウン メニューから利用できます。
  • Convert to draft — オープン中の PR をドラフト状態に変更します。PR がオープン中で、まだドラフトでない場合にドロップダウン メニューから利用できます。
  • Mark ready for review — ドラフト PR をレビュー準備完了としてマークします。ドラフト PR では、マージ バーに「レビュー準備完了」ボタンが表示されます。このボタンのメニューには Review draft もあり、PR をレビュー準備完了にしないままレビューを開始できます。
  • 自動マージ — マージ ボタンのドロップダウンから GitHub の自動マージを有効または無効にします。有効にすると、必要なチェックがすべて完了した時点で PR は自動的にマージされます。マージ バーには、誰が有効にしたかを含む現在の自動マージのステータスが表示されます。
上記は GitHub での操作であり、GitHub アプリ 接続と、リンク済みの GitHub ID が必要です。読み取り専用モードでは操作は無効になります。その他のプロバイダーでは、サポートされているGitプロバイダー に記載されている一部の操作のみがサポートされます。

キーボード ショートカット

m と n は対応するボタンと同じく即座に実行されます。そのため、m を押すと確認なしでマージされます。バインドを変更するには、設定 > キーボード ショートカットを開いてください。

スタック型PR

Devin Reviewでは、スタック型PRが主要な機能としてサポートされています。PRがスタックに含まれている場合、レビューページにはシリーズ全体が表示され、マージも正しく処理されます。
  • スタックパネル — PRヘッダーには、マージ先のベースブランチまで、すべてのメンバーが下から上の順に並んだスタックが表示されます。各メンバーからそれぞれのレビューページに移動できるため、スタックをレイヤーごとに確認できます。スタック数の横にある Reverse stack order を使うと、ベースブランチを先頭にした順序で表示でき、この設定は保存されます。
  • レイヤーごとのマージ準備状況 — 各メンバーには、実際のマージ可否を示すステータスドットが表示されます。CI、必須レビュー、ブランチ保護を考慮してマージ可能な場合は緑、チェックの失敗または競合がある場合は赤、それ以外の理由でマージがブロックされている場合はオレンジです。これには、レイヤー自体はマージ可能でも、その下にマージできないPRがあるためブロックされている場合も含まれます。集約インジケーターにはスタック全体の状態が表示されます。
  • 対象を絞った差分 — スタック内の各PRは、その直下のレイヤーとの差分として表示されるため、自動レビューやBug Catcherを含むすべてのレビューでは、そのレイヤーでの変更のみが確認されます。
  • スタックのマージ — スタック型PRは、GitHubのアトミックなスタックマージによってマージされます。PRをマージすると、スタック内でそのPRより下にある未マージのPRもすべて、下から上へ1回の操作でマージされます。マージボタンには、その操作でマージされるPR数が正確に表示され、その後GitHubによって残りのPRの対象ブランチがベースブランチに変更されます。
  • 自動マージ — スタック型PRでは、GitHubの自動マージを有効にできます。スタックの準備が整うと、GitHubによってそのPRと、その下にある未マージのPRがすべてマージされます。
スタック型PRはGitHub.comのリポジトリでのみ利用できます。また、利用可否はアカウントによって異なります。Devinによるスタックの作成と管理については、スタック型PRガイドを参照してください。

コミットとコメントの帰属

  • バグの検出、フラグ付け、自動アノテーションは、常に Devin ボット として表示されます。
  • ユーザーが Devin Review を通じてコメントやレビューを書いた場合、それは ユーザー自身の GitHub アカウントとして表示されます。
  • ユーザーがチャットエージェントにコード変更を依頼した場合、その結果として作成されるコミットは Devin ボット によって行われます。
  • GitHub Suggested Changes は標準的な GitHub の挙動に従います。任意のレビュアー (Devin を含む) がレビューコメント内で変更提案を残すことができます。提案の適用は、自動修正セッションの開始とは別の操作です。
  • Devin は、ユーザーが明示的にアクションを開始しない限り、ユーザーに代わってコミットやコメントを作成することは 決して ありません。

自動修正

自動修正は、Devin セッションを利用して PR に対するレビューの検出結果に対処する機能です。個々の編集提案を適用したり、Review チャットエージェントにコミットの準備を依頼したりする操作とは異なります。

有効にする方法

すでに Devin セッションが所有している PR では、自動修正は Automatically fix Devin Review findings 設定に従います。この設定の説明は「Devin will automatically triage the findings and decide whether to fix, validate, or escalate them to you.」 (Devin が検出結果を自動的にトリアージし、修正・検証・あなたへのエスカレーションのいずれを行うかを判断します) です。この設定には、組織のデフォルトと個人の選択があります。
  1. 組織単位 — 組織管理者は Settings > Devin の Pull requests でオン/オフを切り替えます。項目の説明にあるとおり、「This option configures the default for all users.」 (このオプションはすべてのユーザーのデフォルトを設定します) 。他のメンバーはこの設定を変更できません。Enterprise アカウントでは、組織ごとに個別のデフォルトを持ちます。
  2. 自身 — 自分のセッションから作成された PR については、設定 > 環境設定 の Devin セッション でオン/オフを切り替えます。変更するまでは、スイッチに組織のデフォルトが表示されます。デフォルトと異なる値を選択すると Reset to organization default ピルが表示され、ホバーすると説明を確認できます。このピルをクリックするか、スイッチを組織の値に戻すと、再び組織の設定に従うようになります。自分の選択はオン・オフどちらの場合も優先され、デフォルトがオフの組織で自分だけオンにすることもできます。
Devin が所有する PR でこの設定がオフになっている場合、レビューのサイドバーで Enable auto-fix を使うと、自分に対してのみ設定がオンになります。組織のデフォルトは変更されません。 自動修正がオフの場合、セッションの PR カード、検出結果の注意喚起カードの下、またはレビューの Bugs サイドバーに Fix with Devin が表示されることがあります。これを使うと、この PR の検出結果を修正できます。自分のセッションから作成される今後の PR でも自動修正をオンにするには、More fix options を開いて Automatically fix findings on all my PRs をオンにします。この操作で変更されるのは自分の設定のみで、組織のデフォルトは変わりません。 アカウントのレビュー管理者は、この 設定 > レビュー のリンク から、Devin セッションが作成した PR を対象とするアカウント全体の自動レビュールールの下書きを作成することもできます。ルールは保存した時点で適用されます。アカウント全体のルールがすでにこれらの PR を対象としている場合、下書きは作成されません。 Devin セッションがリンクされていない PR では、Devin で自動修正 を使ってセッションを開始し、PR を引き継いで、検出されたバグや失敗している必須の CI チェックに対処させることができます。これには、セッションを作成する権限と、対象リポジトリへのアクセス権が必要です。アカウント全体のワークスペースでは、先に環境またはアウトポストを選択してください。お客様の企業でセッションタグが必須となっており、デフォルトのタグや唯一許可されたタグがない場合は、表示される案内に従ってタグを選択してください。作成されたセッションとそのコミットへのリンクは、レビューに表示されます。
Devin で自動修正 を使うと、Automatically fix Devin Review findings がオフの場合は、自分に対してこの設定もオンになります。

Devin 自身の PR に対する検出結果

PR を作成した対象セッションがある場合、新しい検出結果は個別に投稿される前に、そのセッションに引き渡されます。GitHub では次のように動作します。
  1. PR に Devin is fixing と表示され、検出結果は バグ タブの Devin is fixing に移動します。
  2. セッションのオーナーに対して Automatically fix Devin Review findings がオンになっており、PR の監視がアクティブな場合、セッションは対処可能な検出結果を修正し、各検出結果への判断を記録します。
  3. Devin は修正内容をまとめたレビューを 1 件投稿し、詳細を Fixed by Devin の下に記載します。あなたの対応が必要な検出結果は、投稿設定に従ってレビューコメントとして投稿されます。Devin が無効と判断した検出結果は投稿されません。
このフローには、PR を引き継いだだけのセッションではなく、PR を作成した、実行中または一時停止中の対象セッションが必要です。対象セッションが存在しない場合、設定がオフの場合、または PR がすでにクローズ済みかマージ済みの場合は、検出結果がレビュー用に PR へ投稿されます。セッションが処理を完了する前に終了した場合、残りの検出結果は Needs your attention に戻ります。他のプロバイダーでもセッションは検出結果に対処できますが、PR 上に表示されるステータスは異なります。

権限と制約

  • Automatically fix Devin Review findings の組織のデフォルトを変更するには、組織管理者の権限が必要です。各メンバーのセッションでは、そのメンバー自身の選択がデフォルトより優先されます。
  • Settings > Devin > Pull requests の Responding to bots は、引き続き他のボットからのコメントを制御しますが、自動修正 は制御しなくなりました。
  • Devin Review の No Issues Found のサマリーコメントは常に無視されます。実際の検出結果を含むコメントのみが 自動修正 をトリガーします。
Devin Review が検出結果を投稿した時点で Automatically fix Devin Review findings がオフになっている場合、セッションタイムラインに有効化を促すプロンプトが表示されます。

自動レビュー

自分が作成したプルリクエストをレビューするには、個人の環境設定を利用します。チームのプルリクエストをレビューするには、レビュー設定でルールを追加します。いずれの場合も、リポジトリが公開リポジトリであっても、Devin に接続しておく必要があります。
新しいアカウントには、Devin セッションが作成した PR を準備完了時とプッシュのたびにレビューするアカウント全体のルールが最初から設定されています。また、Automatically fix Devin Review findings がデフォルトでオンになっているため、これらのセッションが検出結果を修正します。このルールはレビュー設定で編集または削除できます。組織が 1 つだけの既存の Enterprise以外のアカウントにも、管理者がこの設定をオフにしたりルールを削除したりしていない限り、同じルールと設定が適用されています。それ以外の既存の組織ではルールは変更されておらず、この設定がオンになるのは、Responding to bots で Devin が Devin Review のコメントに対応できるようにすでに設定されている場合のみです。

トリガーモード

ルールを開始するタイミングを選択します:
  • PR is created — PR がオープンされたとき (ドラフトとしてオープンされた場合を含む) 。
  • PR is ready — PR がレビュー可能な状態でオープンされたとき、またはレビュー可能としてマークされたとき。
次に、実行頻度を選択します:
  • Only once — トリガー条件を満たしたときに 1 回だけレビューします。
  • Every push — 以降のプッシュのたびに再度レビューします。この設定には、自動レビュー使用量のフルティアが必要です。リポジトリ単位のアクセス権を利用している場合、そのリポジトリの編集アクセスをあなたに付与している組織が Every push を許可していれば、別の組織から設定を閲覧しているときでも、リポジトリルールで Every push を選択できます。フォローアップレビューの対象範囲については、次のプッシュ時の動作を参照してください。
PR にマージコンフリクトがある間は自動レビューはスキップされ、コンフリクトが解決されると実行されます。レビューページには Merge conflicts の通知が表示されますが、このページからレビューを手動で開始することもできます。 個人設定では 手動 も選択でき、選択すると個人の自動登録が解除されます。ただし、条件に一致する他のルールによってリクエストされたレビューは無効になりません。

自己登録 (すべてのユーザー)

アカウントで個人登録が有効になっている場合、Git プロバイダの ID をリンク済みで、適切なレビュー利用ティアを持つユーザーは、管理者権限がなくても自分で登録できます。
  1. 設定 > 環境設定 に移動します。
  2. Devin Review で、Analysis trigger を Analyze PRs automatically when opened または Analyze PRs automatically when ready for review に設定します。
  3. 権限で許可されている場合は、Analysis frequency を Only once または Every push に設定します。
Devin は、アクセス可能な接続済みリポジトリで、あなたが作成した対象のプルリクエストをレビューします。設定に詳細なフィルターが表示されている場合は、よりシンプルな個人用トリガーで置き換えず、レビュー設定で元のルールを管理してください。 対象となる接続済みのプルリクエストでは、レビュー権限で許可されていれば、レビューページのアクションメニューから自動レビューのオン/オフを切り替えることもできます。ただし、公開レビューや read-only のレビューでは、このコントロールを利用できない場合があります。 自動レビューは PR から直接オンにすることもできます。PR に適用されるルールがない場合、PR の説明にある Devin Review ステータスに Enable auto-review リンクが表示されます。このリンクをクリックすると、Turn on automatic analysis の prompt が表示された設定ページが開きます。レビュールールを管理できる場合は、代わりにそのリポジトリ用のドラフトルールが開きます。レビューページのバナーや、セッションの PR カードにある Analyze ボタンからも同じ選択肢を利用できます。権限とリンク済みの Git アカウントに応じて、この PR を一度だけレビューするか、This pull request、All my pull requests、またはリポジトリの Every pull request in を対象に自動レビューをオンにするかを選択できます。

スコープが限定されたルールと除外ルール

Review manager は、設定 > レビュー の Review タブで自動レビューのルールを設定します。このページには セキュリティ、カスタムレビュアー、Autoapprover、Billing の各タブもあります。セキュリティ タブはアカウントの Review manager に表示されます。 Automatic analysis の下にある追加メニュー (リストが空の場合は Add repositories or users、それ以降は Add repository) を開き、ルールの対象を選択します。名前空間内のすべてのリポジトリを対象にする場合は Add GitHub organization、Add GitLab group、Add Azure DevOps project、Add Bitbucket workspace、Add Bitbucket project のいずれかを、1 つのリポジトリを対象にする場合は Add single repository を、アカウントメンバーが作成したすべての PR を対象にする場合は Add user を、条件を組み合わせる場合は Add advanced rule を選択します。ルールのダイアログで Repository または Organization のいずれかを対象として選び、条件で絞り込みます。 is と is not は完全一致で比較します。リポジトリ、タイトル、ブランチ、変更ファイルの条件で glob パターンを使う場合は、matches または does not match を選択します。次に、ルールの開始イベントと実行頻度を選択します。ルールの Analysis effort には、アカウントのデフォルトを利用するか、Normal または Ultra を指定して上書きできます。 Originated by Devin 条件を含む自動ルールでは、Devin セッションを開始したユーザーの利用ティアによって、その条件がマッチするタイミングが制限されます。作成時のみのティアでは、最初の対象レビューは実行されますが、以降のプッシュに対するレビューは実行されません。手動のみのティアの場合、または Review の権限がない場合、この条件はマッチしません。 この機能で処理しない PR には除外ルールを設定します。条件にマッチする除外ルールは、登録ルールより優先されます。 除外ルールによって PR の自動レビューがスキップされた場合は、Automatic analysis skipped by an exception を展開すると、マッチしたルールのうちあなたがアクセスできるものを確認できます。この場合でも 1 回限りのレビューは実行できますが、以降のプッシュは引き続き除外されます。 自動レビュー、各カスタムレビュアー、Autoapprover のルールはそれぞれ独立しています。通常の自動レビューを有効にしても、Autoapprover や、マッチするルールのないカスタムレビュアーは有効になりません。また、Autoapprover の除外ルールによって通常の自動レビューが無効になることもありません。 ルールは、従来のリポジトリ単位および個人単位の登録リストに代わるものです。レガシーの登録項目ではレビューが開始されなくなったため、代わりに対応するルールを設定してください。 アカウントの Review manager は、Git provider interaction で Let Devin Review edit the PR description (デフォルトでオン) をオフにすることもできます。この設定がオンの場合、PR の説明にリンクとレビューのステータスが追加されます。オフにすると説明は変更されず、GitHub ではリンクとステータスが代わりに 1 件の PR コメントにまとめて表示されます。

GitHub への投稿

アカウントの Review manager は、設定 > レビュー で、Devin が接続済みの Git プロバイダに投稿する内容を設定できます。接続済みのプロバイダ名が付いた Post findings to セクションでは、コメントとして投稿する検出結果の種類を選択します。バグとフラグは Review タブで、セキュリティの finding は セキュリティ タブで設定します。Review タブの Git provider interaction には、CI チェックと PR の説明へのリンクのトグルがあります:
  • CIチェックを公開 — 有効な場合 (デフォルト) 、Devin は対応しているプロバイダ上で、レビューごとに Devin Review コミットステータスを作成します。Passing condition では、成功とみなす条件を「レビュー完了 (デフォルト) 」「スレッドがすべて解決済み」「検出結果なし」から選択します。Azure DevOps では、ステータスはコミットとプルリクエスト自体の両方に投稿されるため、プルリクエストのステータス一覧に表示され、Status ブランチポリシー (genre devin、name Devin Review) で必須に設定できます。他のアイデンティティがこのポリシーを満たせないよう、ポリシーの Authorized identity には Devin が投稿に使用するアカウントを設定してください。
  • Bugs — バグ (エラーや誤った動作の可能性が高いもの) を PR コメントとして投稿します。
  • セキュリティ — セキュリティ脆弱性 とハードニングの提案を PR コメントとして投稿します。
  • フラグ (要調査) — 要調査フラグ (詳しく確認する価値のある潜在的な issue) を PR コメントとして投稿します。
  • フラグ (note) — note フラグ (対応が不要な場合もある参考情報) を PR コメントとして投稿します。
デフォルトでは、バグとセキュリティの finding が PR コメントとして投稿されます。要調査フラグと note フラグはデフォルトでは投稿されません。管理者は検出結果の種類ごとに個別に切り替えられます。 Add an override を利用できる場合は、リポジトリ単位または対応するリポジトリスコープ単位で、デフォルトの投稿カテゴリを上書きできます。この設定で制御するのは投稿内容であり、レビューを実行するかどうかではありません。カテゴリを 1 つも選択しない場合、そのスコープでは検出結果のコメントは投稿されません。
Enterprise アカウント: 設定は Enterprise 内のすべての組織に適用されます。アカウント全体の投稿コントロールを変更するには、アカウントレベルの Manage Review 権限が必要です。organization-level のルール管理権限では、これらのデフォルトを変更する権限は付与されません。各組織の レビュー設定ページで扱えるのはその組織のリポジトリのみで、 エンタープライズ全体の設定は Enterprise-level setting と表示されてロックされます。これらの設定はエンタープライズの レビュー設定から変更してください。

指示ファイル

Devin Review は、リポジトリ内の 指示ファイル を尊重します。これらのファイルのいずれかが存在する場合、PR を分析する際の前提情報として使用されます。
  • **/REVIEW.md
  • **/AGENTS.md
  • **/CLAUDE.md (大文字と小文字を区別しません)
  • **/CONTRIBUTING.md (大文字と小文字を区別しません)
  • .cursorrules
  • .windsurfrules
  • .cursor/rules
  • *.rules
  • *.mdc
  • .coderabbit.yaml / .coderabbit.yml
  • greptile.json
agent に類似したサブディレクトリ (.agents/、.devin/、agents/、.cursor/、.github/) 内のファイルは、スコープの目的上、親ディレクトリに属するものとして扱われます。たとえば、src/.agents/REVIEW.md は src/ 配下のファイルに適用されます。 これらのファイルは、レビューの前提情報として利用されます。独自の検出結果を報告する名前付きのチェックが必要な場合は、代わりにカスタムレビュアーを設定してください。

REVIEW.md

REVIEW.md は Devin Review 用の専用指示ファイルです。リポジトリ内の任意の場所に配置して、プロジェクトにおける Devin の PR レビュー方法をカスタマイズできます。Devin はあらゆるディレクトリ階層 (**/REVIEW.md) で自動的に REVIEW.md を検出するため、必要に応じて特定のサブディレクトリ単位でレビューガイドラインの適用範囲を絞り込めます。 REVIEW.md を使って、レビューに特化したガイドラインを定義できます。例えば:
  • 追加の注意が必要なコードベース上の領域
  • 注意すべき一般的な落とし穴やアンチパターン
  • レビュアーが順守させるべきプロジェクト固有の規約
  • レビュー時に安全に無視できるファイルやディレクトリ
  • プロジェクト特有のセキュリティやパフォーマンス上の考慮事項
REVIEW.md の例:

カスタムレビュールール

設定 > レビュー の 前提情報 で、レビュー時に前提情報として読み込む追加ファイルを設定できます。これらのファイルパターンは カスタムレビュアー とは異なり、独自の検出結果を生成するレビュアーを定義するものではなく、背景情報を提供するためのものです。 リポジトリファイルを追加する手順:
  1. レビュー設定の Review タブで 前提情報 を探します。
  2. Add 前提情報 を選択します。Add repository files が直接開くか、Repository files を選択できるメニューが表示されます。
  3. docs/architecture/**/*.md などのファイル glob パターンを入力して追加します。
パターンはアカウント全体に適用されます。レビュー対象のリポジトリ内でマッチするファイルが、変更されたファイルに近いものから順に読み込まれます。カスタムパターンは一覧から編集・削除できます。

レビュー前提情報の指示 (Beta)

記述式のレビュー前提情報の指示は Beta 版で、利用にはベータアクセスが必要です。 リポジトリの指示ファイルは、これとは別に引き続き利用できます。
リポジトリにファイルを追加せずにガイダンスを一元管理したい場合は、レビュー前提情報の指示を利用します。
  1. 設定 > レビュー を開き、前提情報 セクションを表示します。
  2. 追加メニューを開き、Beta と表示された Managed instructions を選択します。
  3. タイトルとレビューのガイダンスを入力します。
  4. All repositories、または対象を絞ったリポジトリスコープを選択します。
  5. 前提情報を追加 を選択します。
たとえば:
ガイダンスが変わった場合は、項目を編集または削除してください。これらの指示を管理するには、アカウント階層の Manage Review 権限が必要です。ガイダンスをコードと併せてバージョン管理したい場合は、代わりにリポジトリ内のファイルを利用してください。

カスタムレビュアー (ベータ版)

カスタムレビュアーは現在ベータ版です。レビュアーを作成または設定できない場合は、組織またはアカウントのReview managerにお問い合わせください。
カスタムレビュアーは、あなたが記述した指示に基づいてプルリクエストをチェックし、そのレビュアーに紐づく検出結果を生成します。API の互換性、データベースのマイグレーション、アクセシビリティ、テスト要件など、特定の観点に絞ったチェックに利用できます。 共有の背景情報や規約にはレビューの前提情報を利用し、独自の指示、検出結果、適用ルールを備えた名前付きのチェックが必要な場合はカスタムレビュアーを利用します。

レビュアーを作成する

  1. 設定 > レビュー を開き、Custom reviewers タブを選択します。
  2. Add reviewer を選択し、Name と説明 (任意) を入力します。
  3. Instructions で Plain text を選択してチェックする内容と無視する内容を記述するか、既存のスキルに基づいて動作させる場合は Repository skill または Organization skill (エンタープライズでは Enterprise skill) を選択します。
  4. Finding urgency を選択します。修正が必須の問題には Severe、調査すべきフラグには Moderate、提案や前提情報には Info を選びます。
  5. Create and enable を選択します。後で作業を続ける場合は Save as draft を選択します。
  6. レビュアーを開き、Rules を確認します。アカウント全体の Review を管理する権限がある場合、新しいレビュアーは Run with Devin Review がオンの状態で作成されるため、すべてのレビューに参加します。特定のプルリクエストに限定するには、これをオフにして Add reviewer rule を選択します。それ以外の場合、レビュアーはルールがない状態で作成されるため、ルールを追加してチェック対象のプルリクエストを指定します。
タイミングが Whenever Devin Review runs のルールは、それ自体でレビューを開始することはありません。レビュアーは、条件にマッチングする PR のレビューであれば、そのレビューの開始方法にかかわらず参加します。 GitHub では、Only once と CI check を選択すると、レビュー準備完了状態のオープンなPRの現在のコミットで、指定した名前のチェックが成功した時点でカスタムレビュアーを開始できます。チェック名は正確に入力してください。GitHub のコミットステータスはチェック run としてカウントされません。また、このタイミングは built-in のレビューでは利用できません。 有効なレビュアーでも、マッチングするルールがなければ実行されません。ドラフトまたは無効のレビュアーは、ルールがマッチングしても実行されません。マッチングの除外設定はルールより優先されます。 たとえば、API リポジトリ用に API compatibility レビュアーを作成します。

スキルを再利用する

Repository skill、Organization skill、または Enterprise skill から作成したレビュアーでは、最初から Keep the reviewer in sync with the skill が選択されています。この状態では、レビュアー内の指示は read-only となり、スキルの変更に合わせて自動的に更新されます。リポジトリスキルは、リポジトリのデフォルトブランチ (通常は main または master) から読み込まれます。 リポジトリスキルの候補には、エージェントのスキルディレクトリ (.agents/skills/ や .devin/skills/ など) にあるスキルと、リポジトリ内の各プラグインに含まれるスキルが表示されます。プラグインについては、.devin-plugin/plugin.json または .claude-plugin/plugin.json の skills に記載されたディレクトリが使用され、記載がない場合はデフォルトで skills/ ディレクトリが使用されます。 このオプションの選択を解除すると、レビュアーは現在のテキストを保持し、スキルの更新はあなたの承認後に反映されるようになります。指示を自分で編集するには、Change source… を選択して Plain text に切り替えます。これにより、現在のテキストを保持したまま、レビュアーとスキルのリンクが解除されます。
エンタープライズでは、レビュアーは共有されます。ある組織のスキルのテキストは、今後の編集内容も含め、 その組織のメンバーしか閲覧できません。 ただし、他の Review manager もレビュアーのそれ以外の設定は引き続き編集できます。

検出結果と CI チェック

検出結果には、レビュアーの名前と設定済みの緊急度が表示されます。View runs では、各レビュアーの実行履歴を、修正済みおよび無視された検出結果の件数とあわせて確認できます。また、検出結果の対応状況で実行をフィルターすることもできます。 各レビュアーには CI チェック セクションもあります。このセクションの Post CI チェック 設定では、レビュアーの検出結果を Devin Review チェックに含める (Part of Devin Review) か、Devin Review / API compatibility のようにレビュアー名を付けた Separate check として投稿するかを選択します。個別チェックの Passing condition には、次のいずれかを指定できます。
  • Reviewer finishes — 課題が見つかった場合でも、レビューが完了すれば成功となります。
  • All comments are resolved — 投稿したコメントがすべて解決済みになると成功となります。
  • There are no open findings — 検出結果がすべてクローズされると成功となります。
個別チェックを使用するには、アカウントの Post CI チェック 設定を有効にする必要があります。この設定がオフで、あなたが有効にできない場合は、アカウントの管理者に依頼してください。なお、チェックを投稿しただけではマージの必須条件にはなりません。マージをブロックするには、リポジトリのブランチルールで、表示されたチェックを必須に設定してください。

支出上限

各レビュアーの Spend limit セクションでは、1 つの PR の自動レビューでそのレビュアーが支出できる額を制御します。Budget には 2 つのオプションがあります。
  • Part of Devin Review limit(デフォルト)— レビュアーの支出は PR ごとの自動レビュー支出上限 に計上されます。必要に応じて Limit per pull request を設定すると、レビュアーの支出をその上限より低く抑えられます。
  • Separate budget — レビュアーは専用の Limit per pull request(必須)から支出し、Devin Review の上限に達した後も実行を続けます。このオプションを選択できるのは、アカウント階層の Review manager のみです。
この上限の単位は、PR ごとの自動レビュー支出上限と同じです。レビュアーが上限に達すると、その PR の以降の自動レビューではそのレビュアーがスキップされ、該当する run に Skipped: spend limit reached と表示されます。手動で開始したレビューは、レビュアーの上限の影響を受けません。

Version History とアーカイブ

レビュアーのページで Last updated on … を選択すると、その Version history が開きます。ここには指示の直近 20 件のバージョンが表示され、各バージョンには直前のバージョンからの変更内容が示されます。Restore を選択すると、以前のバージョンの指示が新しいバージョンとして保存されます。スキルに従っているレビュアーは、そのスキルへの追従を解除するまで以前のバージョンを復元できません。 設定を残したまま今後の実行を止めるには、レビュアーを無効にします。アーカイブすると、レビュアーはレビュアーリストの下にある Archived reviewers に移動し、実行が停止します。すでに投稿された検出結果はそのまま残ります。アーカイブしたレビュアーを Restore で復元すると無効の状態で戻るため、有効にするまで再び実行されることはありません。

Autoapprover (Beta)

Autoapprover は Beta 版であり、利用にはベータアクセスが必要です。
Autoapprover は、選択された PR を人間によるレビューなしで承認できるかどうかを評価します。レビュー対象のコミットを承認するか、PR を人によるレビューに回します。 この機能は、マージ前に承認レビューが必須となっているリポジトリを想定しています。Autoapprover による承認は Devin からの承認レビュー 1 件としてカウントされ、コードオーナーのレビューとしては扱われません。 カスタム指示は任意です。 ルールで選択した PR に対して Autoapprover を有効にすると、built-in の評価基準を使用してすぐに動作します。
  • 意図: 変更内容は PR 作成者が示した意図と一致しているか?
  • コード品質: 変更後もコードベースの保守性とレビューのしやすさが保たれているか?
  • インシデントリスク: 変更に含まれる問題が、信頼性やセキュリティのインシデントを引き起こす可能性はないか?
Autoapprover は、この評価基準に加えてレビューの検出結果も考慮します。使用前に prompt を作成する必要はありません。
Shadow mode がオフの場合、Autoapprover は実際に承認を行います。まずは 狭いスコープで開始し、対象を広げる前にその判断内容を確認してください。Autoapprover 自体が PR をマージすることはありませんが、承認によってリポジトリの要件が満たされ、 既存の自動マージやマージキューの設定によってマージが進む場合があります。

Autoapprover のセットアップ

  1. 設定 > レビュー を開き、Autoapprover タブを選択します。タブに Autoapprover がまだアカウントで利用できない旨が表示される場合は、アカウントにベータ版へのアクセス権がありません。
  2. 評価対象とするリポジトリと PR の条件を選択して、Autoapprover ルールを追加します。
  3. 必要に応じて、評価対象から常に除外したいプルリクエストを指定する Autoapprover 除外設定を追加します。
条件にマッチするルールは必須ですが、カスタム指示は任意です。Autoapprover は登録済みのプルリクエストをプッシュのたびに評価します。マッチする除外設定がある場合は、そちらが優先されます。増分評価では前回の判定と新しい変更内容をもとに評価し、必要に応じて全体を再評価します。 アカウントの Review manager は Shadow mode を有効にすると、プルリクエストの承認や承認の取り消しを行わずに、判定をコメントとして投稿できます。Approvals カードには、最近の判定とその結果が表示されます。Always approve ルールは、マッチする登録済みのプルリクエストを判定なしで承認します。ただし、未対応の検出結果がある場合や、PR によって承認ポリシーが変更される場合は除きます。ファイル条件は、変更されたすべてのファイルにマッチする必要があります。Always deny ルールにマッチするプルリクエストは人による判断に委ねられ、このルールは Always approve よりも優先されます。

任意のカスタム指示

デフォルトの評価基準を調整するには、Instructions の下にある Add instructions を選択し、適用先を選びます。自動承認して問題ないものと、常に人の判断が必要なものを、チームの方針に沿って記述してください。これらの指示は、対象とする基準についてはデフォルトの評価基準よりも優先されます。指示同士が競合する場合は、よりスコープの狭い指示が優先されます。CI のステータスに依存する指示など、Autoapprover が検証できない指示はスキップされ、スキップした内容は判定結果の中で説明されます。 Autoapprover は評価基準を使って PR を評価する際、リポジトリのルート、および変更されたファイルのディレクトリとその親ディレクトリにある APPROVAL_POLICY.md ファイルと AUTOAPPROVE.md ファイル (以前の名称) も読み取ります。これらのファイルは PR のターゲットブランチから読み取られるため、PR が自らの承認ルールを書き込むことはできません。読み取ったファイルの内容は、指示としてレビュアーに渡されます。APPROVAL_POLICY.md または AUTOAPPROVE.md ファイルを変更する PR には常に人間によるレビューが必要です。 指示は判断の指針となるものであり、それだけでプルリクエストが自動承認の対象に登録されるわけではありません。たとえば、ドキュメントリポジトリに限定したルールを追加した後、必要に応じて次のような指示を追加できます。
指示はレビュアーの判断の指針となるものであり、厳密なルールとして強制適用されるわけではありません。.github/ 配下の変更や一定サイズを超える差分など、決して自動承認してはならない条件には、Autoapprover の除外ルールを利用してください。ブランチ保護やアクセスコントロールは引き続き維持してください。

結果の確認

PR の Autoapprover セクションには、判定結果とその理由が表示されます。
  • Autoapproved — Devin が PR を承認しました。
  • Not autoapproved — PR には人間によるレビューが必要です。
  • Approved by a person — 人間が承認しました。
Shadow mode では、このセクションに Shadow バッジが付き、「Devin would have approved this pull request. No action was taken.」のように、Devin が本来どう判定していたかが表示されます。Shadow モードの判定によって PR が承認されたり、承認が取り消されたりすることはありません。 Autoapprover が評価基準に基づいて PR を評価し、空でないポリシーファイルが見つかった場合、理由の欄にはそれらのパスを列挙した Policy read from: 行が含まれます。Always approve または Always deny ルールによる結果、ポリシーファイルを変更する PR の結果、およびこの行が導入される前の結果には、この行は含まれません。したがって、この行がない場合に確認できるのは、評価基準による評価でポリシーファイルが見つからなかったということだけです。 Autoapprover が PR を人間によるレビューに回す場合は、理由を添えたコメントレビュー Autoapprover left this pull request for human review. も PR に投稿します。レビューの編集に対応しているプロバイダーでは、以降の評価で新しいレビューが追加されることはなく、既存のレビューが上書きされます。 後から完了した評価で判定が変わった場合、Autoapprover は以前の承認を取り消すことがあります。承認を更新できない場合は、Devin による承認が残っていないか PR をチェックするよう UI に表示されます。評価が失敗またはスキップされても、以前の承認が取り消されたことにはなりません。 GitHub では、PR の作成者は自分の PR をレビューできません。そのため、Devin が承認できるようにするには、Devin があなたの名前で GitHub の PR を作成するように設定してください (GitHub アカウントをリンクする) 。 ルールを削除すると、そのルールにのみ一致していた PR は今後評価されなくなりますが、すでに投稿された承認が失効するわけではありません。想定外の結果になった場合は、Git プロバイダ上の承認をチェックし、ルールの対象を絞り込んだうえで、PR のリンクと関連する指示を Cognition の担当者に送ってください。

権限とコスト

権限

Devin Review へのアクセスは、ロールエディターの Devin Review 権限 で制御されます。使用量のティアによって、手動レビュー、PR 作成時のレビュー、フル自動レビューが区別されます。アカウント全体の設定を行うには Manage Review (一部のロールエディターでは Manage Devin Review と表示) が必要です。ただし、後述のとおり、リポジトリへの権限付与があれば、その対象となるルールについてはそれだけで十分な場合があります。 Enterprise 管理者は、カスタムロール を使用して、使用を制限したり、設定へのアクセス権を付与したりできます。アカウントレベルの権限はアカウント全体の設定を管理し、organization-level のレビュー権限はエンタープライズ内の各組織でのアクセスを管理します。リポジトリ単位の権限付与を使用している場合、リポジトリまたは Git接続に対するレビュー設定の権限が付与されていれば、その対象となるルールについて 設定 > レビュー にもアクセスできます。 自己登録が有効になっている場合、Manage Review は不要です。ただし、利用できるトリガーモードは使用量のティアによって制限されます。 Devin Review の権限ティアの一覧と、各ティアで付与される内容については、アカウントレベルのロール を参照してください。 組織の自動レビューのルールと除外ルールを管理するには、Manage analysis rules 組織権限 が必要です。built-in の Review manager 組織ロールには、メンバー権限に加えてこの権限が付与されています。
Enterprise アカウント: 組織の Review manager は、プライマリ組織の管理者でなくても、 許可されたスコープを設定できます。ただし、投稿のデフォルトやレビューの前提情報に関する指示など、 アカウント全体のコントロールには、引き続きアカウントレベルの Manage Review が必要です。 エンタープライズのポリシーにより、organization-level の編集が禁止される場合があります。

コスト管理

Devin Review は、Devin セッションや他の Devin 製品で利用されるものと同じ、お使いの エンタープライズ の ACU プールから ACUs (Agent Compute Units) を消費します。Enterprise 管理者は、レビュー コストを監視および管理するためのツールを複数利用できます。
エンタープライズ の組織および消費量のコントロールを利用するには、Devin Enterprise アカウントが必要です。PR ごとの自動レビューの支出上限は、 利用枠ベースのプランにも適用されます。エンタープライズプランについては、営業担当にお問い合わせください。
Devin Review には、最初のレビュー時に開始される 14 日間の無料トライアルがあります。トライアル終了後は、分析にクレジットが消費されます。

消費量ダッシュボード

Settings > Consumption にある Enterprise の消費量ダッシュボードでは、製品ごとの ACU 使用量の内訳を確認でき、日次の消費量グラフには Review 専用の項目も表示されます。組織の管理者は、Settings > Consumption Analytics で自分の組織のレビュー消費量を閲覧できます。 このダッシュボードには次の項目が含まれます。
  • ユーザーごとの内訳 — 現在および前回の請求サイクルで、各ユーザーが消費したレビュー ACU 数を確認できます。
  • リポジトリごとの内訳 — 現在および前回の請求サイクルについて、リポジトリごとのレビュー ACU 消費量、レビュー数、検出されたバグの数を確認でき、どのリポジトリが最もレビューコストを押し上げているか、またレビューが最も多くの問題を検出しているのはどこかを特定するのに役立ちます。
Devin Review の使用量は、その請求先組織の 予算 にカウントされます。予算を使い切ると、フルレビューは実行されなくなります。詳しくは 予算を使い切った場合の動作 を参照してください。 Settings > Analytics > Review へのアクセス権がある場合は、そこで検出結果の対応状況 (修正済みや却下済みになった検出結果の数など) を確認できます。カスタムレビュアーで絞り込むとそのレビュアーの結果を、Autoapprover (利用可能な場合) を選択すると承認率と判定結果を確認できます。

レビューサイズの指標

Devin Review の各PRには、そのPR内のすべてのレビュージョブにおける ACU 総使用量に基づいたレビューのTシャツサイズを示す消費量バッジが表示されます。 サイズバッジにカーソルを合わせると、正確な ACU 合計、実行されたレビュージョブ数、現在表示中のレビューのコストを確認できます。これにより、レビュー担当者は、レビューの再実行や、変更が頻繁なPRでの 自動レビュー の有効化によるコストへの影響を把握できます。

PRごとの自動レビュー利用上限

管理者は、設定 > レビュー の Billing タブにある Automatic analysis limits で、1つのPRに対する自動レビューで Devin Review が消費できる量の上限を設定できます。この上限は、ACUベースのプランでは ACU、利用枠ベースのプランでは従量課金のドル額で測定されます。フィールドを空欄のままにすると、設定画面に表示される Cognition 管理のデフォルト値が適用されます。無制限になるわけではありません。 あるPRのすべてのレビュージョブにまたがる合計レビュー支出がこの上限に達すると、そのPRでは自動レビューがオフになり、以後の自動レビューはスキップされます。上限到達はソフトブロックです。
  • 手動レビューは引き続き利用できます — この上限で一時停止されるのは自動レビューだけです。PR review page からいつでも自分でレビューをトリガーできます。
  • PRごとに再度有効化 — PRのアクションメニューから自動レビューを再びオンにすると、レビューが再開され、予算の利用可能枠が追加されます。記録済みの支出はリセットされないため、新しい予算を使い切ると自動レビューは再び一時停止される場合があります。
使用量の表示には、レビュー使用量と上限のステータスが示されます。PR description updates が有効になっている場合は、PRの説明内にある Devin Review のステータス行にも、自動レビューが支出上限によって一時停止されたことが表示され、再度有効化するためのリンクも示されます。

レビューの実行レベルと請求先組織

レビュー設定の Analysis effort では、アカウントの Review manager がデフォルトの実行レベルとして Normal または Ultra を選択できます。Normal はコストパフォーマンスを重視し、Ultra はコストが高くなる代わりに、より徹底したレビューを行います。 Enterprise アカウントでは、Billing タブに Default billing organization for automatic analysis 設定もあります。この設定は、ほかの方法では請求先組織を決定できないレビューに適用され、変更にはアカウント設定の権限が必要です。組織のアトリビューションが有効な場合は、レビュー消費量の表示で、直近のレビューの請求先が、どの組織か (またはアカウント自体か) を確認できます。 Billing タブで Repository billing rules を利用できる場合、組織の Review manager は委任されたリポジトリのルールを編集し、Review の料金を、自身が管理する組織または予算のうち対象となるものに請求できます。ただし、自身が管理していない支払い元にすでに請求が設定されているルールは変更できません。

サポートされているGitプロバイダー

GitHub には GitHub.com、GitHub Enterprise Server、GitHub Enterprise Cloud が含まれ、いずれもこの表に記載のすべての機能を利用できます。スタック PR は GitHub.com でのみ利用できます。書き込み機能(コメント、レビュー、マージ操作、チャットによるコード変更)を利用するには、GitHub 組織に GitHub App をインストールして接続する必要があります。PAT ベースの接続は read-only です。また、Webhook を送信しないため、自動レビューも実行できません。 GitLab には GitLab.com とセルフマネージド版GitLabが含まれます。リポジトリを Devin に接続し、個人の GitLab アカウントをリンクすると、ユーザー名義でのコメントやレビュー、サポート対象のワークフロー操作を行えます。接続の設定方法については、セルフマネージド GitLab 統合ガイドを参照してください。 マージトレインが有効な GitLab プロジェクトでは、Add to merge queue を使用すると、対象のマージリクエストを現在のパイプラインの完了後にトレインに追加できます。トレインに載っている間、Review ではそのリクエストが Queued と表示されます。パイプラインの実行中に、Review がトレインへの追加を予約することはありません。マージ方法は GitLab が選択し、マージリクエストの既存の squash 設定がそのまま使用されます。 Azure DevOps には Azure DevOps Services(dev.azure.com)と Azure DevOps Server 2020/2022 が含まれます。Azure DevOps 連携、Microsoft Entra service principal、または個人用アクセストークンを使用した Azure DevOps Server コレクションのいずれかで接続し、設定 > レビュー から自動レビューの対象リポジトリを登録します。Devin は、接続されたサービス ID を使用して自動検出結果を投稿します。自分の名義でコメント、返信、スレッドの解決、PR への投票、PR の破棄を行うには、個人の Azure DevOps アカウントを Devin にリンクしてください。ユーザー名義の操作には、サポート対象の委任された Microsoft ID が必要です。共有のサーバー PAT はこれに該当しません。チャットでの編集は 1 つのコミットとして適用でき、アカウントをリンクしたユーザーは Review で自分の PR を一覧表示できます。マージ、ドラフト操作、自動マージは利用できません。 Bitbucket Data Center はバージョン 8.16 以降が必要で、Bitbucket 統合を通じて接続します。Devin Review から PR へのコメント、レビュアーの追加・削除、承認、却下を行うには、Bitbucketアカウントをリンクしてください。マージ、ラベル、担当者、リアクションは利用できず、チャットによるコード変更は 1 ファイルずつコミットされます。 Bitbucket Cloud(bitbucket.org)は Bitbucket 統合を通じてサポートされています。リポジトリの管理権限を持つアクセストークン、または OAuth でリンクした専用の Devinアカウントでワークスペースを接続し(自動レビューに必要な Webhook は Devin が自動でインストールします)、設定 > レビュー から自動レビューのルールを追加します。Devin Review からのコメント、返信、PR の却下は、あなた自身の Bitbucket アカウントを使ってあなたの名義で投稿されます。レビュアーのリクエスト、マージ、ドラフト操作、自動マージ、ラベル、担当者、リアクションは利用できません。チャットによるコード変更は 1 つのコミットにまとめてコミットされます。 Perforce Swarm では、接続のサービス ID を使用したレビュー分析と自動検出結果の投稿に対応しています。このプロバイダーでは、Devin Review の UI は人によるコメントや承認操作に関して read-only であり、チャットでの編集をコミットとして適用することはできません。Swarm のレビューは個人の PR 受信トレイには表示されません。Perforce 接続は一部のアカウントでのみ利用できます。