Claude Code Skills × Bedrockで実現するドメイン特化のPR自動レビュー

はじめに

こんにちは、ブランドソリューション開発本部ZOZOMO部FBZブロックの池上寛登です。2026年3月にZOZOへ入社し、Fulfillment by ZOZO（以下、FBZ）のバックエンド開発を担当しています。

FBZに参画してまず直面したのは、ドメイン知識の壁でした。中でも強く実感したのが、コードレビューの場面です。Pull Request（以下、PR）のレビューには、判断の根拠がドキュメントに載っていない「暗黙知の壁」がありました。既存メンバーの指摘は的確ですが、新規参画者の自分には同じ品質でレビューする難しさがありました。

この課題を解決するために、暗黙知を形式知としてガイドライン化し、Claude Code SkillsとAmazon Bedrockに組み込んだPR自動レビュー基盤を作成しました。本記事では、その仕組みと設計判断を紹介します。

背景：FBZにおけるPRレビューの課題

FBZはZOZOTOWNの倉庫リソースを活用し、外部のブランドが運営する自社ECへ物流・決済・返金などの機能を提供するフルフィルメントサービスです。在庫同期・注文管理など、扱うドメインは多岐にわたります。

さらにFBZは複数のリポジトリで構成されており、リポジトリごとに採用言語やアーキテクチャが異なります。PRレビューで見るべき観点もリポジトリごとに大きく変わるため、レビュアーには横断的な知識が求められます。

実装やレビューの参考になるようなガイドラインは存在したものの、リポジトリごとに保存場所が異なり、内容の鮮度や粒度も統一されていませんでした。結果として、判断はレビュアー個人の経験知に大きく依存し、次の3つの課題が顕在化していました。

レビュアーごとに観点が異なり、レビュー品質にばらつきが出る
レビュアーごとに観点が異なり、レビュー品質にばらつきが出る
新規参画者がドメイン知識をキャッチアップするまでに時間を要する
新規参画者がドメイン知識をキャッチアップするまでに時間を要する
同じアンチパターンの指摘が、異なるPRで繰り返し発生する
同じアンチパターンの指摘が、異なるPRで繰り返し発生する

アプローチの全体像

これらの課題に対し、ガイドラインを中心に据えたPR自動レビュー基盤を構築しました。

PR自動レビュー基盤の全体構成

取り組みは大きく次の3層に分かれます。

ガイドラインの設計：暗黙知を形式知へ落とし込み、レイヤー別ファイルとNG/OKペアで定義する
ガイドラインの設計：暗黙知を形式知へ落とし込み、レイヤー別ファイルとNG/OKペアで定義する
実行基盤の構成：Claude Code Actionを実行し、関連するガイドラインを読み込んでPRをレビューする
実行基盤の構成：Claude Code Actionを実行し、関連するガイドラインを読み込んでPRをレビューする
ガイドライン更新の自動提案：過去のレビューコメントからガイドラインの更新提案を自動生成し、ルールの陳腐化を防ぐ

Claude Code Skills × Bedrockで実現するドメイン特化のPR自動レビュー