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

commit-pr · zaxbyhub — скилл для Claude Code: публикация PR и установка

Скилл commit-pr ведёт работу с коммитами и pull request: от подготовки публикации до проверки CI и завершения PR. Он пригодится при выпуске изменений по GitHub issue.

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

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

Что делает commit-pr

commit-pr задаёт порядок публикации изменений в репозитории opencode-swarm: перед коммитом или обновлением PR нужно прочитать канонический скилл .claude/skills/commit-pr/SKILL.md. Для команд git, gh, сборки, тестов и CI он предписывает использовать оболочку, а ручные правки делать через apply_patch. Ветки с открытым PR обновляют, а не используют для создания второго.

Скилл различает новую публикацию, работу с существующим PR и его завершение. Он требует сверять удалённые проверки с текущим SHA ветки, учитывать статус CI и обновлять описание PR после изменения проверок. Готовность к слиянию нельзя объявлять, пока обязательные проверки не завершились успешно, если пользователь явно не согласовал иное. Это важно: зелёный локальный прогон сам по себе не подтверждает состояние проверок на GitHub.

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

  • подготовить ветку к публикации изменений
  • обновить существующий PR после замечаний
  • проверить статус CI для текущего коммита
  • сверить готовность PR к слиянию
  • добавить комментарий к закрываемой issue

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

  • Опубликуй изменения по этой issue и проверь удалённые проверки перед завершением PR.
  • Обнови существующий PR после исправлений по ревью и проверь, что проверки относятся к текущей версии ветки.
  • Подготовь PR к слиянию: обнови описание и проверь обязательные CI-проверки.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/commit-pr/SKILL.md

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

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

Вопросы о commit-pr

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

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

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

Он задаёт порядок коммитов и работы с PR в opencode-swarm, включая проверку удалённого CI, обновление существующего PR и подтверждение его готовности.

Нужно ли проверять CI после обновления PR?

Да. Скилл требует проверять, что результаты относятся к текущему SHA ветки, и не считать PR готовым к слиянию, пока обязательные проверки не зелёные.

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

SKILL.md · MIT
---
name: commit-pr
description: >
  Mandatory Codex/Copilot publication adapter for opencode-swarm. Use for every
  GitHub issue assignment that results in code changes, commits, pushes, draft PRs,
  PR body edits, PR readying, release notes, or CI closeout. Must be loaded before
  `git push`, `gh pr create`, `gh pr edit`, or `gh pr ready`. Routes to the single
  canonical source of truth at `.claude/skills/commit-pr/SKILL.md`.
metadata:
  audience: swarm-plugin
---

# Commit & PR

Use this skill for Codex-side publication work in `opencode-swarm`.

## Source Of Truth

Read and follow [`../../../.claude/skills/commit-pr/SKILL.md`](../../../.claude/skills/commit-pr/SKILL.md) in full before committing, pushing, opening, or updating a PR.

That Claude skill remains the repository's canonical publish protocol. This Codex-native skill is the adapter layer: it tells Codex which tools to use, how to handle existing PRs, and how to finish the post-open lifecycle without drifting from the repo contract.

If instructions conflict:

1. `AGENTS.md`
2. `docs/engineering-invariants.md`
3. `../../../.claude/skills/commit-pr/SKILL.md`
4. this file

## Codex Execution Rules

- Use the available shell execution tool for `git`, `gh`, build, test, and CI commands.
- Use `apply_patch` for manual file edits.
- Use the runtime's parallel-execution capability for independent reads, status checks, and non-conflicting repo inspections.
- Do not stage `.Codex/`, IDE-local files, or unrelated worktree changes.
- Do not open a second PR when one already exists for the branch. Update the existing PR instead.

## Publish Modes

Infer the mode from the user request and branch state:

- `new-pr`: branch is ready to publish and no PR exists yet
- `pr-followup`: a PR already exists and you are addressing review feedback or syncing validation
- `closeout`: a PR already exists and you are updating body text, waiting on CI, marking ready, or confirming merge prerequisites

## Required Follow-Through

### Existing PR updates

If the branch already has a PR:

- inspect unresolved PR feedback surfaces before updating or readying the PR:
  review threads/comments, requested-changes reviews, CI/check failures,
  mergeability/conflicts, and whether check data belongs to the current head SHA
- update the existing PR body instead of creating a new PR
- refresh `## Summary`, `## Invariant audit`, and `## Test plan` when validation counts, caveats, or evidence changed
- verify the PR still points at the pushed branch head after any force-push
- use `$swarm-pr-feedback` when feedback needs fixes before closeout

### Draft vs ready

Default behavior:

- open or keep the PR as draft while follow-up edits are still expected, required checks are pending, or known caveats still need explanation
- mark the PR ready only after the body is current and required remote checks are green

If the user explicitly asks for a ready PR sooner, obey that request and document any remaining CI state clearly.

### Remote checks are authoritative

When the user asks to open, ship, ready, or close out a PR:

1. inspect remote checks with `gh pr view <n> --json statusCheckRollup,...` or `gh pr checks <n>`
2. verify check data belongs to the current `headRefOid` after every follow-up push
3. if a required job is `cancelled` and downstream jobs are `skipped`, inspect the run and rerun failed/cancelled jobs
4. if an obsolete older-head run is already failed or still consuming concurrency, inspect it before cancellation and cancel only when it is no longer the PR head under validation
5. wait for required checks to finish when practical
6. after conflict resolution, verify GitHub reports both `mergeable: MERGEABLE` and `mergeStateStatus: CLEAN`; local conflict-marker cleanup is not enough, and branch drift must appear in the closure ledger when it affected the PR
7. when `gh pr checks` looks stale, inspect the workflow run directly with `gh run view <run-id> --json headSha,status,conclusion,jobs,url`, and keep watching downstream integration/smoke jobs after unit jobs pass
8. if you edit the PR body after checks are green, expect PR Standards/title checks to rerun and re-check before calling the PR green
9. do not call the PR merge-ready while a required check is `cancelled`, `skipped`, `in_progress`, or otherwise non-green unless the user explicitly accepts that state

Recommended commands:

```powershell
gh pr view <number> --json body,headRefName,headRefOid,isDraft,mergeable,mergeStateStatus,state,statusCheckRollup,url
gh pr checks <number> --watch --fail-fast
gh run view <run-id> --json headSha,status,conclusion,jobs,url
gh run rerun <run-id> --failed
```

`dist/` is generated output and is not committed (#1047); do not stage it and there is no `dist-check` drift gate. If `package-check` fails, inspect the CI log: it is a source / build / `package.json#files` problem (an incomplete or unbuildable tarball), not generated-file drift. Fix the source or manifest and rerun `bun run package:smoke` locally.

After a forced install on Windows, `EPERM` while reading refreshed `node_modules`
is usually host friction; rerun the exact focused command with approved access
before treating it as a code failure.

### Issue comment requirement

If the PR closes an issue:

- confirm the issue comment exists with the PR link, what changed, how to use it, and migration notes
- if the PR merged before the comment was posted, add the missing issue comment immediately

## Working Pattern

1. Read `AGENTS.md`, `docs/engineering-invariants.md` as needed, and the canonical Claude `commit-pr` skill.
2. Run the required local validation from the canonical skill.
3. Stage only intended files.
4. Create or update the PR.
5. Refresh PR body text if the branch changed after review feedback.
6. Watch remote checks to a useful conclusion when the user asked for publication or closeout.
7. Verify issue comments, ready/draft state, and merge-readiness claims before finishing.

## Clean-Main And CI Reality Checks

When local validation is noisy or host-limited:

- compare suspicious failures against a clean `origin/main` worktree before blaming the branch
- document proven pre-existing failures in the PR body
- use remote CI as the cross-platform source of truth for merge-readiness

## Final Sanity Check

- one branch, one PR
- PR head matches pushed `HEAD`
- PR body matches current validation evidence
- issue comment exists when the PR closes an issue
- draft or ready state matches user intent
- required remote checks are green, or any remaining non-green state is explicitly explained

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Git и GitHub» →

Сначала — commit-pr от других авторов.

commit-pr ZaxbyHub Скилл commit-pr для Claude Code и Codex требует от агента пройти чек-лист до коммита, пуша и создания PR. CX Codex +1 ★ 539звёзд репо commit-pr ZaxbyHub Скилл commit-pr проверяет код перед пушем, создаёт конвенциональные коммиты и оформляет PR-описание. Включается при подготовке изменений к отправке. CX Codex +1 ★ 539звёзд репо commit-pr ZaxbyHub Скилл commit-pr для Claude Code ведёт агента через проверку изменений, подготовку коммита и публикацию PR. Процесс следует правилам релизного процесса opencode-swarm. CX Codex +1 ★ 539звёзд репо ce-commit-push-pr EveryInc Скилл ce-commit-push-pr коммитит изменения, отправляет ветку и открывает PR. Отдельно умеет составлять или переписывать описание PR без публикации кода. CX Codex +1 3 600установок commit-push-pr dyoshikawa Скилл commit-push-pr коммитит текущие изменения, отправляет ветку в remote и создаёт или обновляет pull request. Подходит для отправки готовой работы через GitHub. CX Codex +1 ★ 1 636звёзд репо gh-axi Kun Chen (kunchenguid) Скилл gh-axi для Claude Code управляет GitHub через CLI: от issue и pull request до релизов и Actions. Агент подключает его для задач, связанных с GitHub. CX Codex +1 10 400установок ship-it jssblck Скилл ship-it доводит завершённую правку до готового пул-реквеста: коммитит, пушит, открывает PR и следит за CI до зелёного. CX Codex +1 1 700установок pr-create Garrick Aden-Buie (@gadenbuie) Скилл pr-create для Claude Code, Codex, Cursor и других агентов: берёт текущие изменения, создаёт ветку, коммитит, открывает PR на GitHub и следит за CI. Если проверки падают — отлаживает и пушит фиксы до зелёного статуса. CX Codex +1 807установок babysit jssblck Скилл babysit следит за проверками GitHub PR до завершения и разбирает сбои, пропущенные проверки и блокеры. Полезен, когда нужно дождаться CI без ручного опроса. CX Codex +1 668установок

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

Весь набор →
fork-pr-operations Скилл fork-pr-operations инструктирует агента по работе с пулл-реквестами из форков: одобрение воркфлоу в GitHub Actions, безопасный rebase и сверка актуальности проверок CI. 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звёзд репо contributing Скилл contributing проводит агента по всему циклу пул-реквеста в репозитории opencode-swarm: ветка, формат коммитов, фрагмент release notes, локальные проверки и шаблон описания. CX Codex +1 ★ 539звёзд репо clarify-spec Скилл clarify-spec устраняет маркеры неопределённости в спецификациях Swarm, опрашивая разработчика по одному вопросу за раз. CX Codex +1 ★ 539звёзд репо pre-phase-briefing Скилл pre-phase-briefing собирает контекст перед фазой проекта, проверяет прошлые ретроспективы и сверяет план с реальным состоянием кодовой базы. CX Codex +1 ★ 539звёзд репо rust-crate-ci Скилл rust-crate-ci для правки Rust-крейта runners/swarm-sandbox-runner: задаёт порядок локальных проверок и разбирает ошибки Windows, которые видит только CI. CX Codex +1 ★ 539звёзд репо

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

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