github-pr-merge — скилл для Claude Code: мерж PR с проверками
Скилл github-pr-merge доводит пулл-реквест до мержа: проверяет комментарии ревью, тесты, CI и changelog, а потом сливает с подтверждением.
MIT 281 установок ★ 72 обновлён 2026-09-11
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a claude-codeЧто делает github-pr-merge
Скилл идёт по шагам, которые обычно забывают. Сначала смотрит комментарии ревью: если на верхнеуровневый комментарий никто не ответил, процесс останавливается и отправляет к github-pr-review. Дальше milestone — про отсутствие скилл предупредит, но блокировать не станет. Потом gh pr checks и сверка с CHANGELOG.md: коммит с feat, fix или perf без строки в changelog останавливает мерж.
Слияние всегда merge-коммитом через --merge, squash и rebase не используются. Ветку удаляет только у topic-ветки, уходящей в develop; при мерже develop → main флаг --delete-branch не ставится. После мержа скилл переключается на базовую ветку и делает git pull, затем считает открытые задачи milestone. Закрыть его можно только с вашего подтверждения.
Всё это обёртка над GitHub CLI: без установленного и авторизованного gh ни одна проверка не пройдёт, потому что каждая команда идёт через него.
Какие задачи решает
- убедиться, что на все комментарии ревью ответили, до слияния
- прогнать тесты, линт и CI как обязательное условие мержа
- поймать коммиты, которых нет в changelog перед релизным мержем
- слить PR merge-коммитом и удалить отработавшую ветку
- закрыть milestone, когда в нём не осталось открытых задач
Примеры запросов агенту
- Слей PR #42, если все проверки зелёные
- Покажи чек-лист перед мержем текущего PR: комментарии, тесты, milestone, changelog
- Смержи
developвmainбез удаления ветки
Как установить github-pr-merge
1Через Skills CLI (Vercel)
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a claude-code2Вручную: положить файлы
~/.claude/skills/github-pr-merge/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/github-pr-merge/
1Через Skills CLI (Vercel)
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a codex2Вручную: положить файлы
.agents/skills/github-pr-merge/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a cursor2Вручную: положить файлы
.cursor/skills/github-pr-merge/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fvadicamo/dev-agent-skills plugins/github-workflow/skills/github-pr-merge2Вручную: положить файлы
.github/skills/github-pr-merge/SKILL.md1Через Skills CLI (Vercel)
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a gemini-cli2Командой платформы
gemini skills install https://github.com/fvadicamo/dev-agent-skills --path plugins/github-workflow/skills/github-pr-mergeВручную: положить файлы
.devin/skills/github-pr-merge/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о github-pr-merge
Как установить github-pr-merge в Claude Code?
Выполните npx skills add fvadicamo/dev-agent-skills --skill github-pr-merge -a claude-code. Файл скилла появится по пути ~/.claude/skills/github-pr-merge/SKILL.md.
Что делает github-pr-merge?
Проводит предмержную проверку пулл-реквеста: ответы на комментарии, тесты, линт, CI, milestone и changelog. Затем спрашивает подтверждение и сливает PR merge-коммитом, после чего синхронизирует базовую ветку.
Можно ли слить PR через squash?
Нет. Скилл всегда использует --merge и не делает ни squash, ни rebase. Ветку он удаляет только при мерже topic-ветки в develop.
Исходный текст
SKILL.md · MIT
---
name: github-pr-merge
description: Merges GitHub Pull Requests after validating pre-merge checklist. Use when user wants to merge PR, close PR, finalize PR, complete merge, approve and merge, or execute merge. Runs pre-merge validation (tests, lint, CI, comments), confirms with user, merges with proper format, handles post-merge cleanup.
---
# GitHub PR merge
Merges Pull Requests after validating pre-merge checklist and handling post-merge cleanup.
## Current PR
!`gh pr view --json number,title,state -q '"PR #\(.number): \(.title) (\(.state))"' 2>/dev/null`
## Core workflow
### 1. Check comments status
Verify all review comments have at least one reply:
```bash
REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')
PR=$(gh pr view --json number -q '.number')
# Find unreplied comment IDs
gh api repos/$REPO/pulls/$PR/comments --jq '
[.[] | select(.in_reply_to_id) | .in_reply_to_id] as $replied |
[.[] | select(.in_reply_to_id == null) | select(.id | IN($replied[]) | not) | .id]
'
```
**If unreplied comments exist:**
- **STOP** the merge process
- Inform user: "Found unreplied comments: [IDs]. Run github-pr-review first."
- **NEVER** reply to comments from this skill
### 2. Check milestone
```bash
gh pr view $PR --json milestone -q '.milestone.title // "none"'
```
- If milestone is assigned: include it in the checklist summary (step 5)
- If no milestone: check for open milestones and warn the user
```bash
gh api repos/$REPO/milestones --jq '[.[] | select(.state=="open")] | length'
```
If open milestones exist but the PR has none, surface a warning in the checklist:
`- Milestone: ⚠ not assigned (open milestones exist)`
Do NOT block the merge for a missing milestone. It is a warning only.
### 3. Run validation
Run tests, linting, and verify CI checks. All **MUST** pass before proceeding.
```bash
gh pr checks $PR
```
### 4. Verify changelog completeness
Skip if the repo has no `CHANGELOG.md`. Otherwise make sure every commit this merge will publish is reflected in the changelog, so a release-promotion merge (`develop` → `main`) never leaves commits unlogged.
List the commits this PR brings into the base, and the changelog lines it adds:
```bash
BASE=$(gh pr view $PR --json baseRefName -q .baseRefName)
HEAD=$(gh pr view $PR --json headRefName -q .headRefName)
git log --oneline origin/$BASE..origin/$HEAD
git diff origin/$BASE...origin/$HEAD -- CHANGELOG.md
```
- Every commit that changes shipped behavior (`feat`/`fix`/`perf`, behavior-affecting `refactor`) **MUST** have a matching changelog line; pure `chore`/`docs`/`test` commits that do not change shipped behavior may be omitted.
- For a release-promotion merge, also confirm the version was bumped (the top `## [x.y.z]` entry is new) and matches the manifest version(s).
- **If any behavior-changing commit is missing from the changelog: STOP.** Report the unlogged commits and ask the user to update the changelog and version before merging. **NEVER** edit the changelog from this skill.
### 5. Confirm with user
**ALWAYS show checklist summary and ask before merging:**
```
Pre-merge checklist:
- Comments: all replied
- Tests: passing
- Lint: passing
- CI: green
- Milestone: v0.1.0 (or ⚠ not assigned)
- Changelog: complete (or n/a)
Ready to merge PR #X. Proceed?
```
### 6. Execute merge
First determine the merge direction. It decides whether the head branch may be deleted:
```bash
gh pr view $PR --json baseRefName,headRefName -q '"\(.headRefName) -> \(.baseRefName)"'
```
**Branch deletion rule:**
- **Topic branch → `develop`** (head is a `feature`/`fix`/etc. branch): the branch is spent. Propose deleting it and merge with `--delete-branch`.
- **`develop` → `main`** (or any long-lived branch as head): **NEVER** delete the head branch. `develop` and `main` are permanent. Omit `--delete-branch` and do not propose deletion.
```bash
# Add --delete-branch ONLY for a topic branch merging into develop.
gh pr merge $PR --merge --delete-branch --body "$(cat <<'EOF'
- Key change 1
- Key change 2
- Key change 3
Reviews: N/N addressed
Tests: X passed (Y% cov)
Refs: Task N, Req M
EOF
)"
```
For a `develop` → `main` merge, run the same command **without** `--delete-branch`.
**Merge strategy**: always `--merge` (merge commit), never squash or rebase.
### 7. Post-merge cleanup
Sync the branch that received the merge (the PR base), not always `develop`:
```bash
BASE=$(gh pr view $PR --json baseRefName -q .baseRefName)
git checkout "$BASE" && git pull origin "$BASE"
```
### 8. Check milestone completion
If the PR had a milestone, check whether all items are now closed:
```bash
MILESTONE=$(gh pr view $PR --json milestone -q '.milestone.number // empty')
if [ -n "$MILESTONE" ]; then
gh api repos/$REPO/milestones/$MILESTONE \
--jq '"Open: \(.open_issues) | Closed: \(.closed_issues) | \(.title)"'
fi
```
- If `open_issues == 0`: inform the user and ask whether to close the milestone
```bash
gh api repos/$REPO/milestones/$MILESTONE --method PATCH --field state="closed"
```
- If `open_issues > 0`: report remaining open items count. No action needed.
- **NEVER** close a milestone automatically without explicit user confirmation.
## Merge message format
Concise format for a clean git log:
```
- Key change 1 (what was added/fixed)
- Key change 2
- Key change 3
Reviews: 7/7 addressed (Gemini 5, Codex 2)
Tests: 628 passed (88% cov)
Refs: Task 8, Req 14-15
```
- 3-5 bullet points max for changes
- One line each for reviews summary, test results, and task references
- No headers (##), no verbose sections
- Total: ~10 lines max
## Important rules
- **ALWAYS** run tests, lint, and CI checks before merging
- **ALWAYS** verify all review comments have replies
- **ALWAYS** check milestone assignment before merging (warn if missing, do not block)
- **ALWAYS** (repos with a CHANGELOG) verify it accounts for every behavior-changing commit this merge publishes; STOP and report any that are missing
- **ALWAYS** confirm with user before executing merge
- **ALWAYS** use merge commit (`--merge`), never squash/rebase
- **ALWAYS** delete the head branch only when merging a topic branch (`feature`/`fix`/etc.) into `develop`
- **NEVER** delete `develop` or `main`. On a `develop` → `main` merge, omit `--delete-branch` and never propose deletion
- **ALWAYS** check milestone completion after merge and report open items count
- **NEVER** merge with failing tests, lint, or CI checks
- **NEVER** skip user confirmation
- **NEVER** close a milestone without explicit user confirmation
- **NEVER** reply to PR comments from this skill - use github-pr-review instead
- **STOP** merge if unreplied comments exist and direct user to review skill
© fvadicamo · MIT · fvadicamo/dev-agent-skills