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

merge-queue-readiness — скилл для Claude Code: проверка перед очередью

Скилл merge-queue-readiness проверяет результат слияния PR с актуальной main до добавления в GitHub merge queue. Помогает поймать сбои интеграционных тестов, которых не видно при проверке ветки PR отдельно.

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ZaxbyHub/opencode-swarm --skill merge-queue-readiness -a claude-code
Открыть на GitHub

Что делает merge-queue-readiness

Перед постановкой PR в очередь слияния скилл предлагает обновить main и запустить /swarm ci-simulate [<pr-ref>]. Команда проверяет объединённый результат в отдельном временном worktree: выполняет bun run typecheck, bun run lint, bun run build и полный запуск bun test, затем удаляет worktree. Если команды нет, инструкция описывает ручное слияние в отдельном worktree и запуск интеграционных и модульных тестов.

Проверка моделирует результат слияния PR с последней main, а не повторяет CI целиком: в ней нет его логики карантина и повторных запусков. Команда принимает необязательную ссылку на ветку PR, но не флаги --base и --head. Worktree нужно очистить и при ошибке; неудачное удаление следует показать пользователю и выполнить git worktree prune.

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

  • проверить объединение PR с актуальной main до постановки в очередь
  • запустить локальные проверки на результате слияния
  • найти сбой интеграционных тестов, возникающий только в merge-group
  • удалить временный worktree после симуляции

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

  • Перед добавлением PR в очередь проверь его слияние с актуальной main.
  • Запусти симуляцию для ветки feature/login перед финальным push.
  • Проверь результат слияния PR; если симуляция упадёт, очисти временный worktree.

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

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill merge-queue-readiness -a claude-code

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

~/.claude/skills/merge-queue-readiness/SKILL.md

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

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

Вопросы о merge-queue-readiness

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

Выполните npx skills add ZaxbyHub/opencode-swarm --skill merge-queue-readiness -a claude-code. Файл скилла появится по пути ~/.claude/skills/merge-queue-readiness/SKILL.md.

Что делает merge-queue-readiness?

Он помогает проверить PR вместе с последней main перед добавлением в GitHub merge queue. Основной способ запускает /swarm ci-simulate, а при недоступности команды описан ручной вариант.

Повторяет ли симуляция весь CI для merge-group?

Нет. Она запускает локальные проверки и полный bun test, но не воспроизводит карантин и повторы CI. Это сигнал перед слиянием, а не проверка полного соответствия CI.

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

SKILL.md · MIT
---
name: merge-queue-readiness
description: Pre-queue merge-group CI simulation. Triggered before adding a PR to a GitHub merge queue. Prevents merge-queue kick-outs from integration test failures.
metadata:
  audience: swarm-plugin
---

# Merge Queue Readiness

## Trigger
Before adding the PR to the merge queue (or before the final push if the repo uses a merge queue).

## Protocol
1. **Fetch latest main:** `git fetch origin main`
2. **Run the simulation command (preferred):**
   ```
   /swarm ci-simulate [<pr-ref>]
   ```
   The optional positional `<pr-ref>` is the PR branch/ref to simulate (defaults to the current branch). It does NOT accept `--base`/`--head` flags. The command runs fixed local gates: `bun run typecheck`, `bun run lint`, `bun run build`, then a full-batch `bun test`. It creates a temporary detached worktree under `os.tmpdir()/swarm-ci-simulate` (a SIBLING of the project root, not project-relative), merges the PR ref, runs the gate sequence, removes the worktree, and prunes metadata. It does not accept arbitrary shell commands and does NOT replicate CI's quarantine/retry semantics — it is a fast pre-merge signal, not a CI parity check.
3. **Manual fallback:** If the command is unavailable, create a temporary simulation worktree (do NOT mutate the PR branch). The default worktree base is a SIBLING of the project root (`<parent>/.swarm-worktrees/`), overridable via the `worktree_dir` config; on Windows, very long paths may be shortened to `os.tmpdir()/swwt/...`. Place the worktree under that base. Do NOT hardcode `/tmp` — it does not exist on Windows.
   ```
   git worktree add ../.swarm-worktrees/merge-sim origin/main
   cd ../.swarm-worktrees/merge-sim
   git merge <pr-branch> --no-edit
   ```
4. **Run integration + unit tests against the merged result:**
   ```
   bun test tests/integration --timeout 120000
   bun test tests/unit --timeout 120000
   ```
   (Use per-file loops for hot modules per AGENTS.md invariant 6)
5. **If failures:** Fix on the PR branch, re-push, re-simulate. Always run the cleanup step (6) before re-simulating or on any exit path — do not leave the simulation worktree behind.
6. **Cleanup for manual fallback (run on EVERY exit path, including failure):** Prefer non-force `git worktree remove ../.swarm-worktrees/merge-sim`. If the removal is blocked or fails, surface the block to the user (the worktree guard fails closed for safety) and run `git worktree prune`.
7. **Only after simulation passes,** add PR to the merge queue.

## Why this matters
PR-branch CI and merge-group CI test DIFFERENT things:
- PR-branch: tests the PR head commit in isolation
- Merge-group: tests a temporary merge of PR head + latest main

Integration tests that pass on the PR branch may fail in merge-group context due to test interactions exposed by the merged result.

## Automation
`/swarm ci-simulate` automates the merge-result worktree, merge, command run,
worktree removal, and metadata prune. Use the manual protocol only when the
command is unavailable or the repo needs bespoke setup.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Каталог скиллов SKILL.md →
om-merge-buddy open-mercato Скилл om-merge-buddy сканирует открытые пуллреквесты через трекер и сортирует их по готовности к слиянию в режиме чтения. Ничего не меняет в репозитории. CX Codex +1 3 600установок merge-open-prs jssblck Скилл merge-open-prs для Claude Code собирает список открытых PR, выбирает порядок и сливает их через GitHub. Последовательно обрабатывает несколько PR. CX Codex +1 1 700установок jackin-merge-pr jackin-project Скилл jackin-merge-pr прогоняет предмержевые проверки jackin❯, переносит пункт роадмапа в документацию и делает squash-merge пул-реквеста. Вызывается только вручную. CX Codex +1 469установок diagnosing-ci-and-merge-bottlenecks PostHog Скилл diagnosing-ci-and-merge-bottlenecks для Claude Code анализирует состояние CI и путь pull request от открытия до слияния. Находит медленные workflow, зависшие PR и расходы на CI. CX Codex +1 320установок github-pr-merge fvadicamo Скилл github-pr-merge доводит пулл-реквест до мержа: проверяет комментарии ревью, тесты, CI и changelog, а потом сливает с подтверждением. CX Codex +1 281установок research-merge aiskillstore Скилл research-merge находит исследовательские ветки Claude Code Web, делает squash-merge, переносит отчёты в docs/research/ и заводит GitHub Issues. CX Codex +1 1установок

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

Весь набор →
swarm-resume Скилл swarm-resume для Claude Code восстанавливает состояние плана роя и очищает зависшие git-ветки, чтобы продолжить выполнение задач по готовому плану. CX Codex +1 ★ 539звёзд репо ci-failure-batching Скилл ci-failure-batching собирает все упавшие проверки PR, прежде чем планировать исправления. Помогает избежать отдельного цикла диагностики и отправки изменений для каждой ошибки. CX Codex +1 ★ 539звёзд репо mock-to-internals-migration Скилл mock-to-internals-migration для Claude Code помогает переносить моки с Vitest на Bun и проверять переход на seam _internals. Подключается к задачам миграции моков и изменения тестовой структуры. CX Codex +1 ★ 539звёзд репо gate-attribution Скилл gate-attribution связывает вердикты ревьюеров и тестировщиков с конкретными задачами плана в swarm-пайплайнах. Помогает избежать сбоев при пакетной проверке. CX Codex +1 ★ 539звёзд репо issue-tracer Субагент issue-tracer, который доводит GitHub issue от репорта до плана исправления. Собирает доказательства, находит корневую причину и не трогает код, пока вы не подтвердите план. CX Codex +1 ★ 539звёзд репо qa-reviewer Субагент qa-reviewer для строгого ревью пуллреквестов перед слиянием. Проверяет логику, безопасность, обработку ошибок, стиль и покрытие тестами без изменения кода. CX Codex +1 ★ 539звёзд репо durable-session-state Скилл durable-session-state сохраняет планы, решения, результаты проверок и вердикты ревью в файлах проекта. Он помогает продолжить долгую задачу после сжатия контекста или передачи работы. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для Claude Code собирает известные замечания к PR в реестр, проверяет каждое по коду и только после этого вносит правки. Разбирает замечания ревью, сбои CI и конфликты. CX Codex +1 ★ 539звёзд репо

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

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