code-review

code-review skill の概要

code-review skill でできること

code-review skill は、CodeRabbit を中心に構築された AI ベースのレビュー用ワークフローです。変更されたコードをバグ、セキュリティ問題、品質リスクの観点で確認し、見つかった指摘を重大度ごとに整理することで、一般的なプロンプトベースの批評よりも実行しやすい形で出力できます。

どんな人に向いているか

PR、ローカルブランチ、ステージ済みコミット、特定の差分範囲に対して、素早く構造化されたレビューを行いたいなら code-review skill が向いています。汎用モデルから場当たり的なコメントをもらうよりも、再現性のあるレビュー挙動が必要なときに特に有効です。

インストール前に確認すべき理由

ここで本当にやりたいことは「コードを要約する」ことではなく、「重要な変更部分にある、対処可能な問題を見つける」ことです。だからこそ、レビューのトリアージ、重大度の順位付け、そして手動の誘導を少なくできるワークフローを重視するなら、code-review for Code Review は相性のよい選択肢になります。

code-review skill の使い方

CLI をインストールして確認する

まずは公式の CodeRabbit CLI ソースにある code-review install の手順から始め、そのうえでバイナリを検証してから使います。

coderabbit --version 2>/dev/null || echo "NOT_INSTALLED"
coderabbit auth status 2>&1

CLI がすでに入っている場合でも、公式ソース由来の想定バージョンであることを確認してください。--agent フラグには CodeRabbit CLI v0.4.0 以降が必要なので、古い環境ならエージェント主導のレビューを試す前にアップグレードが必要です。

レビュー対象を正しく渡す

code-review usage のパターンは、ステージ済みファイル、コミット済み変更、ベースブランチ、コミット範囲、レビュー用ディレクトリのように、差分の範囲を具体的に指定したときに最も効果を発揮します。「コードをレビューして」のような曖昧な依頼より、「直近のコミットをセキュリティとロジックバグの観点でレビューして」のほうが強いです。skill が具体的な diff に基づいて判断しやすくなるからです。

先に読むべきファイル

code-review guide を最大限活用するなら、まず SKILL.md を確認し、その後に README.md、AGENTS.md、metadata.json、そして存在する場合は rules/、resources/、references/、scripts/ フォルダも読みます。このリポジトリでは SKILL.md が要のファイルなので、運用上の詳細はそこに集約されている前提で見てください。

より良い依頼文に整える

良いプロンプトには、レビュー対象、注目したいリスク、期待する出力形式の3点が入っています。たとえば「code-review skill を使って、ステージ済み変更を correctness、security、regression の観点でレビューし、重大度の高い指摘を優先し、ファイル名と行番号を正確に含めてください」といった依頼です。こうしておくと、広い感想ではなく、実用的な指摘を返しやすくなります。

code-review skill の FAQ

code-review は手動レビューの代わりになるか？

いいえ。code-review skill は、バグの可能性、セキュリティリスク、品質問題を素早く見つけるのには向いていますが、アーキテクチャ上のトレードオフ、プロダクト意図、最終的なマージ判断には人間の判断が必要です。

どんな依頼が最も向いているか？

「この PR をレビューして」「この変更のバグを見つけて」「セキュリティ問題を確認して」のような、レビュー指向のタスクに最も向いています。自由度の高いブレインストーミングや、実際の diff を伴わないコード生成にはあまり向きません。

専門知識がなくても使えるか？

はい。正しいブランチ、コミット、またはステージ済み変更を指定できるなら、初心者でも code-review を使えます。主な失敗要因はスキルレベルではなく、対象が曖昧だったり、気にしているリスク領域を指定しなかったりすることです。

いつ使わないほうがよいか？

確認すべき具体的なコード変更がない場合、必要なのが高レベルな設計意見だけの場合、あるいはリポジトリのレビュー手順が skill の文脈に含まれていない特殊な社内ルールに依存している場合は、code-review は見送ってください。

code-review skill を改善する方法

入力をもっと具体的にする

code-review の出力を最も早く改善する方法は、何を重視したいかを明確に伝えることです。正確性、セキュリティ、性能、テスト不足、API 互換性、UX 回帰など、気になる観点をはっきり指定してください。特定の領域を重視したいなら、広くレビューを求めて優先順位を推測させるのではなく、明示したほうが確実です。

依頼前にスコープを絞る

より良い結果は、小さく定義された diff から得られます。直近のコミット、1つの機能ブランチ、単一サブシステムから先にレビューしてください。規模が大きく目的の異なる変更が混ざると、重要な問題とノイズの切り分けが難しくなります。

すぐ使える形式を指定する

そのまま実務で使える出力がほしいなら、重大度、ファイルパス、具体的な修正指示を求めてください。たとえば「blocking と high-priority の問題だけを返し、正確な位置と1文の修正案を付けてください」のように依頼すると、価値の低いコメントが減り、レビューの振り分けもしやすくなります。

1回目の結果を踏まえて再実行する

最初のレビューが広すぎるなら、「auth、data loss、test coverage に集中して」「スタイルのみのコメントは無視して」のように条件を足して絞り込みます。逆に、重要な論点を見落としていたなら、そのリスク領域を明示して code-review を再実行してください。次のパスが、汎用的な指摘ではなく狙いのあるレビューになります。