mcpField
D
deep-review

deep-review

github.com/anorthテスト・品質110 回インストール1 日前に更新
リポジトリ

deep-review について

deep-review は `/review-diff` スキルに追加のレビュー視点を加えます。変更内容に応じたテーマ別レビューに使い、`review-diff` が利用できない場合は停止します。

主な機能

  1. 01標準レビュー視点を strong tier で追加
  2. 02常時適用する cheap tier のテーマ
  3. 03差分に応じた条件付きテーマの選択
  4. 04review-diff の手順で確認と報告

活用シーン

  1. 01複数テーマにわたる変更セットのレビュー
  2. 02差分の命名、スタイル、コメントの確認
  3. 03該当する変更種別への重点チェック追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/anorth/agent-skills --skill deep-review

インストール後、Claude Code で/deep-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

themes/
change-scope.md
architecture.md
dependencies.md
concurrency.md
api-shape.md
comments.md
errors.md
coupling.md
developer-experience.md
invariants.md
observability.md
naming.md
style.md
tests.md

詳細

詳細レビュー

/review-diff スキルのフローを、より多くのレンズを使って実行します。 review-diff が利用できない場合は、その旨をユーザーに伝えて終了してください。

レンズの手順では、変更セットを読み、以下のテーマのうちどれが該当するかを判断します。レンズセットは次のとおりです。

  • review-diff のディレクトリにある絶対パスを指定した、strong ティアの標準レンズ。
  • Always の各テーマと、変更内容に該当する When the diff matches の各テーマ。いずれも cheap ティアで実行します。テーマファイルの絶対パスをレンズとして渡してください。

それ以外はすべて、モデル、起動、チェック、トリアージ、修正、報告を含め、review-diff に従います。 cheap ティアのテーマレビュアーはノイズが多いため、特にチェックの手順が重要です。

Always

  • Naming — 識別子
  • Style — 不要なコード、定数、順序、局所性
  • Comments — コメント、ドキュメント、近くに残された古いコメント

When the diff matches

  • API Shape — 公開関数、型、エンドポイント、イベント、永続化形式
  • Architecture — モジュール、レイヤー、状態や副作用の配置
  • Change Scope — 1 つの PR に混在する機能、リファクタリング、クリーンアップ
  • Concurrency — 共有された可変状態、スレッド/コルーチン、タイマー
  • Coupling — モジュール境界、配線、コンポーネント間 API
  • Dependencies — マニフェスト、ロックファイル、ベンダーコードや生成コード、新しいライブラリ
  • CI locally — CI、ビルド、リンター、コード生成の手順
  • Errors — 新規または変更された失敗経路、エラー型、パニック
  • Invariants — 検証、状態遷移、永続化、集約
  • Observability — ログ、メトリクス、ジャーナル、握りつぶされた失敗
  • Tests — テスト、フィクスチャ、テストダブル、テストヘルパー

コメント