# merge-review

Скилл merge-review проверяет очередь слияний от fleet-агентов, находит пересечения файлов между ветками и предлагает безопасный порядок merge перед тем, как принимать изменения в main.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 937 у репозитория
- Автор: SethGammon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/SethGammon/Citadel/tree/HEAD/skills/merge-review/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/merge-review

## Что делает

Скилл читает очередь `.planning/telemetry/merge-check-queue.jsonl`, куда worktree-remove.js складывает ветки после завершения fleet-агентов. Для каждой ветки он берёт `git diff main..{branch}` и сравнивает изменённые файлы попарно, разделяя пересечения на аддитивные, перекрывающие один участок кода и прямо противоречащие друг другу правки.

По итогам каждой ветке присваивается риск — low, medium или high — и выдаётся рекомендация: merge, review-first или resolve-conflict. Если конфликты образуют цикл (A против B, B против C, C против A), скилл не пытается выдумать порядок слияния, а передаёт решение пользователю. Сам merge скилл не делает: это read-only анализ, который только обновляет статусы в очереди и после отчёта убирает уже влитые worktree командой `git worktree remove`.

Запускается командой `/merge-review` для всей очереди или `/merge-review {branch}` для конкретной ветки. Без заполненной очереди merge-check-queue.jsonl скилл просто сообщит, что проверять нечего.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add SethGammon/Citadel
```
В чате агента (не в терминале):
```text
/plugin install citadel@citadel-local
```
Команда ставит плагин citadel целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill merge-review -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/merge-review/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/merge-review/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill merge-review -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/merge-review/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill merge-review -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/merge-review/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SethGammon/Citadel skills/merge-review
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/merge-review/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill merge-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/SethGammon/Citadel --path skills/merge-review
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/merge-review/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/SethGammon/Citadel/tree/HEAD/skills/merge-review/SKILL.md

## Когда брать
- проверить очередь fleet-веток перед merge в main
- найти файлы, которые правили одновременно две ветки
- оценить риск конфликта для каждой ветки
- получить порядок слияния с учётом зависимостей
- вычистить worktree после успешного merge

## Примеры запросов агенту
- Проверь очереди merge-check-queue перед слиянием
- Посмотри, есть ли конфликты в ветке fleet/task-abc
- Предложи порядок слияния для всех веток из fleet

## Похожие
- [git-merge-expert-worktree](https://affpapa.org/nevibecode/skills/git-merge-expert-worktree.md) — скилл · 159 установок
- [merge](https://affpapa.org/nevibecode/skills/merge.md) — скилл · 1409 установок
- [git-merge-expert](https://affpapa.org/nevibecode/skills/git-merge-expert.md) — скилл · 182 установки
- [merge-contributor-pr](https://affpapa.org/nevibecode/skills/merge-contributor-pr.md) — скилл · ★ 1636 у репозитория
- [merge-open-prs](https://affpapa.org/nevibecode/skills/merge-open-prs.md) — скилл · 1700 установок
- [github-pr-merge](https://affpapa.org/nevibecode/skills/github-pr-merge.md) — скилл · 281 установка

Из того же набора: [sethgammon/citadel](https://affpapa.org/nevibecode/by/sethgammon/citadel.md) — 55 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
