<h2 id="ai%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%A8%E3%82%B3%E3%83%BC%E3%83%89%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AE%E8%AA%B2%E9%A1%8C" data-line="0" class="code-line">
<a class="header-anchor-link" href="#ai%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%A8%E3%82%B3%E3%83%BC%E3%83%89%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AE%E8%AA%B2%E9%A1%8C" aria-hidden="true"></a> AI駆動開発とコードレビューの課題</h2>
<p data-line="1" class="code-line">AI駆動開発が当たり前になった今、コーディング自体はAIが担うケースが増えています。しかし、それに伴ってコードレビューの量も急激に増加しており、レビュアーの負荷が問題となっています。我々のチームでも大量のPRが発生し、しかも1つ1つの変更量が大きいという状況でした。<br>
我々のチームでは、Claude Code Actionsを活用したコードレビューの自動化により、この課題の改善を図りました。</p>
<h3 id="claude-code-actions" data-line="4" class="code-line">
<a class="header-anchor-link" href="#claude-code-actions" aria-hidden="true"></a> Claude Code Actions</h3>
<p data-line="5" class="code-line">Claude Code Actionsはこの問題を解決する有力な選択肢ですが、デフォルト設定では実用面で少し物足りない部分もあります。具体的には、</p>
<ul data-line="7" class="code-line">
<li data-line="7" class="code-line">全体的なコメントのみで、インラインでの具体的な指摘ができない</li>
<li data-line="8" class="code-line">どの観点でのレビューなのか、どの程度の優先度で対応すべきかが不明確</li>
</ul>
<p data-line="10" class="code-line">これらの課題を解決するため、カスタムインストラクションを適用してみましょう。</p>
<h2 id="%E5%AE%9F%E8%A3%85%E5%86%85%E5%AE%B9" data-line="12" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85%E5%86%85%E5%AE%B9" aria-hidden="true"></a> 実装内容</h2>
<p data-line="13" class="code-line">例えばWebアプリ開発のレポジトリでは以下のような設定を使用しています：</p>
<div class="code-block-container"><pre class="language-yaml"><code class="language-yaml code-line" data-line="14"><span class="token punctuation">-</span> <span class="token key atrule">uses</span><span class="token punctuation">:</span> anthropics/claude<span class="token punctuation">-</span>code<span class="token punctuation">-</span>action@beta
  <span class="token key atrule">with</span><span class="token punctuation">:</span>
    <span class="token key atrule">model</span><span class="token punctuation">:</span> <span class="token string">"claude-sonnet-4@20250514"</span>
    <span class="token key atrule">custom_instructions</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
      必ず日本語でレビューしてください。
      このPRをレビューして、GitHubレビューシステムを利用してインラインフィードバックを提供してください。以下の手順に従ってください：
      1. **レビューを開始**: `mcp__github__create_pending_pull_request_review`を使用して保留中のレビューを開始します
      2. **差分情報を取得**: `mcp__github__get_pull_request_diff`を使用してコードの変更点と行番号を理解します
      3. **インラインコメントを追加**: 特定の行に対する具体的なフィードバックについて、`mcp__github__add_comment_to_pending_review`を使用します
      4. **レビューを提出**: `mcp__github__submit_pending_pull_request_review`を使用して、イベントタイプ"COMMENT"（"REQUEST_CHANGES"ではない）ですべてのコメントを非ブロッキングレビューとして公開します
      具体的で実行可能なフィードバックを提供してください。行固有の問題にはインラインコメントを使用し、レビューを提出する際には全体的な要約を含めてください。
      **重要**: PRをブロックしないよう、"COMMENT"タイプで提出してください。
      **重要**: インラインコメントは以下の方法で記述してください(全体へのレビューでは使用しないこと):
        - どの観点でのインラインコメントかをラベルとして記述
          - **`📄 Code`**: コード品質とベストプラクティス
          - **`🛡️ Security`**: 潜在的なバグやセキュリティの問題
          - **`🚀 Performance`**: パフォーマンス
          - **`🔧 Maintainability`**: 保守性と可読性
          - **`🏛️ Architecture`**: アーキテクチャと設計の決定
        - インラインコメントへの対応要否を記述
          - **`🔴 CRITICAL`**: 対応必須
          - **`🟡 RECOMMEND`**: 推奨対応
          - **`🔵 OPTIONAL`**: 任意対応
          - **`🟢 FYI`**: 参考情報（対応不要）
      記述例: **`🚀 Performance`** **`🟡 RECOMMEND`**</span>
    <span class="token key atrule">allowed_tools</span><span class="token punctuation">:</span> <span class="token string">"mcp__github__create_pending_pull_request_review,mcp__github__add_comment_to_pending_review,mcp__github__submit_pending_pull_request_review,mcp__github__get_pull_request_diff"</span>
</code></pre></div><p data-line="43" class="code-line">レポジトリがAI開発の場合は、ラベルを少し変えて:</p>
<div class="code-block-container"><pre><code class="code-line" data-line="44">                - **`🔢 Data`**: データ品質（データの前処理、バリデーション等）
                - **`🔬 Reproducibility`**: 再現性（シード値の固定やパラメータの保存等）
                - **`🚀 Performance`**: パフォーマンス
                - **`🔧 Maintainability`**: 保守性と可読性
                - **`🤖 Model Design`**: モデル設計（アーキテクチャ、ハイパーパラメータ、学習戦略等）
</code></pre></div><p data-line="51" class="code-line">等で設定しています。ラベルは適宜見直すことを想定していますが、現状あまり大きな見直しは発生していません。</p>
<h3 id="%E5%AE%9F%E8%A3%85%E3%81%AE%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" data-line="53" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85%E3%81%AE%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" aria-hidden="true"></a> 実装のポイント</h3>
<h4 id="mcp%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%83%A9%E3%82%A4%E3%83%B3%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E6%A9%9F%E8%83%BD" data-line="54" class="code-line">
<a class="header-anchor-link" href="#mcp%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%83%A9%E3%82%A4%E3%83%B3%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E6%A9%9F%E8%83%BD" aria-hidden="true"></a> MCPによるインラインレビュー機能</h4>
<p data-line="55" class="code-line">4つのMCPツール（<code>create_pending_pull_request_review</code>、<code>get_pull_request_diff</code>、<code>add_comment_to_pending_review</code>、<code>submit_pending_pull_request_review</code>）を組み合わせることで、GitHubのレビューシステムと完全に統合されたワークフローを実現しています。これにより特定の行に対する具体的な指摘が可能になりました。</p>
<h4 id="%E6%A7%8B%E9%80%A0%E5%8C%96%E3%81%95%E3%82%8C%E3%81%9F%E3%83%A9%E3%83%99%E3%83%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0" data-line="57" class="code-line">
<a class="header-anchor-link" href="#%E6%A7%8B%E9%80%A0%E5%8C%96%E3%81%95%E3%82%8C%E3%81%9F%E3%83%A9%E3%83%99%E3%83%AB%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0" aria-hidden="true"></a> 構造化されたラベルシステム</h4>
<p data-line="58" class="code-line">各インラインコメントには2軸でラベルを付与しています。</p>
<ul data-line="59" class="code-line">
<li data-line="59" class="code-line">
<strong>観点ラベル</strong>: どの視点からの指摘か（📄 Code、🛡️ Security等）</li>
<li data-line="60" class="code-line">
<strong>優先度ラベル</strong>: 対応の緊急度（🔴 CRITICAL、🟡 RECOMMEND等）</li>
</ul>
<p data-line="62" class="code-line">これらの組み合わせにより、開発者はどの観点での指摘なのか、どの程度の優先度で対応すべきかが一目で判断できます。</p>
<h2 id="%E7%B5%90%E6%9E%9C" data-line="64" class="code-line">
<a class="header-anchor-link" href="#%E7%B5%90%E6%9E%9C" aria-hidden="true"></a> 結果</h2>
<p data-line="65" class="code-line">導入後、定性的ではあるのですが、チーム内で以下のような効果を実感しています。</p>
<h4 id="%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AE%E8%B3%AA%E5%90%91%E4%B8%8A" data-line="67" class="code-line">
<a class="header-anchor-link" href="#%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AE%E8%B3%AA%E5%90%91%E4%B8%8A" aria-hidden="true"></a> レビューの質向上</h4>
<p data-line="68" class="code-line">例えば、以下のようなレビューがClaude Codeから提供されます。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/599f4b7b47cd-20250904.png" class="md-img" loading="lazy"><br>
他にも、ラベルごとに以下のような指摘が行われています。</p>
<ul data-line="71" class="code-line">
<li data-line="71" class="code-line">
<strong>🚀 Performance + 🟡 RECOMMEND</strong>: 無駄なfor loopの検知等</li>
<li data-line="72" class="code-line">
<strong>🔧 Maintainability + 🔵 OPTIONAL</strong>: 変数名の改善提案等</li>
</ul>
<h4 id="%E5%8A%B9%E7%8E%87%E5%8C%96" data-line="74" class="code-line">
<a class="header-anchor-link" href="#%E5%8A%B9%E7%8E%87%E5%8C%96" aria-hidden="true"></a> 効率化</h4>
<p data-line="75" class="code-line">AIによるレビューなのでもちろん的外れな指摘もありますが、インラインレビュー＋ラベルシステムにより、指摘内容の妥当性を人が検証する時間も大幅に高速化されたと感じています。優先度ラベルがあることで、どの指摘に時間を使うべきかの判断も迅速になっています。</p>
<p data-line="77" class="code-line">我々のチームではPRがReadyになった段階で、上記のAIコードレビューを実施することをルールとして運用しています。AIレビューに対するレビュイーの対応等を見てから、再度人がレビューすることができるので、レビュー時間自体の短縮にもつながったと考えています。</p>


AI駆動開発でやったこと

Claude Code Actionsでコードレビューの負荷を下げる

AI駆動開発とコードレビューの課題

claude

Discussion