Claude Codeを使ったAIレビューがチームに定着した話

Claude Codeを使ったAIレビューがチームに定着した話
~自動化しないことで得られた恩恵~

めぐろLT #32 「AI時代のコードレビュー」＠三田 で発表した内容です。
https://meguro-lt.connpass.com/event/366355/

Transcript

1. Claude Codeを使ったAIレビューが チームに定着した話 ~自動化しないことで得られた恩恵~ Matsumoto Akinori / @akinoringoo
2. 自己紹介 Matsumoto Akinori（あっきー） / @akinoringoo 株式会社エヌケーエナジーシステム　CTO 登山 / キャンプ / ボドゲ が好き
3. 事業内容 購買サインを即キャッチ AIが成約を逃さない デジタルセールスルーム
4. この発表で伝えたいこと ①Claude Codeを実装だけでなく、コードレビューにも活用しましょう ②ローカルでAIにレビューしてもらうと良いことがあります
5. AI レビュー導入の目的と課題 レビュー負荷を低減させるためにAIレビューを導入したものの AIレビューの活用とチームへの定着には多くの課題があった... 差分単位の不具合検知や 見落とし防止には便利だけど 設計やアーキテクチャ理解は苦手 チーム方針と合わない 指摘が頻発して ノイズ化... AIが指摘しなかった箇所に 不具合や品質の低いコード が紛れ込んでいる AIの指摘内容が 難しくて 無視したり AIによるレビューの精度が低く使いづらかったり、AIのレビューを信頼できなかったりして、 結局は人力のレビューに頼ってしまいレビュー負荷がそれほど変わらなかった
6. Claude Code を使ったローカルAI レビュー カスタムスラッシュコマンドを使ったコードレビュー Claude Codeのカスタムスラッシュコマンドとして コードレビュー専用のコマンドを作成し、ローカル でのセルフレビューに活用。 Claude Codeとは？ Claude Codeは、コマンドラインで動かすことが できるコーディングに特化したAIエージェント AIセルフレビューの手順 カスタムスラッシュコマンド「code-review」の内容 プルリクエスト作成 レビューコマンドを実行してAIがレビュー 指摘事項を修正して再度AIレビュー 他メンバーにレビュー依頼
7. Claude Code を活用したコードレビューの結果 プロジェクトの方針や差分全体を踏まえた本質的なフィードバックが得られたことで、 ほかのメンバーへのレビュー依頼前に行うセルフレビューの品質が大きく向上した。 プロジェクトの方針(Claude.md)や差分全体を踏まえた 設計やアーキテクチャレベルのフィードバック 具体の改善提案
8. プルリクエストの作成 プルリクエストの作成 AIによる自動レビュー 手動でAIレビュー フィードバックを確認して修正 レビュー内容を深堀り フィードバックを修正 “ 自動化しない”AI レビューの運用で得られた恩恵 自動化されたAIレビュー 手動で行うAIレビュー ローカル ブラウザ ローカルでAIレビューを手動で行うことで、レビュー内容を納得行くまで深堀りすることが できた。さらに、そのままAIに修正させることができるため、AIレビューと指摘事項の修正 がやりやすくなったことで、チーム内で“使われるAIレビュー”として定着した。
9. まとめと今後の取り組み Claude Codeによるコードレビューによって、プロジェクトの方針や差分全体を踏まえた質 の高いフィードバックを得られた ローカルでAIによる一次レビューを行うことで実装者が納得いくまで内容の深堀りができ、 さらにフィードバックを元にAIに修正作業をさせられるため、レビューの品質が向上した。 また、レビュー指摘事項と実装者の修正内容をGitHub上でほかメンバーも確認できるため、 文脈把握や注目すべき点の理解が捗り、コードの認知負荷が低下した。 AIに読み込ませるプロジェクトルールのドキュメント（Claude.md）を育てる E2Eテストは手動で行っている部分が大きいため、AIを活用して動作確認の自動化を行う まとめ 今後の取り組み