Universal Change Review

Локальный, только для чтения обзор изменений Git для Codex, Claude Code, Cursor и любого MCP-совместимого клиента. Версия 0.4 добавляет точки входа изменений в один клик: расширение панели активности Cursor и карточку запуска MCP Apps для совместимых хостов Codex/ChatGPT.

Он предоставляет общие diff рабочей области, представления проиндексированных/непроиндексированных изменений, проверку на уровне файлов и снимки задач, которые изолируют только изменения, сделанные после начала задачи. Исходные файлы и реальный индекс Git никогда не изменяются инструментами проверки.

Требования

• Node.js 20+

• Git 2.30+

• Репозиторий Git

Инструменты

Сервер MCP также предоставляет два повторно используемых промпта, если клиент поддерживает промпты MCP:

Снимки задач используют временный индекс Git и хранят только идентификатор дерева Git плюс метаданные в .git/universal-change-review/. Игнорируемые файлы не захватываются. Исходный код не загружается.

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 открыть текущие изменения. Совместимые хосты отображают кликабельную карточку Открыть изменения; другие хосты получают тот же URL localhost в виде текста.

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 нажмите Обзор изменений в нижней строке состояния или используйте иконку Обзор изменений на панели активности. Расширение автоматически отслеживает первую открытую рабочую область и открывает живую панель на вкладке редактора Cursor. Оно запускает тот же локальный код панели только для чтения, встроенный в расширение.

Для настройки на уровне проекта скопируйте .cursor/mcp.json, .cursor/rules/change-review.mdc и .cursor/commands/review-changes.md в проект. Затем используйте /review-changes в чате Cursor.

Для глобальной настройки MCP добавьте этот сервер в ~/.cursor/mcp.json, не заменяя существующие записи:

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

Глобальная конфигурация MCP Cursor делает инструменты доступными в каждом репозитории. Правила Cursor и пользовательские команды ограничены проектом, поэтому скопируйте предоставленные правило и команду в репозитории, где нужен управляемый рабочий процесс.

Рекомендуемый рабочий процесс

1. Перед серьёзной задачей попросите агента начать базовую линию изменений.

2. Реализуйте и проверьте запрошенное поведение.

3. Выполните $change-review, /review-changes или промпт MCP review-changes в зависимости от клиента.

4. Просмотрите находки, отсортированные по серьёзности P0-P3, затем изменённое поведение, проверку и оставшиеся риски.

Живая панель изменений

Попросите агента «открыть изменения», вызовите инструмент MCP changes_open_panel или выполните:

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

Возвращаемая страница localhost предоставляет количества файлов в реальном времени, фильтры Все/Проиндексированные/Непроиндексированные, выбор базовой линии задачи и пофайловые diff на уровне строк. Она привязывается только к 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

Безопасность

• Не предоставляется инструментов для отмены, сброса, проверки, фиксации, отправки или записи файлов.

• Рабочее дерево и реальный индекс Git не изменяются.

• Захват снимка записывает обычные объекты blob/tree Git и метаданные внутри .git.

• Вывод diff по умолчанию ограничен и может быть ограничен одним файлом.

• Клиенты всё равно должны запрашивать одобрение пользователя перед запуском сторонних серверов MCP.

Разработка

npm test
npm run check
npm run build:cursor

MIT © IP-DZ