Universal Change Review

Codex、Claude Code、Cursor、およびMCP互換クライアント向けのローカルで読み取り専用のGit変更レビュー。バージョン0.4では、ワンクリックでChangesにアクセスできるエントリポイントとして、Cursorのアクティビティバー拡張機能と、互換性のあるCodex/ChatGPTホスト向けのMCP Appsランチャーカードが追加されました。

ワークスペース全体の差分、ステージ済み/未ステージ表示、ファイルレベルの検査、タスク開始後の変更のみを切り出すタスクスコープのスナップショットを提供します。ソースファイルと実際のGitインデックスは、レビューツールによって変更されることはありません。

要件

• Node.js 20+

• Git 2.30+

• Gitリポジトリ

ツール

MCPサーバーは、クライアントがMCPプロンプトをサポートしている場合、2つの再利用可能なプロンプトも公開します。

タスクスナップショットは一時的なGitインデックスを使用し、.git/universal-change-review/の下にGitツリーIDとメタデータのみを保存します。無視されたファイルはキャプチャされません。ソースコードはアップロードされません。

Codex

リポジトリをクローンし、そのマーケットプレイスを登録してからプラグインをインストールします。

git clone https://github.com/IP-DZ/universal-change-review.git
codex plugin marketplace add ./universal-change-review
codex plugin install universal-change-review@ip-dz

Codexパッケージには、change-reviewスキル、UIメタデータ、スタータープロンプト、MCPサーバー定義、およびMCP Appsランチャーカードが含まれています。スキルを明示的に呼び出すには$change-reviewを使用するか、Codexに現在のChangesを開くように依頼します。互換性のあるホストではクリック可能なOpen Changesカードが表示されます。その他のホストには同じlocalhost URLがテキストとして送信されます。

Claude Code

リポジトリからClaude Codeプラグインとしてインストールすると、スキルと/review-changesコマンドが利用可能になります。または、MCPサーバーを直接追加します。

claude mcp add universal-change-review --scope user -- npx -y github:IP-DZ/universal-change-review mcp

Cursor

最もDSHに近い体験を得るには、バンドルされたCursor拡張機能をインストールします。

npm run build:cursor
cursor --install-extension dist/universal-change-review-cursor-0.4.0.vsix --force

Cursorをリロードした後、下部のステータスバーにあるChanges Reviewをクリックするか、アクティビティバーのChanges Reviewアイコンを使用します。拡張機能は自動的に最初の開いているワークスペースを追跡し、Cursorエディタタブにライブパネルを開きます。拡張機能内にバンドルされている同じローカルで読み取り専用のパネルコードを実行します。

プロジェクトスコープの設定には、.cursor/mcp.json、.cursor/rules/change-review.mdc、および.cursor/commands/review-changes.mdをプロジェクトにコピーします。その後、Cursorチャットで/review-changesを使用します。

グローバルMCP設定の場合は、既存のエントリを置き換えずに、このサーバーを~/.cursor/mcp.jsonにマージします。

{
  "mcpServers": {
    "universal-change-review": {
      "command": "npx",
      "args": ["-y", "github:IP-DZ/universal-change-review", "mcp"]
    }
  }
}

CursorのグローバルMCP設定により、すべてのリポジトリでツールが利用可能になります。Cursorルールとカスタムコマンドはプロジェクトスコープであるため、ガイド付きワークフローを希望するリポジトリに提供されたルールとコマンドをコピーします。

推奨ワークフロー

1. 重要なタスクの前に、エージェントに変更ベースラインの開始を依頼します。

2. 要求された動作を実装して検証します。

3. クライアントに応じて、$change-review、/review-changes、またはMCPのreview-changesプロンプトを実行します。

4. P0〜P3の重大度順に並べられた発見事項を確認し、続いて変更された動作、検証、残存リスクを確認します。

ライブChangesパネル

エージェントに「Changesを開いて」と依頼するか、MCPツールのchanges_open_panelを呼び出すか、以下を実行します。

npx -y github:IP-DZ/universal-change-review web --cwd /path/to/repo

返されるlocalhostページは、ライブファイル数、All/Staged/Unstagedフィルター、タスクベースライン選択、行単位のファイル差分を提供します。127.0.0.1のみにバインドし、ランダムなアクセストークンを使用し、書き込みや元に戻すエンドポイントは公開しません。

CLI

GitHubから直接実行します。

npx -y github:IP-DZ/universal-change-review summary --cwd /path/to/repo
npx -y github:IP-DZ/universal-change-review begin --cwd /path/to/repo --label feature
npx -y github:IP-DZ/universal-change-review since --cwd /path/to/repo --id SNAPSHOT_ID

安全性

• UNDO、リセット、チェックアウト、コミット、プッシュ、ファイル書き込みのツールは公開されていません。

• ワークツリーと実際のGitインデックスは変更されません。

• スナップショットキャプチャは、通常のGit blob/ツリーオブジェクトとメタデータを.git内に書き込みます。

• 差分出力はデフォルトで制限されており、1ファイルに制限できます。

• クライアントは、サードパーティのMCPサーバーを起動する前に、ユーザーの承認を求める必要があります。

開発

npm test
npm run check
npm run build:cursor

MIT © IP-DZ