code-review について
code-reviewは、ステージ済みの変更またはコードベースの指定範囲をレビューするスキルです。指摘を重大度とファイルごとに整理し、指定したコマンドラインツールにレビューを委任できます。
主な機能
- 01ステージ済み差分または指定機能のレビュー
- 02直近のコミットを確認して文脈を把握
- 03指摘を重大度とファイル別に整理
- 04コマンドラインツールへのレビュー委任
- 05指摘とマージ可否の要約
活用シーン
- 01コミット前のステージ済み変更の確認
- 02機能に関連するファイルのレビュー
- 03別のCLIエージェントへのレビュー委任
- 04コード上の問題の優先順位付けと報告
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ unlearndev/ skills --skill code-reviewインストール後、Claude Code で/code-reviewを入力して読み込まれたか確認します。
詳細
コードレビュー
コンテキスト
ステージ済みの差分:
!git diff --cached
最近のコミット(コンテキスト用):
!git log --oneline -10
引数
生の引数:$ARGUMENTS
引数は次のように解析します。
- エージェント(省略可、最初の引数):レビューを委任する CLI コマンドまたはエージェント名です。認識される値:
claude、self、または空 — このコンテキスト内で直接レビューを実行します(デフォルト)- 上記以外の値 — CLI コマンド名として扱います(例:
codex、aider、goose)。レビューは Bash 経由でそのコマンドを呼び出して委任されます(「委任」セクションを参照)。
- 機能(省略可、エージェントの後に続く引数):レビュー対象となるコードベースの部分の説明です(例:「投票機能」、「認証」、「API エンドポイント」)。指定した場合は、この機能に関連するすべてのファイルを探してレビューします。空、または省略された場合は、ステージ済みの変更をレビューします。
引数が1つだけで、既知のエージェント名(claude、self)に一致しない場合は、その引数を機能として扱い、エージェントはデフォルトの claude にします。
指示
レビュー対象を決定する
- 機能が指定されている場合 — Glob と Grep を使って説明された機能に関連するすべてのファイルを探します。それらのファイルを読み、既存のコードとしてレビューします。
- 機能が指定されておらず、ステージ済みの変更がある場合 — 上記に示されたステージ済みの差分をレビューします。
- 機能が指定されておらず、ステージ済みの変更もない場合 — ユーザーに「レビュー対象がありません。変更をステージするには
git addを実行するか、レビューする機能を指定してください(例:/code-review voting functionality)。」と伝えて、そこで終了します。
レビューを実施する
必要に応じて周辺のソースファイルを読み、コンテキストを把握します。指摘事項はファイルごと、次に重大度ごとに整理します。
重大度レベル
- 🔴 Critical — バグ、セキュリティ上の脆弱性、データ損失のリスク、またはクラッシュです。必ず修正する必要があります。
- 🟠 Error — ロジックエラー、エラーハンドリングの欠落、壊れたエッジケースです。問題を引き起こす可能性が非常に高いものです。
- 🟡 Warning — コードの問題、パフォーマンス上の懸念、潜在的なエッジケース、保守性の問題です。
- 🔵 Suggestion — より良い方法、読みやすさの改善、慣用的な代替案です。
- ⚪ Nitpick — スタイル、命名、フォーマット、細かな好みです。対応は完全に任意です。
出力形式
重大度ごとに指摘事項をまとめます。指摘事項がある重大度レベルは、それぞれ独立した見出しにします(例:## 🔴 Critical、## 🟠 Error など)。各重大度の見出しの下に指摘事項を列挙します。各指摘事項には、次の内容を含めます。
- ファイルと行番号
- 問題の簡潔な説明
- 該当する場合は、修正案または代替案
指摘事項のない重大度の見出しは省略します。
最後に ## Summary セクションを設け、全体的な評価、変更をマージして問題ないか(またはコードが健全か)、重大度ごとの指摘件数を記載します。
委任
エージェントが claude/self/空のいずれでもない場合、CLI コマンド名として扱います。次のように、そのコマンドを Bash 経由で呼び出してレビューを委任します。
- レビューの指示、重大度レベル、出力形式、およびステージ済みの差分または機能の説明を含むプロンプトを作成します。
- 次を実行します:
<agent> -q "<prompt>"(<agent>はユーザーが指定した CLI コマンドです。例:codex、aider、goose) - コマンドの実行が終わったら、その指摘事項をそのままユーザーに伝えます。
コメント
Markdown 対応