Universal Change Review

로컬, 읽기 전용 Git 변경 검토 도구로, Codex, Claude Code, Cursor 및 모든 MCP 호환 클라이언트에서 사용할 수 있습니다. 버전 0.4에서는 원클릭 Changes 진입점(Cursor 활동 표시줄 확장 및 호환되는 Codex/ChatGPT 호스트용 MCP Apps 런처 카드)이 추가되었습니다.

전체 작업 공간 diff, 스테이징/언스테이징 뷰, 파일 수준 검사, 그리고 작업 시작 후 변경된 사항만을 분리하는 작업 범위 스냅샷을 제공합니다. 검토 도구에 의해 소스 파일과 실제 Git 인덱스는 절대 수정되지 않습니다.

요구 사항

• Node.js 20+

• Git 2.30+

• Git 저장소

도구

MCP 서버는 클라이언트가 MCP 프롬프트를 지원할 때 재사용 가능한 두 개의 프롬프트도 제공합니다:

작업 스냅샷은 임시 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 열어줘"라고 요청하거나, changes_open_panel MCP 도구를 호출하거나, 다음을 실행하세요:

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 인덱스는 변경되지 않습니다.

• 스냅샷 캡처는 일반 Git blob/tree 객체와 메타데이터를 .git 내부에 씁니다.

• Diff 출력은 기본적으로 제한되며 하나의 파일로 제한될 수 있습니다.

• 클라이언트는 여전히 타사 MCP 서버를 시작하기 전에 사용자 승인을 요청해야 합니다.

개발

npm test
npm run check
npm run build:cursor

MIT © IP-DZ