Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

pr-workflow

/pr-workflow

Pilnuje kontroli przed PR-em, atomowych commitów, linków do wydań zależności i powiązań z issue przy tworzeniu i recenzji PR-ów.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pilnuje kontroli przed PR-em, atomowych commitów, linków do wydań zależności i powiązań z issue przy tworzeniu i recenzji PR-ów.

Oryginalny opis (EN)

Use when preparing, creating, updating, or reviewing pull requests — enforcing pre-PR checks, atomic commits, dependency release links, and issue linkage (GitHub primary, non-GitHub referenced).

Jak działa

  1. Preflight
  2. Branching & Guardrails
  3. Commit Hygiene
  4. Issue Linking
  5. PR Lifecycle (GitHub Primary)
Sekcje z nagłówków SKILL.md, w oryginale · 94 linii, 749 słów
Podgląd SKILL.md
---
name: pr-workflow
description: Use when preparing, creating, updating, or reviewing pull requests — enforcing pre-PR checks, atomic commits, dependency release links, and issue linkage (GitHub primary, non-GitHub referenced).
license: MIT
metadata:
  capabilities: shell, network, git-history, forge-writes, runs-repo-commands
---

# PR Workflow

Standard operating procedure for preparing, opening, and managing Pull Requests (PR) and Merge Requests (MR). Default to GitHub (`gh` CLI); for other platforms, see [platform-tools.md](references/platform-tools.md).

## Preflight

- **Base Sync**: Before creating a feature branch or starting a new task, fetch and sync the default base branch (`git fetch origin && git checkout main && git pull --ff-only` or branch directly off `origin/main`).
- **Clean Working Tree**: Verify `git status` is clean before editing or opening PRs.
- **Verification**: Run local **tests** and **linters** in the primary session rather than a subagent before opening or updating PRs; a failure needs their full output.

### Worker routing

Request the cheapest capable model and lowest sufficient effort (`low` for
routine); unsupported overrides inherit parent/configured defaults. Report
requested/actual only from runtime metadata, else inherited/unknown.

If a named role is unavailable/unsupported or returns an explicit
pre-execution dispatch/runtime error (for example capacity, rate limit,
rejected model, or launch error), try one generic fallback that preserves
the named worker's tools and permissions:

- **Log:** exact approved local artifact only; reject unsafe input; report causes
  and events without fetching runs.
- **Evidence:** caller's scenario only; stop what it started; no Git mutation
  or upload; report per-step expected, observed, verdict, and paths.

Otherwise use primary; a generic pre-execution failure also falls back to
primary. Once a worker begins its assigned workload, its rejection or failure
is final: no other worker, primary rerun, stronger model, or higher effort.
If a dispatch error does not reveal whether execution began, stop that
dispatch and report the ambiguity; do not retry or duplicate that workload.

## Branching & Guardrails

- **Branch Guard**: Stay on feature branches; never push or merge directly into the default base branch without explicit approval.
- **Base Discovery**: Detect the base branch dynamically from repo evidence (`origin/HEAD`, PR target).
- **Fork Safety**: Confirm with user before opening PRs on upstream or third-party forks.
- **Stacked PRs**: Prefer native stacks over hand-set feature-branch bases —
  GitHub `gh stack` (public preview; official
  [`github/gh-stack` skill](https://github.com/github/gh-stack)), GitLab
  `glab stack` (experimental; bundled `glab-stack` skill). Hand-stacked: merge
  bottom-up, retargeting each PR onto the default branch first — closing
  keywords only fire there.

## Commit Hygiene

- **Atomic Commits**: Keep commits single-concern. Include release/changelog URLs on single dependency bumps.
- **Non-interactive**: Pass `GIT_EDITOR=true` or `--no-edit` on git rebase/commit/merge to bypass GUI editor prompts.

## Issue Linking

- **Auto-close**: Reserve `Closes #N`, `Fixes #N`, or `Resolves #N` solely for PRs that auto-close the issue on merge.
- **Part-of**: Use `Part of #N` or `See #N` for epic tracking and multi-PR tasks. GitHub matches those tokens even inside negation — never write `Closes #N` (or Fix/Resolve) next to an issue you must not close.
- **No Tracked Issue**: When a PR has no tracked issue, drop the Related Issue section entirely — never leave an unlinked `Closes #` or empty issue marker in the PR body.

## PR Lifecycle (GitHub Primary)

For GitLab, Gitea, Azure DevOps, or Bitbucket, see [platform-tools.md](references/platform-tools.md).

For a caller-selected remote failure log, classify and scope the source before
delegation. The primary downloads only that log to a local artifact; the worker
never fetches remote logs or discovers unrelated runs. Low-risk build, lint,
and test artifacts may go to a named `log-summarizer` after caller review.
Potentially sensitive logs require a sanitized artifact and residual-secret
gate first; otherwise keep them in primary.
Use the worker-routing fallback above when the named summarizer is unavailable
or unsupported.

Before writing the request body, read the repo's `docs/agents/pull-request.md`
(or equivalent: `docs/agents/merge-request.md`, native `.github` / GitLab
templates) and follow its description shape and visual table, keying the
visual to the user-visible change — a CLI or UI output change wins over an
internal flowchart even when one exists. Where the table asks for a
before/after pair, show both states, not just the after. Keep a multi-line
text capture in a fenced block of its own under its Before or After label.

For a running-app capture of more than a step or two, hand a named
`evidence-collector` the scenario (entrypoint, fixtures, steps, expected
observations); on Cursor CLI keep it in primary. Judge the captures, mask
flagged regions, then `--attach`.

### Create PR
```bash
gh pr create --title "<type>(<scope>): <summary>" --body "<description>"
```

### Update PR (Amend / Force-push)
```bash
gh pr edit <pr_number> --title "<updated_title>" --body "<updated_body>"
```

**Guard body rewrites**: fetch, edit, and write back a PR/MR/issue body in one `set -euo pipefail` block; never write an empty or shrunken body (`test -s`) — see [body-rewrite.md](references/body-rewrite.md).
Pliki w paczce (4)
  • SKILL.md 5 KB
  • skill.oms.sig 12 KB
  • references/body-rewrite.md 1 KB
  • references/platform-tools.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · akunzai/agent-skills100MIT
hugrverk/riggverk100MIT
notque/vexjoy-agent100MIT
TheLobbi/claude100MIT
tencent-hunyuan/unirl100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 6afb1d9eb56a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100git-workflow
    Opisuje wzorce Git dla atomowych commitów, zarządzania gałęziami i operacji na historii oraz jej przeszukiwania.
  • 100github-automation
    Automatyzuje przepływy GitHub: zarządzanie PR-ami, śledzenie zgłoszeń, koordynację code review, automatyzację wydań i integrację z GitHub Actions.
  • 100github
    Obsługuje GitHub przez gh CLI: pull requesty, issues, status CI, uruchomienia workflow, informacje o repozytorium oraz tworzenie, recenzowanie i scalanie PR.
  • 91github-pr-audit
    Sprawdza pull request lub issue w GitHubie przed scaleniem, pod kątem ryzyk i jakości.
  • 100github-pr-workflow
    Automatyzuje pełny cykl życia pull requesta przez GitHub MCP: otwarcie, prośby o review, etykiety i scalenie.
  • 100gh-implement-issue
    Realizuje issue z GitHuba od gałęzi do PR: czyta komentarze, potwierdza kontrakt implementacji, tworzy gałąź, robi atomowe commity, waliduje, wypycha i otwiera lub aktualizuje pull request.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.