Universelle Änderungsprüfung

Lokale, schreibgeschützte Git-Änderungsprüfung für Codex, Claude Code, Cursor und jeden MCP-kompatiblen Client. Version 0.4 fügt One-Click-Änderungs-Einstiegspunkte hinzu: eine Cursor-Aktivitätsleisten-Erweiterung und eine MCP-Apps-Launcher-Karte für kompatible Codex/ChatGPT-Hosts.

Es bietet gesamte Workspace-Diffs, gestaffelte/nicht gestaffelte Ansichten, Dateiinspektion auf Dateiebene und aufgabenbezogene Schnappschüsse, die nur die Änderungen isolieren, die nach Beginn einer Aufgabe vorgenommen wurden. Quelldateien und der echte Git-Index werden von den Prüfwerkzeugen nie verändert.

Anforderungen

• Node.js 20+

• Git 2.30+

• Ein Git-Repository

Werkzeuge

Der MCP-Server stellt auch zwei wiederverwendbare Prompts bereit, wenn der Client MCP-Prompts unterstützt:

Aufgaben-Schnappschüsse verwenden einen temporären Git-Index und speichern nur eine Git-Baum-ID plus Metadaten unter .git/universal-change-review/. Ignorierte Dateien werden nicht erfasst. Es wird kein Quellcode hochgeladen.

Codex

Klonen Sie das Repository, registrieren Sie seinen Marktplatz und installieren Sie dann das Plugin:

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

Das Codex-Paket enthält die change-review-Fertigkeit, UI-Metadaten, Starter-Prompts, die MCP-Server-Definition und eine MCP-Apps-Launcher-Karte. Rufen Sie die Fertigkeit explizit mit $change-review auf oder bitten Sie Codex, die aktuellen Änderungen zu öffnen. Kompatible Hosts rendern eine anklickbare Änderungen öffnen-Karte; andere Hosts erhalten dieselbe localhost-URL als Text.

Claude Code

Installieren Sie es aus dem Repository als Claude Code-Plugin, um seine Fertigkeit und den /review-changes-Befehl zu erhalten, oder fügen Sie den MCP-Server direkt hinzu:

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

Cursor

Für die engste DSH-ähnliche Erfahrung installieren Sie die gebündelte Cursor-Erweiterung:

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

Nach dem Neuladen von Cursor klicken Sie auf Änderungsprüfung in der unteren Statusleiste oder verwenden Sie das Änderungsprüfung-Aktivitätsleistensymbol. Die Erweiterung folgt automatisch dem ersten geöffneten Workspace und öffnet das Live-Panel in einem Cursor-Editor-Tab. Sie führt denselben lokalen, schreibgeschützten Panel-Code aus, der in der Erweiterung gebündelt ist.

Für eine projektspezifische Einrichtung kopieren Sie .cursor/mcp.json, .cursor/rules/change-review.mdc und .cursor/commands/review-changes.md in ein Projekt. Verwenden Sie dann /review-changes im Cursor-Chat.

Für eine globale MCP-Einrichtung fügen Sie diesen Server in ~/.cursor/mcp.json ein, ohne vorhandene Einträge zu ersetzen:

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

Die globale MCP-Konfiguration von Cursor macht die Werkzeuge in jedem Repository verfügbar. Cursor-Regeln und benutzerdefinierte Befehle sind projektspezifisch, kopieren Sie daher die bereitgestellte Regel und den Befehl in Repositorys, in denen Sie den geführten Workflow wünschen.

Empfohlener Workflow

1. Bitten Sie den Agenten vor einer umfangreichen Aufgabe, eine Änderungsbasislinie zu starten.

2. Implementieren und validieren Sie das angeforderte Verhalten.

3. Führen Sie je nach Client $change-review, /review-changes oder den MCP review-changes-Prompt aus.

4. Überprüfen Sie die Ergebnisse, geordnet nach Schweregrad P0-P3, gefolgt von geändertem Verhalten, Validierung und verbleibenden Risiken.

Live-Änderungs-Panel

Bitten Sie den Agenten, „Änderungen öffnen“ auszuführen, rufen Sie das MCP-Werkzeug changes_open_panel auf oder führen Sie Folgendes aus:

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

Die zurückgegebene localhost-Seite bietet Live-Dateizahlen, Alle/Gestaffelt/Nicht gestaffelt-Filter, Aufgabenbasislinien-Auswahl und zeilenweise Datei-Diffs pro Datei. Sie bindet nur an 127.0.0.1, verwendet ein zufälliges Zugriffstoken und stellt keinen Schreib- oder Rückgängig-Endpunkt bereit.

CLI

Direkt von GitHub ausführen:

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

Sicherheit

• Es wird kein Werkzeug zum Rückgängigmachen, Zurücksetzen, Auschecken, Committen, Pushen oder Dateischreiben bereitgestellt.

• Der Arbeitsbaum und der echte Git-Index werden nicht geändert.

• Die Schnappschuss-Erfassung schreibt normale Git-Blob/Baum-Objekte und Metadaten in .git.

• Die Diff-Ausgabe ist standardmäßig begrenzt und kann auf eine Datei beschränkt werden.

• Clients sollten dennoch die Zustimmung des Benutzers einholen, bevor sie MCP-Server von Drittanbietern starten.

Entwicklung

npm test
npm run check
npm run build:cursor

MIT © IP-DZ