mcpField
R
review

review

github.com/elliottlawsonテスト・品質0334 回インストール12 週間前に更新
リポジトリ

review について

reviewは、目標、アーキテクチャ、実装、品質、セキュリティ、パフォーマンスの順にコード変更を評価するスキルです。変更の規模に応じてレビューの深さを調整し、具体的な根拠を確認したうえで判定します。

主な機能

  1. 01ベースブランチとの差分に基づく変更レビュー
  2. 02順序に沿った6段階のレビュー
  3. 03プロジェクトの規約と標準の適用
  4. 04行番号と影響を伴う指摘の検証
  5. 05変更範囲に応じたレビュー深度の調整

活用シーン

  1. 01マージ前の機能ブランチのレビュー
  2. 02変更によるセキュリティと性能への影響評価
  3. 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 形式でラップし、出力を整形します。

コメント