Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

github-pr-body

/github-pr-body

Aktualizuje treść opisu PR deterministycznymi sekcjami bazowymi i opcjonalnym pełnym uzupełnieniem, przy tworzeniu PR lub regeneracji podsumowań z szablonu.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
18.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
28
Skrypty
12
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 12 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/lib/all.sh, scripts/lib/aws.sh, scripts/lib/common.sh, scripts/lib/csv.sh, scripts/lib/json.sh, scripts/lib/repo_paths.sh, scripts/lib/terraform.sh, scripts/lib/validation.sh, scripts/lib/yaml_map_order.py, scripts/pr_body.sh, scripts/pr_comment.sh, scripts/pr_fetch.sh

Co robi i kiedy

Aktualizuje treść opisu PR deterministycznymi sekcjami bazowymi i opcjonalnym pełnym uzupełnieniem, przy tworzeniu PR lub regeneracji podsumowań z szablonu.

Oryginalny opis (EN)

Update PR body content with deterministic baseline sections and optional full-body completion. Use when creating PRs or regenerating template-driven summaries.

Jak działa

  1. Input
  2. Output Specification
  3. Execution Scope
  4. Reference Files Guide
  5. Workflow
Sekcje z nagłówków SKILL.md, w oryginale · 115 linii, 599 słów
Podgląd SKILL.md
---
name: github-pr-body
description: >-
  Update PR body content with deterministic baseline sections and optional full-body completion.
  Use when creating PRs or regenerating template-driven summaries.
license: Apache-2.0
metadata:
  author: y-miyazaki
  version: "1.0.2"
---

## Input

- PR number and `owner/repo` (required)
- Existing PR template/body context (required)
- Authenticated `gh` environment (required)

## Output Specification

Return structured Markdown in accordance with [references/common-output-format.md](references/common-output-format.md).

Structured PR output:

- Baseline mode: update `## Overview` and `## Changes`.
- Full-body mode: apply complete body via `--body-file`.
- `## Changes` must classify files (Config/Docs/Feature/Test/Other) with line counts.
- Report selected mode and reason.

## Execution Scope

- **Always use `scripts/pr_body.sh` or `scripts/pr_fetch.sh`**. Do not run individual `gh` commands.
- `pr_body.sh` is deterministic and idempotent.

### USE FOR:

- generate deterministic baseline PR body sections
- regenerate PR body from template sections after code updates
- fill remaining sections in full-body mode from validated context

### DO NOT USE FOR:

- post review comments or resolve review threads
- create commits or modify source files
- replace issue triage workflows

## Reference Files Guide

- [common-checklist.md](references/common-checklist.md) (always read)
- [common-output-format.md](references/common-output-format.md) (always read)
- [common-troubleshooting.md](references/common-troubleshooting.md) (read on failure)
- [category-pr-body-guidelines.md](references/category-pr-body-guidelines.md) (read when full-body mode)
- [category-template-mapping.md](references/category-template-mapping.md) (read when full-body mode)
- [category-change-classification.md](references/category-change-classification.md) (read when classifying changes)
- [category-command-reference.md](references/category-command-reference.md) (read on debugging)
- [category-implementation-details.md](references/category-implementation-details.md) (read on debugging)
- [category-agent-workflows.md](references/category-agent-workflows.md) (read on debugging)

## Workflow

1. Fetch PR metadata:

   ```bash
   scripts/pr_fetch.sh <PR_NUMBER> --repo <OWNER/REPO>
   ```

   Parse JSON output to obtain: title, body, file list, additions/deletions, headRefName, baseRefName.

2. Generate deterministic baseline (`## Overview`, `## Changes`):

   ```bash
   scripts/pr_body.sh <PR_NUMBER> --repo <OWNER/REPO> --dry-run
   ```

   Review dry-run output. If acceptable, apply:

   ```bash
   scripts/pr_body.sh <PR_NUMBER> --repo <OWNER/REPO>
   ```

3. Select mode:

   - Baseline mode: request scope is summary refresh only → skip to Step 6.
   - Full-body mode: request explicitly asks to populate all template sections → continue to Step 4.

4. Generate AI-completed content (full-body mode only):

   1. Read [category-pr-body-guidelines.md](references/category-pr-body-guidelines.md). Read [category-template-mapping.md](references/category-template-mapping.md) when template comment guidance is ambiguous.
   2. Read `.github/PULL_REQUEST_TEMPLATE.md` from the repository.
   3. For each H2 section in the template:
      - If the section comment contains an `Example:` block, follow that structure to generate visible content.
      - If the section comment contains checkbox guidance, generate or update checkbox lines in the same format.
      - If the section has no guidance, preserve the section heading and template comment without inventing content.
   4. Keep `## Overview` and `## Changes` content from Step 2 output.
   5. Write the complete PR body (all sections) to a temporary file (e.g., `/tmp/completed_pr_body.md`).

5. Apply full body (full-body mode only):

   ```bash
   scripts/pr_body.sh <PR_NUMBER> --repo <OWNER/REPO> --body-file /tmp/completed_pr_body.md
   ```

6. Verify success:
   ```bash
   gh pr view <PR_NUMBER> --repo <OWNER/REPO> --json body --jq '.body'
   ```
   Confirm `## Overview` and `## Changes` sections are present and non-empty. In full-body mode, confirm `## Testing`, `## Type of Change`, `## Checklist`, and `## Additional Notes` contain visible content.

### Error Handling

| Condition                                  | Severity    | Action                                               |
| ------------------------------------------ | ----------- | ---------------------------------------------------- |
| `gh` not authenticated                     | Fatal       | Stop; instruct `gh auth login`                       |
| PR not found (404)                         | Fatal       | Verify PR number and `owner/repo`                    |
| Access denied (403)                        | Fatal       | Verify `repo` write scope                            |
| `pr_fetch.sh` or `pr_body.sh` missing      | Fatal       | Stop; report missing script                          |
| `.github/PULL_REQUEST_TEMPLATE.md` missing | Recoverable | Baseline mode only; skip full-body template sections |
| Body exceeds GitHub size limit (422)       | Recoverable | Truncate or split content; report in output          |
| Rate limit exceeded (429)                  | Recoverable | Defer update; note retry window in report            |
| Dry-run output unacceptable                | Info        | Do not apply; report diff issues and stop            |

### Examples

- Prompt: `Generate PR body for PR #42`
- Result: PR body updated via `scripts/pr_body.sh`; report mode and reason per [references/common-output-format.md](references/common-output-format.md).
Pliki w paczce (28)
  • SKILL.md 6 KB
  • eval.yaml 1 KB
  • evals/tasks/github-pr-body-basic.yaml 1 KB
  • evals/tasks/github-pr-body-boundary-guardrail.yaml 1 KB
  • evals/tasks/github-pr-body-multi-file-changes.yaml 1 KB
  • evals/tasks/github-pr-body-structured-output.yaml 1 KB
  • evals/tasks/github-pr-body-trigger-negative.yaml 1 KB
  • references/category-agent-workflows.md 6 KB
  • references/category-change-classification.md 10 KB
  • references/category-command-reference.md 9 KB
  • references/category-implementation-details.md 8 KB
  • references/category-pr-body-guidelines.md 13 KB
  • references/category-template-mapping.md 14 KB
  • references/common-checklist.md 1 KB
  • references/common-output-format.md 2 KB
  • references/common-troubleshooting.md 10 KB
  • scripts/pr_body.sh 28 KB
  • scripts/pr_comment.sh 8 KB
  • scripts/pr_fetch.sh 9 KB
  • scripts/lib/all.sh 1 KB
  • scripts/lib/aws.sh 29 KB
  • scripts/lib/common.sh 9 KB
  • scripts/lib/csv.sh 4 KB
  • scripts/lib/json.sh 8 KB
  • scripts/lib/repo_paths.sh 15 KB
  • scripts/lib/terraform.sh 13 KB
  • scripts/lib/validation.sh 14 KB
  • scripts/lib/yaml_map_order.py 6 KB

Wersje

W bazie nie ma innych skilli o nazwie github-pr-body.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 34730f804e27 (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

  • 100update-pr-body
    Aktualizuje treść opisu pull requestu na GitHubie, gdy trzeba zmienić lub poprawić jego body.
  • 100pr-description
    Renderuje kanoniczną treść opisu PR dla tekstów przekazywanych do gh pr create, takich jak body, podsumowanie czy szablon pull requesta.
  • 100pr
    Pisze lub aktualizuje opis pull requesta według szablonu repozytorium, z dowodami i walidacją z uruchomionych poleceń.
  • 100pr-style
    Definiuje format tytułu i opisu pull requesta na GitHubie z sekcjami Why, What i Notes, niezależnie od użytego narzędzia (gh CLI, GitHub MCP, API).
  • 86update-pr-summary
    Aktualizuje opis i tytuł pull requesta, przepisując jego treść na prośbę użytkownika lub po wywołaniu update-pr-summary.
  • 96pr
    Ustala kształt treści pull requesta i pomaga go poprawić przy tworzeniu lub edycji opisu.

Uwagi i zgłoszenia

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