review について
reviewは、目標、アーキテクチャ、実装、品質、セキュリティ、パフォーマンスの順にコード変更を評価するスキルです。変更の規模に応じてレビューの深さを調整し、具体的な根拠を確認したうえで判定します。
主な機能
- 01ベースブランチとの差分に基づく変更レビュー
- 02順序に沿った6段階のレビュー
- 03プロジェクトの規約と標準の適用
- 04行番号と影響を伴う指摘の検証
- 05変更範囲に応じたレビュー深度の調整
活用シーン
- 01マージ前の機能ブランチのレビュー
- 02変更によるセキュリティと性能への影響評価
- 03CIまたは手動レビュー向けの根拠ある判定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ elliottlawson/ open-review --skill reviewインストール後、Claude Code で/reviewを入力して読み込まれたか確認します。
詳細
レビュー
変更内容を各パスに照らしてレビューし、結果を総合して判定します。
参照されているスキルがローカルにない場合は、実行時に open-review リポジトリから取得してください。サブディレクトリを含むディレクトリ全体を取得します。npx が利用可能な場合は npx skills use elliottlawson/open-review@<name> を使用し、利用できない場合は GitHub からディレクトリを取得してください。
対象範囲
変更内容は、ベースブランチとのマージベースに対する差分です(git diff origin/main...HEAD、または呼び出し元が指定するベース/範囲)。参照が解決できることを確認してください。差分が空の場合は、その旨を伝えて終了してください。生成ファイルとベンダー提供ファイルは対象外です。
ステップ 0 — プロジェクトの参考資料を確認する
/infer-conventions を使用して、プロジェクトの規約と技術スタックを確認してください。読み込まれた内容は各パスで使用してください。プロジェクトに文書化された規約がない場合は、独自に作り上げず、その旨を判定に記載してください。
パス
次の順に実施します。ミッション → アーキテクチャ → 実装 → クラフト → セキュリティ → パフォーマンス。次に、結果を総合して判定します。
- 承認 — ミッションを達成しており、阻害要因となる指摘はありません。
- 要修正 — 実際の問題が見つかりました。内容を明記してください。
- 保留 — ミッションが不明確、またはアーキテクチャ上の懸念について、先に議論が必要です。
深さの調整。 対象範囲に応じて深さを調整してください。2 ファイルのバグ修正なら簡潔に、30 ファイルに及ぶ機能なら詳細にレビューします。
指摘する前に検証する。 指摘には、具体的な行と具体的な影響が必要です。検証できない場合は、質問として提示してください。
報告
指摘内容は文章で報告してください。深刻度(critical/warning/info)、検出したパス、ファイルと行番号、そして重要な理由を記載します。
- コードベースではなく変更を評価する。 阻害要因となる指摘は、新たに追加または実質的に変更されたコードに限ります。既存の違反は、あっても助言にとどめてください。
- 規約を引用し、目指すパターンを示す。 プロジェクトに文書化された規約がある場合は、指摘で違反している文書を挙げ、代わりに従うべきパターンを示してください。
- 繰り返し発生する問題は一度だけ報告する。 複数のファイルに同じ問題がある場合は、共通の指摘としてまとめ、その適用範囲を記してください。
CI 環境では、/review-as-json がこのレビューを JSON 形式でラップし、出力を整形します。