mcpField
S
semantic-review

semantic-review

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

semantic-review について

semantic-reviewは、明示的な依頼がある場合に限り、隔離された分析手順で完了済みのリポジトリ変更をレビューするスキルです。セマンティックレビューを求めるユーザー向けで、レビューの指摘を変更要求として扱います。

主な機能

  1. 01明示的な依頼時のみ実行
  2. 02デフォルトで隔離分析
  3. 03CLI・APIバックエンドの選択
  4. 04モデルと分析強度の指定
  5. 05ブラウザー上でのレビューと指摘処理

活用シーン

  1. 01検証後のリポジトリ変更のレビュー
  2. 02会話履歴を渡さない分析
  3. 03複数レビュー用バックエンドの比較
  4. 04レビュー指摘に基づく変更要求への対応

インストール

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

$npx skills add https://github.com/mikker/semantic-review --skill semantic-review

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

同梱ファイルagents/openai.yaml

詳細

セマンティックレビュー

このスキルは明示的なオプトインです。ユーザーが「semantic-review」を名前で明示的にリクエストしない限り、実行しないでください。

実装と検証が完了した後、リポジトリのルートからレビューを実行します。このスキルとともに渡された引数は、分析の生成方法に関する自然言語の希望として解釈してください。

分析の分離（デフォルト）

ユーザーがハーネスやモデルの希望を指定していない場合、分析をメインの会話から切り離し、分析器には実装の履歴を与えないでください。

  1. このスキルがすでにフォークまたはサブエージェントのコンテキストで実行されている場合は、以下の呼び出し元提供のワークフローを使って、そこで分析を生成します。
  2. そうでない場合は、--with claude、--with codex、--with gemini、または --with pi を使い、現在のハーネスを新しい非対話型で呼び出す方法を優先します。会話履歴は渡さないでください。CLI が分析を直接処理するため、呼び出し元提供のワークフローはスキップします。
  3. 現在のハーネスに CLI バックエンドがない場合は、ネイティブの分離されたサブエージェントを使い、出力されたプロンプトから JSON を生成します。
  4. 分離が不可能な場合に限り、メインのホスティングコンテキストで分析を生成します。
呼び出し元提供の分析ワークフロー
  1. リポジトリの外部に、一時的なプロンプトファイルと JSON ファイルを作成します。
  2. npx --yes semantic-review --emit-prompt [git diff args...] > <prompt-file> を実行します。
  3. プロンプトファイル全体を読み、自分でその指示に従います。Markdown のコードフェンスや説明を付けず、要求された JSON オブジェクトのみを JSON ファイルに書き込みます。
  4. プロンプトの生成からレポートを開くまで、ワークツリーを変更しないでください。
  5. npx --yes semantic-review --analysis <json-file> [the same git diff args...] を、長いタイムアウトを設定してフォアグラウンドで実行します。
  6. コマンドが終了したら、両方の一時ファイルを削除します。

git diff の引数を指定しない場合、両方のコマンドは HEAD に対するステージ済み、未ステージ、未追跡の変更をレビューします。ブランチをレビューするには、main...HEAD のような同じ範囲を両方のコマンドに渡します。カスタム範囲やパイプで渡した diff は、指定どおりにレビューされるため、未追跡の追加ファイルがあれば、それらも明示的に含まれていることを確認してください。

サイドカー分析

ユーザーがどのような表現であってもハーネスまたはモデルの希望を示した場合、その希望を独立したサイドカー呼び出しに反映します。モデル ID はそのまま渡してください。effort は low、medium、high、xhigh、max のいずれかにする必要があります。意図するハーネスまたはモデルが本当に曖昧な場合は、特別な構文を要求したり、黙って推測したりせず、ユーザーに選択を確認してください。

npx --yes semantic-review --with anthropic --model claude-sonnet-5 --effort medium
npx --yes semantic-review --with openai --model gpt-5.6
npx --yes semantic-review --with claude --model sonnet
npx --yes semantic-review --with codex --model gpt-5.3-codex-spark
npx --yes semantic-review --with gemini --model gemini-2.5-pro
npx --yes semantic-review --with pi --model google/gemini-2.5-pro

たとえば、「fable で Claude Code を使って」は --with claude --model fable を意味します。利用可能なバックエンドは anthropic、openai、claude、codex、gemini、pi です。CLI バックエンドは既存のローカル認証を再利用し、API バックエンドは ANTHROPIC_API_KEY／ANTHROPIC_AUTH_TOKEN と OPENAI_API_KEY を使用します。ユーザーがモデルを指定せずにバックエンドを指定した場合は、--model を省略し、そのバックエンドのデフォルトに任せてください。

複数のハーネスを比較するには、カンマ区切りのリストを指定します。モデル ID はバックエンドごとに異なるため、--model は追加しないでください。

npx --yes semantic-review --with anthropic,codex

ワークフロー

  1. 最終レビューコマンドを、長いタイムアウトを設定してフォアグラウンドで実行します。バックグラウンドでは決して実行しないでください。
  2. ブラウザーのレポートが開いている間は待機します。レビュアーが Done をクリックすると、コマンドが終了します。
  3. stdout を読みます。stderr のステータスメッセージやレビュー URL はフィードバックではありません。
  4. stdout にコメントなしでレビューが承認されたと記載されている場合は、完了です。
  5. それ以外の場合は、すべてのコメントを変更要求として扱います。要求された変更を行い、検証して、変更内容を要約します。
  6. フィードバックが不明瞭、矛盾している、または安全でない場合は、作業を進める前にユーザーに確認してください。

セマンティックレビューを、テスト、型チェック、通常のコードレビューの代わりに使用しないでください。

コメント

Markdown 対応