К основному содержанию
скилл CX Codex

merge-review — скилл для Claude Code: что делает и как установить

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

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает 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 скилл просто сообщит, что проверять нечего.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить merge-review

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill merge-review -a claude-code

3Вручную: положить файлы

~/.claude/skills/merge-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/merge-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о merge-review

Как установить merge-review в Claude Code?

Через маркетплейс: сначала выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local. Также можно поставить отдельно: npx skills add SethGammon/Citadel --skill merge-review -a claude-code.

Что делает merge-review?

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

Что происходит при круговых конфликтах между ветками?

Если ветка A конфликтует с B, B с C, а C с A, скилл не предлагает порядок слияния, а выводит список всех конфликтов и передаёт решение пользователю.

Исходный текст

SKILL.md · MIT
---
name: merge-review
license: MIT
description: >-
  Reviews pending fleet worktree merges before they're accepted. Reads the
  merge-check queue, detects file-level conflicts between branches, proposes a
  safe merge order, and surfaces reconciliation plans for overlapping changes.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - merge review
  - check merges
  - any conflicts
  - fleet conflicts
  - pending branches
  - safe to merge
last-updated: 2026-03-26
---

# /merge-review — Fleet Merge Arbitration

## Orientation

**Use when:** reviewing pending fleet worktree merges before accepting them into the main branch.
**Don't use when:** reviewing general code quality (use /review); checking CI status before merging (use /pr-watch).

## When to Route Here

- "check merges"
- "any conflicts"
- "what do the fleet agents want to merge"
- "review the pending branches"
- "is it safe to merge fleet output"
- "arbitrate the worktrees"
- worktree-remove.js has queued items and the user wants to process them

## Invocation Forms

```
/merge-review              # Process the full queue
/merge-review {branch}     # Review a specific branch only
```

## Protocol

### Step 1: Read the Queue

Read `.planning/telemetry/merge-check-queue.jsonl`. Each line is a JSON object:
```json
{"branch": "fleet/task-abc", "worktree": "/path/to/worktree", "queuedAt": "ISO"}
```

If the file doesn't exist or is empty:
> "No pending merge reviews. Fleet agents haven't completed any worktrees recently."
Stop here.

If invoked with a specific branch (`/merge-review {branch}`): filter to that branch only.

### Step 2: For Each Branch — Gather Diff Data

Run `git diff main..{branch} --name-only`, `--stat`, and `git branch --list {branch}`.

If the branch no longer exists: mark `status: "merged"`, note "likely already merged. Skipped.", continue.

### Step 3: Detect Overlapping Files

Compare changed file sets pairwise. For each pair sharing files, read `git diff main..{branch} -- {file}` for both and classify:
- **Additive**: both add to the file (low risk, likely auto-mergeable)
- **Overlapping edits**: both modify the same function/section (medium risk)
- **Contradictory**: one adds, the other removes the same code (high risk)

### Step 4: Assess Risk Per Branch

For each branch:
- **low** — no overlapping files with other branches
- **medium** — overlaps exist but changes appear additive or in different sections
- **high** — overlaps in the same function, class, or closely coupled section

### Step 5: Propose Merge Order

Order branches: fewest conflicts first, most conflicts last.

If circular dependencies exist (A conflicts with B, B conflicts with C, C conflicts
with A): escalate to the user — do not propose an impossible order.

### Step 6: Output the Report

```
## Merge Review: {N} branch(es) pending

### Branch: {name}
Files changed: {N}
Overlap with other branches: {branch-X} ({file-list}) | none
Risk: low | medium | high
Recommendation: merge | review-first | resolve-conflict

---
[repeat for each branch]
---

### Conflicts Detected

{branch-A} and {branch-B} both modified:
  - {file}: {brief description — e.g., "A adds export, B removes same export"}
Recommended resolution: {which change to keep, or how to combine them}

[repeat for each conflict pair]

### Proposed Merge Order

1. {branch} — no conflicts, safe to merge first
2. {branch} — depends on #1; review {file} after merging #1
3. {branch} — manual conflict resolution needed in {file} before merging

### Summary
Branches ready to merge: {N}
Branches needing review: {N}
Branches with hard conflicts: {N}
```

If all branches are conflict-free:
```
## Merge Review: {N} branch(es) pending — No conflicts detected

All branches can be merged in any order. Recommended order (by change size, smallest first):
1. {branch} — {N} files
2. {branch} — {N} files
```

### Step 7: Update the Queue

After producing the report, mark reviewed items in the queue:
- Branches still needing work: `status: "reviewed"`, add `reviewedAt` timestamp
- Branches no longer existing: `status: "merged"` (already handled in Step 2)

Write the updated queue back to `.planning/telemetry/merge-check-queue.jsonl`.

### Step 8: Cleanup Merged Worktrees

Run `git worktree list --porcelain`. For each non-main worktree: check `git branch --merged HEAD`. If merged and clean: run `git worktree remove "{path}" --force` and `git branch -d "{branch}"`. No user confirmation needed. Report count: "Cleaned up {N} merged worktree(s): {branch-names}".

---

## Fringe Cases

**Queue empty:** Output "No pending merge reviews." and stop.

**Branch no longer exists:** Remove from queue, note, continue.

**Branch not in queue:** Note "not in the merge queue" and suggest `/merge-review` to see all.

**All branches conflict (circular):** List all conflicts; do not propose an order; escalate to user.

**One branch pending:** Skip conflict detection; output single-branch review (files, stat, recommendation).

**Large diff (>500 lines):** Summarize changed areas; link to `git diff` command for details.

**Worktree path missing but branch exists:** Proceed with git diff using branch name; worktree existence not required.

---

## Integration Points

- **worktree-remove.js** — queues items to `.planning/telemetry/merge-check-queue.jsonl` when a fleet worktree completes
- **fleet skill** — run `/merge-review` after fleet agents complete, before merging to main
- **session-end.js** — may surface a reminder if the merge queue has items at session end

## Contextual Gates

**Disclosure:** "Reviewing pending fleet worktree merges. Read-only — no changes applied."
**Reversibility:** green — read-only review; no files merged or modified
**Trust gates:**
- Any: view merge review report and recommendations

## Quality Gates

- Never merge branches — only analyze and recommend
- Always update the queue after processing (mark reviewed/merged)
- Always provide a concrete recommendation for each branch (merge / review-first / resolve-conflict)
- If a branch was already merged, clean it from the queue without error
- If all conflicts are circular/unresolvable, escalate clearly rather than proposing an impossible order

## Exit Protocol

/merge-review does not produce a HANDOFF block. It outputs the merge report (Step 6) and then
waits for the next user command.

After the report, suggest next actions based on what was found:
- If all branches are safe: "All clear. Merge in the order above."
- If conflicts exist: "Resolve the flagged conflicts before merging. Run `/merge-review` again after resolving."
- If queue is empty: "Queue is empty. Nothing to review."

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
git-merge-expert-worktree ulpi-io Скилл git-merge-expert-worktree для Claude Code и ещё пяти агентных сред: выполняет слияния и решение конфликтов в отдельном git worktree. CX Codex +1 159установок merge Alireza Rezvani Скилл merge для Claude Code вливает ветку лучшего агента в базовую, архивирует проигравших тегами и очищает worktrees. Фиксирует результат завершённой сессии AgentHub. CX Codex +1 1 409установок git-merge-expert ulpi-io Скилл git-merge-expert сливает ветки и PR, разбирает конфликты и откатывает неудачные merge. До начала работы проверяет готовность и ставит бэкап-тег. CX Codex +1 182установок merge-contributor-pr dyoshikawa Скилл merge-contributor-pr для Claude Code и других агентных сред мёржит PR, который не проходит как есть: конфликт с main или похожая блокировка. Коммиты автора остаются нетронутыми, история не переписывается. CX Codex +1 ★ 1 636звёзд репо merge-open-prs jssblck Скилл merge-open-prs для Claude Code собирает список открытых PR, выбирает порядок и сливает их через GitHub. Последовательно обрабатывает несколько PR. CX Codex +1 1 700установок github-pr-merge fvadicamo Скилл github-pr-merge доводит пулл-реквест до мержа: проверяет комментарии ревью, тесты, CI и changelog, а потом сливает с подтверждением. CX Codex +1 281установок

Из того же набора55

Весь набор →
design Скилл design собирает дизайн-манифест из стилей проекта или ответов на вопросы. Хук после правок отмечает отклонения в CSS и компонентах. CX Codex +1 ★ 937звёзд репо live-preview Скилл live-preview делает скриншоты компонентов в процессе сборки, а не по готовности. Ловит регрессии вёрстки и невидимые блоки до того, как они уйдут дальше. CX Codex +1 ★ 937звёзд репо architect Скилл architect превращает PRD или описание задачи в архитектурный план с деревом файлов, моделью данных и фазами сборки. CX Codex +1 ★ 937звёзд репо cost Скилл cost показывает расход токенов и стоимость сессий, кампаний и периодов. Помогает понять, куда уходит бюджет и как меняется темп расходов. CX Codex +1 ★ 937звёзд репо deploy-steward Скилл deploy-steward для Claude Code по очереди вливает готовые PR в main, проверяет CI, запускает деплой и создаёт задачи на починку при сбоях. CX Codex +1 ★ 937звёзд репо prd Собирает PRD по описанию приложения: задаёт вопросы, определяет объём и технические решения. Документ можно передать Archon для разбиения на кампанию. CX Codex +1 ★ 937звёзд репо organize Скилл organize для аудита и исправления структуры проекта: проверяет, где лежат файлы, переносит их по конвенции и обновляет импорты. Код внутри файлов не трогает. CX Codex +1 ★ 937звёзд репо create-app Скилл create-app для Claude Code и Codex автоматизирует создание приложений по текстовому описанию. Он делит задачу на пять уровней и ведёт разработку через PRD, архитектуру и верификацию. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой