はじめに
AIにコードを書かせる開発、いわゆるAI駆動開発を続けていて感じるのは、開発のボトルネックが「書くこと」から「レビューすること」に移ったということです。書くのは速い。でも、そのコードを本当に信じていいのかを確かめる作業は、むしろ前より重くなりました。
そこで今回は、ServiceNowの備品貸出アプリを題材に、レビューをCodeRabbitに任せる仕組みを組んで開発してみました。コードの生成はClaude Code、レビューはCodeRabbit、人は指摘の評価と判断に集中する、という役割分担です。
結果として、CodeRabbitのレビューにはかなり助けられました。1回目のレビューで3件、修正後の再レビューでさらに2件。自分では気づきにくい指摘をもらえた上に、「直した箇所が次のレビュー対象になる」という往復まで回せたのが収穫です。この記事では、その仕組みと、助かった指摘の中身を紹介します。
今回の仕組み
まず全体の構成です。
登場人物は5つです。
- 人:作りたいものを言葉で伝える。レビュー指摘の採否を決める。直す範囲の線引きをする
- Claude Code:対話しながらコードを生成する。GitHubのブランチへコードを反映し、指摘を受けての修正も担当する
- GitHub:コードの保管場所。変更はプルリクエストとして出す
- CodeRabbit:プルリクエストを自動でレビューし、要約と行ごとの指摘を付ける
- ServiceNow SDK:コードをビルドして、PDI(個人の開発用インスタンス)へデプロイする道具
前提:GitHubの進め方
この仕組みは、GitHubの進め方の上に乗っています。GitHubは、コードの保管庫(リポジトリ)をインターネット上に置いて共有するためのサービスです。似た名前のGitは、変更履歴を管理する仕組みそのもので、自分のPCの中で動きます。今回の開発では、変更の記録はGit、置き場所とレビューの場はGitHubという役割分担です。
GitHubのリポジトリには本流(mainブランチ)があります。作業するときは本流から枝(ブランチ)を切り、その中で変更を記録(コミット)して、GitHubへ送ります(push)。
作業がまとまったら、ブランチの変更を「本流へ取り込んでください」という提案として出します。これがプルリクエストです。取り込み(マージ)の前に差分を見てレビューできるので、問題があればこの段階で気づけます。今回の開発では、このプルリクエストのレビューをCodeRabbitが自動で担当しました。
この仕組みの肝は、プルリクエストを作ればCodeRabbitが自動でレビューを始めることです。レビューが「気合いを入れてやる作業」ではなく、開発の流れの中に組み込まれています。人は届いた指摘を1件ずつ評価して、直すものと直さないものを決めることに集中できます。なお、CodeRabbitはレビュー専任で、デプロイには関わりません。デプロイは開発側がServiceNow SDKで行います。
作ったもの
題材は、社内の備品貸し出しを管理する小さなアプリです。
- 備品テーブルと貸出記録テーブル
- 貸出時に返却期限を自動計算するBusiness Rule(備品ごとに3日・7日などの貸出日数を持つ)
- 貸出中の備品への二重貸出を防ぐBusiness Rule
- 貸出・返却に合わせて備品の状態を同期するBusiness Rule
- 備品をカード形式で一覧表示し、その場で借りる・返却できるService Portalのページ
開発はServiceNow SDK(Fluent)を使い、コードはGitHubリポジトリで管理しました。PDIへのデプロイはSDKのbuildとinstallで行います。
(ポータルの備品一覧画面。貸出中の備品には返却期限が表示され、自分が借りている備品は「あなたが貸出中」と区別される)
1回目のレビューで助かった指摘
コードが一通り書けたら、作業用ブランチからmainへプルリクエストを作ります。数分でCodeRabbitのサマリーと指摘コメントが付きました。対応が必要な指摘は3件です。
(プルリクエストに付いたCodeRabbitのレビュー。上半分が変更内容の要約、下が指摘コメントの一覧)
指摘1:操作後に画面が切り替わらない
ポータル画面のクライアント処理への指摘です。「借りる」を押しても、サーバー側の処理結果が画面のデータに反映されないため、カードの表示が「貸出中」に切り替わらず、再読み込みするまで古いままになる、という内容でした。
画面の見た目を作ることに集中していて、操作後の表示更新まで頭が回っていなかったところです。補足すると、Service Portalのクライアント処理には、応答を受けると画面のデータ(c.data)を自動で更新してくれる c.server.update() という呼び出し方もあります。ただ、この画面では取得系の c.server.get() を使っていたため、応答は自分で受け取って差し替える必要がありました。その書き方に直して修正しています。動かして初めて気づく類の不具合を、コードの段階で拾ってもらえました。
指摘2:存在しない備品でも貸出が作れてしまう
ポータルのサーバー処理への指摘です。リクエストで渡された備品のIDを検証していないため、存在しないIDを指定すると、参照先のない貸出レコードが作れてしまう、という内容でした。
通常の画面操作では起きないので、自分では完全に盲点でした。貸出を作る前に備品の存在を確認し、なければエラーを返すよう修正しました。
指摘3:二重貸出チェックの競合
Business Ruleへの指摘です。貸出中の備品がないかを検索してから登録する方式は、2件の貸出がほぼ同時に来ると両方とも検索を通ってしまい、二重貸出が成立し得る。もっと厳密な仕組みが必要だ、という内容でした。
原理的には正しい指摘で、自分の実装の前提を言語化してもらえたのが助かりました。その上で、ServiceNowのテーブル定義にはフィールドの一意制約はあるものの、「貸出中のものだけ」といった条件付きで一意にする設定はなく、標準機能だけでは簡単に防げません。貸出中だけ値を入れる専用フィールドに一意制約をかける、といった工夫も考えられますが、検証と運用の手間が増えます。このアプリの規模では過剰だと判断し、チェック自体は維持したまま、この限界をコード内のコメントに明記する形にしました。
なお、対応を検討する中で、備品の状態(貸出中かどうか)は貸出レコードのコピーにすぎず、実態からずれ得ることにも気づきました。最終的に、二重貸出の判定は貸出レコードへの問い合わせだけを正とする設計にしています。指摘をもらったからこそ、設計の前提まで見直せました。
指摘が正しいかどうかと、その指摘にどこまで対応するかは別の話で、線引きは人がやるしかありません。ただ、その判断の材料をそろえてくれるのがレビューの価値だと思っています。
再レビューで助かった指摘
修正をプルリクエストに反映したあと、プルリクエストに @coderabbitai review とコメントして再レビューを依頼しました(設定によっては、新しいコミットのpush時に自動で差分レビューが走る場合もあります。全体を最初から見直させたいときは @coderabbitai full review です)。すると新たに2件の指摘が返ってきました。どちらも、1回目の指摘への対応そのものに対する指摘です。
1つ目は、応答の競合です。表示を差し替えるよう直したことで、今度は「借りる」を続けて押した場合に、2つの応答が順不同で返ってくると、古いスナップショットが新しい表示を上書きし得る、という指摘でした。処理が終わるまで次の操作を受け付けないよう直列化して対応しました。自分の修正が新しい問題の種になっていたわけで、これは再レビューがなければそのまま残っていました。
2つ目は、備品が実在するかを確認する処理の置き場所です。1回目の指摘でポータルのサーバー処理に足した「その備品が本当にあるか」の確認は、画面経由でない登録(Table APIなど)では素通りします。Business Rule側にも同じ確認を足して、どの経路からでも参照先のない貸出が作れないようにしました。直した場所だけでなく、仕組み全体を見て「同じ穴が他にないか」を考えてもらえた指摘です。
レビューは1回で終わりません。直した箇所が、次のレビューの対象になります。この往復が回ること自体が、仕組みの価値だと思っています。
最終的に、アプリはPDIへデプロイし、返却期限の自動計算や二重貸出の防止が動くところまで確認できました。
まとめ
今回、CodeRabbitのレビューで助かったことを整理します。
- 操作後の画面反映漏れや、入力値の検証漏れなど、自分では気づきにくいポイントを的確に拾ってもらえた
- 二重貸出チェックの競合のように、実装の前提を言語化してもらえたことで、設計の見直しまで進めた
- 対応範囲の線引き(今回は見送った厳密な排他制御)は人が決めるが、その判断材料がそろった
- 再レビューで、自分の修正が作った新しい問題まで拾ってもらえた
- プルリクエストを作れば自動でレビューが始まるので、レビューを仕組みとして回し続けられた
AIに書かせる速度が上がるほど、レビューの比重は上がります。そのレビューをCodeRabbitに任せることで、人は「指摘を評価して、どう直すか決める」ことに集中できました。AI駆動開発の相方として、レビュー専用のAIを入れるのは相性がいい、というのが今回の実感です。




