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

fork-pr-operations — скилл для Claude Code: что делает

Скилл fork-pr-operations инструктирует агента по работе с пулл-реквестами из форков: одобрение воркфлоу в GitHub Actions, безопасный rebase и сверка актуальности проверок CI.

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

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

Что делает fork-pr-operations

Скилл описывает правила работы с пулл-реквестами, когда ветка находится в форке, а целевой репозиторий защищён строгими политиками безопасности GitHub. Он задаёт соглашения об именовании origin и upstream, пошаговый порядок обновления ветки через git rebase upstream/main и категорически запрещает обычный force push в пользу git push --force-with-lease.

Отдельный блок посвящён пайплайнам CI. GitHub переводит запуски из форков в статус ожидания, поэтому скилл даёт команды вызова gh api и gh run list с паузой в 5 секунд на создание запуска во избежание состояния гонки. Без прав записи actions: write в базовом upstream-репозитории подтвердить запуск не выйдет: одобрение доступно только мейнтейнерам исходного проекта.

Также скилл регулирует реакцию на ревью ботов, которые комментируют код после каждого пуша. Агент учится игнорировать повторные подтверждения от ботов, сверять хэш SHA коммитов перед отменой устаревших проверок и отдавать приоритет замечаниям людей.

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

  • Синхронизировать ветку форка через git rebase и безопасный --force-with-lease
  • Одобрить зависшие запуски GitHub Actions в upstream через CLI gh
  • Проверить актуальность проверок CI по хэшу SHA после повторного пуша
  • Отфильтровать повторяющиеся автоматические комментарии ботов при многораундовом ревью

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

  • Синхронизируй ветку форка с upstream/main и отправь изменения с флагом --force-with-lease
  • Проверь зависшие воркфлоу GitHub Actions для нашего PR в upstream и подтверди запуск
  • Посмотри ревью ботов по последнему пушу и выдели только новые замечания

Как установить fork-pr-operations

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill fork-pr-operations -a claude-code

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

~/.claude/skills/fork-pr-operations/SKILL.md

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

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

Вопросы о fork-pr-operations

Как установить fork-pr-operations в Claude Code?

Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill fork-pr-operations -a claude-code. Конфигурация скилла сохранится в ~/.claude/skills/fork-pr-operations/SKILL.md.

Что делает скилл fork-pr-operations?

Он учит агента работать с ограничениями внешних форков: настраивать remotes, безопасно пушить код, запускать воркфлоу через gh api и разбирать автоматические замечания ботов.

Кто может одобрять воркфлоу GitHub Actions для форка?

Для одобрения через gh api требуются права actions: write в целевом upstream-репозитории. Если у автора форка нет прав на запись в upstream, запустить проверки может только мейнтейнер базового репозитория.

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

SKILL.md · MIT
---
name: fork-pr-operations
description: Operational patterns for fork PRs (head repo differs from base repo). Covers GitHub workflow approval after push, force-push protocol, remote naming conventions, stale CI verification, and bot review multi-round awareness. Load when working with fork PRs, cross-repo contributions, or workflow approval issues.
metadata:
  audience: swarm-plugin
---

# Fork PR Operations

Fork PRs — where the head repository differs from the base repository — have a distinct operational lifecycle. GitHub treats them with stricter security defaults that require additional steps not needed for same-repo PRs.

## When to use this skill

- You are pushing to a branch on a forked repository
- CI checks are stuck in "waiting" status after a push
- You need to rebase a fork PR branch against upstream/main
- A bot reviewer posts after every push, creating multiple review rounds

## Workflow approval after push

**Critical:** GitHub requires explicit workflow approval for fork PRs. After every push, CI jobs remain in "waiting" status until a user with write access to the base repository approves the workflow run.

### Approval command

```bash
# List pending workflow runs for the PR
gh run list --repo <upstream-owner>/<upstream-repo> --branch <branch-name> --limit 5

# Approve a specific run
gh api -X POST repos/<upstream-owner>/<upstream-repo>/actions/runs/<run-id>/approve
```

### Race condition: run not yet created

After pushing, there is a brief window (1-5 seconds) before GitHub creates the workflow run object. If you try to approve too quickly, the run won't exist yet. Retry with a short delay:

```bash
# Wait for run to appear, then approve
sleep 5
gh run list --repo <upstream-owner>/<upstream-repo> --branch <branch-name> --limit 1 --json databaseId,status --jq '.[0]'
# If status is "waiting", approve:
gh api -X POST repos/<upstream-owner>/<upstream-repo>/actions/runs/<databaseId>/approve
```

### Permission requirements

The `gh api -X POST .../approve` call requires `actions: write` permission on the **base** (upstream) repository. This typically means your GitHub token needs the `repo` or `public_repo` scope, and you must have write access to the upstream repo. Fork owners without upstream write access cannot approve workflow runs — only upstream maintainers can.

```bash
gh auth status
# Verify you have repo/public_repo scope and write access to the upstream repo
```

## Remote naming conventions

Standard remote setup for fork-based contributions:

```bash
# origin = your fork
git remote add origin https://github.com/<your-username>/<repo>.git

# upstream = canonical repository
git remote add upstream https://github.com/<canonical-owner>/<repo>.git

# Additional forks by owner name (if collaborating across forks)
git remote add <collaborator> https://github.com/<collaborator>/<repo>.git
```

## Force-push protocol

Always use `--force-with-lease`, never bare `--force`:

```bash
# Safe: verifies remote tracking branch matches expected SHA
git push --force-with-lease origin <branch-name>

# DANGEROUS: overwrites any remote changes, including work by collaborators
git push --force origin <branch-name>  # NEVER DO THIS
```

`--force-with-lease` checks that the remote tracking branch matches your local expectation. If someone else pushed between your last fetch and your force-push, the lease check fails safely instead of destroying their work.

## Rebase workflow

To sync a fork PR branch with upstream/main:

```bash
# Fetch latest from upstream
git fetch upstream

# Rebase your branch onto upstream/main
git rebase upstream/main

# Resolve conflicts if any, then continue
git rebase --continue

# Force-push the rebased branch to your fork
git push --force-with-lease origin <branch-name>
```

After rebase + force-push, the PR head SHA changes. All CI checks re-trigger (subject to workflow approval for fork PRs).

## Stale CI verification

After a rebase or force-push, verify CI check data belongs to the current PR head:

```bash
# Get current PR head SHA
gh pr view <number> --repo <upstream-owner>/<upstream-repo> --json headRefOid --jq '.headRefOid'

# Check if CI checks match this SHA
gh pr checks <number> --repo <upstream-owner>/<upstream-repo> --json name,state,startedAt,completedAt
```

If check data references an older SHA, the checks are stale. Cancel obsolete runs only after confirming they are not the current head:

```bash
# Cancel a specific run (only if it's NOT the current head)
gh run cancel <run-id> --repo <upstream-owner>/<upstream-repo>
```

## Bot review multi-round awareness

Automated bot reviewers (e.g., hermes-pr-review) post a new review after **every push**. If you push N times, you get N bot reviews. This is expected behavior, not a bug.

### Strategy

1. **Ignore APPROVE rounds** from bots. A bot APPROVE after a trivial push adds no signal.
2. **Scan for new findings only.** Compare the latest bot review against prior rounds to identify newly raised issues.
3. **Focus on human reviewer findings.** Bot findings are advisory; human reviewer findings are binding.
4. **Do not attempt to silence the bot.** The multi-round pattern is by design.

## Cross-references

- `.claude/skills/commit-pr/SKILL.md` — PR publication protocol, including `--force-with-lease` guidance and remote check verification
- `.opencode/skills/swarm-pr-feedback/SKILL.md` — Feedback closure workflow for addressing review findings
- `.agents/skills/subprocess-safety/SKILL.md` — Subprocess safety for `gh` CLI calls

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Git и GitHub» →
github swarmclawai Управляет задачами, пулл-реквестами и CI-пайплайнами на GitHub через утилиту gh. Разбирает упавшие тесты и проверяет статус PR прямо в чате. CX Codex +1 ★ 710звёзд репо pr-babysitter mblode Скилл pr-babysitter отслеживает открытый пуллреквест на GitHub: устраняет конфликты слияния, чинит упавший CI и разбирает замечания ревьюеров. CX Codex +1 604установок github-operations OrchestKit Скилл github-operations управляет issues, pull requests, milestones и Projects v2 через gh CLI, REST и GraphQL. Включается при работе с ресурсами GitHub. CX Codex +1 230установок babysit michael-denyer Скилл babysit следит за открытым пул-реквестом: чинит упавший CI, разбирает простые замечания ревью и доводит ветку до состояния, когда её можно влить. CX Codex +1 1 100установок fix-ci cursor Скилл fix-ci для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — находит упавшие проверки PR, читает логи и применяет минимально нужный фикс. CX Codex +1 2 600установок gh-stack официальный github Управляет цепочками связанных пулл-реквестов через расширение gh stack. Помогает агенту делить крупные задачи на слои и не зависать в интерактивном TUI. CX Codex +1 21 500установок

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

Весь набор →
swarm-pr-feedback Скилл swarm-pr-feedback для Claude Code собирает известные замечания к PR в реестр, проверяет каждое по коду и только после этого вносит правки. Разбирает замечания ревью, сбои CI и конфликты. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для автоматической обработки замечаний к pull request, падений CI и конфликтов слияния перед публикацией правок. CX Codex +1 ★ 539звёзд репо commit-pr Скилл commit-pr проверяет код перед пушем, создаёт конвенциональные коммиты и оформляет PR-описание. Включается при подготовке изменений к отправке. CX Codex +1 ★ 539звёзд репо test-file-split Скилл test-file-split разбивает разросшийся тест-файл на части по блокам describe(), когда тот подходит к лимиту в 500 строк или уже перевалил его. CX Codex +1 ★ 539звёзд репо parallel-work-check Скилл parallel-work-check для Claude Code сравнивает локальное состояние существующей ветки с удалённым и проверяет новые коммиты. Помогает заметить параллельные изменения до начала правок. CX Codex +1 ★ 539звёзд репо design-docs Ведёт design-доки проекта: домен, техспеку, behavior-спеку, реестр section-ID и changelog. Запускается по заголовку [MODE: DESIGN_DOCS ...]. CX Codex +1 ★ 539звёзд репо orchestrating-subagents Скилл orchestrating-subagents для Claude Code задаёт правила декомпозиции задач: выбор моделей для ролей, параллельный запуск исследователей и независимую приёмку кода ревьюерами. CX Codex +1 ★ 539звёзд репо commit-pr Скилл commit-pr ведёт работу с коммитами и pull request: от подготовки публикации до проверки CI и завершения PR. Он пригодится при выпуске изменений по GitHub issue. CX Codex +1 ★ 539звёзд репо

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

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