Bitbucket Cloud の Rovo Dev のコードレビュー
Atlassian の AI エージェント Rovo Dev は、Bitbucket Cloud のプルリクエストをレビューし、品質・セキュリティ・性能の問題にコメントを付けられます。有効にするのは2か所で、ワークスペースと、リポジトリごとです。以下は、Atlassian の Activate code reviews in your repository、Trigger a code review、Troubleshoot Rovo Dev code reviews(いずれも英語)からまとめたものです。Atlassian のページが挙げるのは Bitbucket と GitHub で、Bitbucket Data Center には触れていません。
有効にする
Atlassian のサイトに Rovo Dev があり、Bitbucket が Jira とつながっている必要があります。そのうえで:
- ワークスペース(ワークスペースの管理者):Settings → Workspace settings → Atlassian integrations → Rovo Dev。Rovo Dev credits で Jira のサイトを選び、Use Rovo Dev in this workspace をオンにします。
- リポジトリ(Rovo Dev Admin の権限が要る):Repository settings → Rovo Dev code review で、AI code reviews in this repository をオンにします。ワークスペースの Rovo Dev のページの Activate code review for all repositories か、Activate for all eligible repositories(コードレビューを一度も有効にしておらず、自分がリポジトリの管理者のもの)でもまとめて有効にできます。
動くとき
- Only when pull request is created(既定):プルリクを開いたときに1回。後のコミットではレビューしません。
- When pull request is created and on each commit:新しいコミットのたびにもレビューします。
- Don't review automatically:作成者が始めたときだけ。
手で始めるには、プルリクの作成者が、プルリクの Overview タブの Rovo Dev の欄で Review code を押し、数分待ってページを読み直します。始められるのは作成者だけです。1つのコミットのレビューは1回なので、コミットのたびにレビューする設定のリポジトリでは、手では始められません。(Atlassian の有効化のページは、作成者が @atlassian /review とコメントすると書いていますが、レビューの始め方のページでは、そのコメントは GitHub の方法です。)
誰のクレジットが減るか
レビューは、プルリクの作成者の Rovo Dev クレジットの割り当て(Rovo Dev credits で選んだ Jira のサイト)から引かれます。減らしたいなら、プルリクを作ったときだけか、手で始めたときだけにします。
コメントが付かない理由
- 言うことが無い。指摘が無ければ、Rovo Dev はコメントを残しません。
- 大きすぎる。変更が 9,000 行を超えるプルリクや、20 GB を超えるリポジトリでは、コメントが付かないか、「プルリクが大きすぎる」というコメントになることがあります。プルリクを分けます。
- クレジットのサイトが無い。Rovo Dev Agents のベータから移ったワークスペースは、Rovo Dev credits にサイトが選ばれていないことがあります。選んでからレビューをやり直します。
- 回数の上限。Rovo Dev がレビューするのは、ワークスペースで1分におよそ10件までです。数分待ちます。
- クレジット切れ。使用量のリセットを待つか、管理者に上限を上げてもらいます。請求や契約の問題でも止まります。
- システムのエラー。数分待ってやり直します。続くなら、リポジトリの管理者がコードレビューをいったんオフにしてオンに戻します。
Standard プランで使えるもの
次の2つは、プルリクの作成者が Rovo Dev Standard プラン(ワークスペースにつながった Jira のサイトのもの)である必要があります:
- 受け入れ条件:プルリクが Jira の作業項目とつながっていれば、Rovo Dev はコードがその要件や受け入れ条件を満たすかを確かめます。
- 独自の指示:リポジトリの一番上の
.rovodev/.review-agent.mdに、チームの決まりや無視してよいことを書きます。
Rovo Dev のコメントを IntelliJ IDEA で見るなら
Pull Request Inbox for Bitbucket は、Lesstep が作っている JetBrains IDE(2024.1 以降)のプラグインで、自分の AI は持っていません。Bitbucket Cloud と Data Center のプルリクを、コメントのスレッドごと IDE に出すので、Rovo Dev のコメントも人のコメントと一緒に、スレッドの一覧と差分の横に出ます。どのコメントでも、コードの提案には、どの行を置き換えるかを添えます。レビューの受信箱とコメントを読むのは無料、コメント・返信・解決・承認・マージは Pro(月 US$1.50・30日間の無料試用つき)です。画面は日本語です。
Bitbucket・Jira・Rovo・Atlassian は Atlassian の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは Atlassian・JetBrains のいずれとも提携しておらず、承認も受けていません。
ほかに:コードの提案 · コメントの解決 · IntelliJ IDEA の Bitbucket プルリク用プラグインの比較 · English