プルリクエストをレビューする
PRコメントからレビューを開始する
- GitHub のオープンなプルリクエストまたは GitLab のマージリクエストに、
/devin reviewという新しいコメントを投稿します。 - 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 への今後のプッシュでも自動的にレビューが行われるようになります。
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 に次のルールを追加します。
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 によって導入された安全でないデフォルト設定や設定不備
- 重大 — マージ前に修正すべき、確度の高い 脆弱性
- 警告 — 調査に値する 潜在的なセキュリティ上の弱点
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 がコメントと分析に使用する言語を選択できます。- 表示言語に従う (デフォルト) — レビューコメントは、表示言語の設定に従います。
- 特定の言語 — コメントの言語 ドロップダウンで言語を選択すると、表示言語ではなくその言語でレビューコメントが作成されます。
レビューへの対応
検出結果の解決
バグ タブでは、検出結果が対応状況ごとに一覧表示されます。- Needs your attention — あなたがトリアージする必要がある未対応の検出結果です。
- Devin is fixing — PR の Devin セッションが対応中の検出結果です。自動修正 を参照してください。
- Fixed — あなたまたは Devin が修正済みとしてクローズした検出結果です。
- Invalidated — あなたまたは Devin が修正不要としてクローズした検出結果です。
コメントとレビュー
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 は自動的にマージされます。マージ バーには、誰が有効にしたかを含む現在の自動マージのステータスが表示されます。
キーボード ショートカット
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がすべてマージされます。
コミットとコメントの帰属
- バグの検出、フラグ付け、自動アノテーションは、常に 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 が検出結果を自動的にトリアージし、修正・検証・あなたへのエスカレーションのいずれを行うかを判断します) です。この設定には、組織のデフォルトと個人の選択があります。- 組織単位 — 組織管理者は Settings > Devin の Pull requests でオン/オフを切り替えます。項目の説明にあるとおり、「This option configures the default for all users.」 (このオプションはすべてのユーザーのデフォルトを設定します) 。他のメンバーはこの設定を変更できません。Enterprise アカウントでは、組織ごとに個別のデフォルトを持ちます。
- 自身 — 自分のセッションから作成された PR については、設定 > 環境設定 の Devin セッション でオン/オフを切り替えます。変更するまでは、スイッチに組織のデフォルトが表示されます。デフォルトと異なる値を選択すると Reset to organization default ピルが表示され、ホバーすると説明を確認できます。このピルをクリックするか、スイッチを組織の値に戻すと、再び組織の設定に従うようになります。自分の選択はオン・オフどちらの場合も優先され、デフォルトがオフの組織で自分だけオンにすることもできます。
Devin で自動修正 を使うと、Automatically fix Devin Review findings
がオフの場合は、自分に対してこの設定もオンになります。
Devin 自身の PR に対する検出結果
PR を作成した対象セッションがある場合、新しい検出結果は個別に投稿される前に、そのセッションに引き渡されます。GitHub では次のように動作します。- PR に Devin is fixing と表示され、検出結果は バグ タブの Devin is fixing に移動します。
- セッションのオーナーに対して Automatically fix Devin Review findings がオンになっており、PR の監視がアクティブな場合、セッションは対処可能な検出結果を修正し、各検出結果への判断を記録します。
- Devin は修正内容をまとめたレビューを 1 件投稿し、詳細を Fixed by Devin の下に記載します。あなたの対応が必要な検出結果は、投稿設定に従ってレビューコメントとして投稿されます。Devin が無効と判断した検出結果は投稿されません。
権限と制約
- 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 を選択できます。フォローアップレビューの対象範囲については、次のプッシュ時の動作を参照してください。
自己登録 (すべてのユーザー)
アカウントで個人登録が有効になっている場合、Git プロバイダの ID をリンク済みで、適切なレビュー利用ティアを持つユーザーは、管理者権限がなくても自分で登録できます。- 設定 > 環境設定 に移動します。
- Devin Review で、Analysis trigger を Analyze PRs automatically when opened または Analyze PRs automatically when ready for review に設定します。
- 権限で許可されている場合は、Analysis frequency を Only once または Every push に設定します。
スコープが限定されたルールと除外ルール
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 ブランチポリシー (genredevin、nameDevin Review) で必須に設定できます。他のアイデンティティがこのポリシーを満たせないよう、ポリシーの Authorized identity には Devin が投稿に使用するアカウントを設定してください。 - Bugs — バグ (エラーや誤った動作の可能性が高いもの) を PR コメントとして投稿します。
- セキュリティ — セキュリティ脆弱性 とハードニングの提案を PR コメントとして投稿します。
- フラグ (要調査) — 要調査フラグ (詳しく確認する価値のある潜在的な issue) を PR コメントとして投稿します。
- フラグ (note) — note フラグ (対応が不要な場合もある参考情報) を PR コメントとして投稿します。
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.ymlgreptile.json
.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 の例:
カスタムレビュールール
設定 > レビュー の 前提情報 で、レビュー時に前提情報として読み込む追加ファイルを設定できます。これらのファイルパターンは カスタムレビュアー とは異なり、独自の検出結果を生成するレビュアーを定義するものではなく、背景情報を提供するためのものです。 リポジトリファイルを追加する手順:- レビュー設定の Review タブで 前提情報 を探します。
- Add 前提情報 を選択します。Add repository files が直接開くか、Repository files を選択できるメニューが表示されます。
docs/architecture/**/*.mdなどのファイル glob パターンを入力して追加します。
レビュー前提情報の指示 (Beta)
記述式のレビュー前提情報の指示は Beta 版で、利用にはベータアクセスが必要です。
リポジトリの指示ファイルは、これとは別に引き続き利用できます。
- 設定 > レビュー を開き、前提情報 セクションを表示します。
- 追加メニューを開き、Beta と表示された Managed instructions を選択します。
- タイトルとレビューのガイダンスを入力します。
- All repositories、または対象を絞ったリポジトリスコープを選択します。
- 前提情報を追加 を選択します。
カスタムレビュアー (ベータ版)
カスタムレビュアーは現在ベータ版です。レビュアーを作成または設定できない場合は、組織またはアカウントのReview managerにお問い合わせください。
レビュアーを作成する
- 設定 > レビュー を開き、Custom reviewers タブを選択します。
- Add reviewer を選択し、Name と説明 (任意) を入力します。
- Instructions で Plain text を選択してチェックする内容と無視する内容を記述するか、既存のスキルに基づいて動作させる場合は Repository skill または Organization skill (エンタープライズでは Enterprise skill) を選択します。
- Finding urgency を選択します。修正が必須の問題には Severe、調査すべきフラグには Moderate、提案や前提情報には Info を選びます。
- Create and enable を選択します。後で作業を続ける場合は Save as draft を選択します。
- レビュアーを開き、Rules を確認します。アカウント全体の Review を管理する権限がある場合、新しいレビュアーは Run with Devin Review がオンの状態で作成されるため、すべてのレビューに参加します。特定のプルリクエストに限定するには、これをオフにして Add reviewer rule を選択します。それ以外の場合、レビュアーはルールがない状態で作成されるため、ルールを追加してチェック対象のプルリクエストを指定します。
スキルを再利用する
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 — 検出結果がすべてクローズされると成功となります。
支出上限
各レビュアーの 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 のみです。
Version History とアーカイブ
レビュアーのページで Last updated on … を選択すると、その Version history が開きます。ここには指示の直近 20 件のバージョンが表示され、各バージョンには直前のバージョンからの変更内容が示されます。Restore を選択すると、以前のバージョンの指示が新しいバージョンとして保存されます。スキルに従っているレビュアーは、そのスキルへの追従を解除するまで以前のバージョンを復元できません。 設定を残したまま今後の実行を止めるには、レビュアーを無効にします。アーカイブすると、レビュアーはレビュアーリストの下にある Archived reviewers に移動し、実行が停止します。すでに投稿された検出結果はそのまま残ります。アーカイブしたレビュアーを Restore で復元すると無効の状態で戻るため、有効にするまで再び実行されることはありません。Autoapprover (Beta)
Autoapprover は Beta 版であり、利用にはベータアクセスが必要です。
- 意図: 変更内容は PR 作成者が示した意図と一致しているか?
- コード品質: 変更後もコードベースの保守性とレビューのしやすさが保たれているか?
- インシデントリスク: 変更に含まれる問題が、信頼性やセキュリティのインシデントを引き起こす可能性はないか?
Autoapprover のセットアップ
- 設定 > レビュー を開き、Autoapprover タブを選択します。タブに Autoapprover がまだアカウントで利用できない旨が表示される場合は、アカウントにベータ版へのアクセス権がありません。
- 評価対象とするリポジトリと PR の条件を選択して、Autoapprover ルールを追加します。
- 必要に応じて、評価対象から常に除外したいプルリクエストを指定する Autoapprover 除外設定を追加します。
任意のカスタム指示
デフォルトの評価基準を調整するには、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 — 人間が承認しました。
権限とコスト
権限
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 ごとの自動レビューの支出上限は、
利用枠ベースのプランにも適用されます。エンタープライズプランについては、営業担当にお問い合わせください。
消費量ダッシュボード
Settings > Consumption にある Enterprise の消費量ダッシュボードでは、製品ごとの ACU 使用量の内訳を確認でき、日次の消費量グラフには Review 専用の項目も表示されます。組織の管理者は、Settings > Consumption Analytics で自分の組織のレビュー消費量を閲覧できます。 このダッシュボードには次の項目が含まれます。- ユーザーごとの内訳 — 現在および前回の請求サイクルで、各ユーザーが消費したレビュー ACU 数を確認できます。
- リポジトリごとの内訳 — 現在および前回の請求サイクルについて、リポジトリごとのレビュー ACU 消費量、レビュー数、検出されたバグの数を確認でき、どのリポジトリが最もレビューコストを押し上げているか、またレビューが最も多くの問題を検出しているのはどこかを特定するのに役立ちます。
レビューサイズの指標
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のアクションメニューから自動レビューを再びオンにすると、レビューが再開され、予算の利用可能枠が追加されます。記録済みの支出はリセットされないため、新しい予算を使い切ると自動レビューは再び一時停止される場合があります。
レビューの実行レベルと請求先組織
レビュー設定の Analysis effort では、アカウントの Review manager がデフォルトの実行レベルとして Normal または Ultra を選択できます。Normal はコストパフォーマンスを重視し、Ultra はコストが高くなる代わりに、より徹底したレビューを行います。 Enterprise アカウントでは、Billing タブに Default billing organization for automatic analysis 設定もあります。この設定は、ほかの方法では請求先組織を決定できないレビューに適用され、変更にはアカウント設定の権限が必要です。組織のアトリビューションが有効な場合は、レビュー消費量の表示で、直近のレビューの請求先が、どの組織か (またはアカウント自体か) を確認できます。 Billing タブで Repository billing rules を利用できる場合、組織の Review manager は委任されたリポジトリのルールを編集し、Review の料金を、自身が管理する組織または予算のうち対象となるものに請求できます。ただし、自身が管理していない支払い元にすでに請求が設定されているルールは変更できません。サポートされているGitプロバイダー
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 接続は一部のアカウントでのみ利用できます。
