コードレビュー・エージェント

コードレビュー・エージェント

GitHub PR を自動でレビューする仕組み。

アーキテクチャ

def summarize(text: str, style: str = "bullet") -> str:
    prompt = f'''
次の文書を {style} 形式で日本語要約してください。

<doc>
{text}
</doc>

出力フォーマット:
<summary>
{{...}}
</summary>
'''
    res = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=1024,
        messages=[{"role": "user", "content": prompt}],
    )
    return res.content[0].text

重要なプロンプト要素

• 役割: 「シニアエンジニアとしてレビューする」
• 観点: 正確性 / 可読性 / セキュリティ / パフォーマンス / テスト
• 出力: ファイル単位の指摘 + 全体サマリ
• 形式: GitHub Markdown で行番号付き
• 重要度フィルタ: high / med のみ報告 (low は省略)

例 (擬似コード)

wzxhzdk:1

既存ツール

• /review や /security-review スキル (Claude Code 内)
• claude-code-action (公式 GitHub Action)
• /ultrareview (より高度な並列レビュー)
• 各種商用サービス (CodeRabbit, Greptile, Bito 等)

公式 Claude Code Action

.github/workflows/claude-review.yml で公式アクションを呼ぶだけで PR レビューが動きます。

wzxhzdk:2

運用 Tip

• ノイズが増えると無視されるので、重要度フィルタ を入れる。
• 誤検知 に対する人間のフィードバックループを設ける。
• 大きな PR は 分割提案 から始めるのも有効。
• リポジトリの CLAUDE.md にコード規約を書くと、レビュー精度が向上。
• 機密リポでは API キーを Org Secret に。

自前実装する利点

• レビューフォーマットを完全制御
• 社内規約 (security policy 等) に合わせやすい
• 監査ログ・統計を取得可能

試す

レビュー設計を Claude に。