Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

write-pr

/write-pr

Pisze opis pull requesta: zmianę, dowody i ryzyko scalenia, bez recenzowania i scalania.

Repozytorium
dkstack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
7
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.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

Pisze opis pull requesta: zmianę, dowody i ryzyko scalenia, bez recenzowania i scalania.

Oryginalny opis (EN)

Use when you write or materially update a pull request body. The body states the change, the evidence and the merge risk. It does not review or merge.

Jak działa

  1. When to refresh
  2. Sections
  3. Summary
  4. Evidence
  5. Risk and rollback
  6. References
  7. Examples
Sekcje z nagłówków SKILL.md, w oryginale · 112 linii, 658 słów
Podgląd SKILL.md
---
name: write-pr
description: "Use when you write or materially update a pull request body. The body states the change, the evidence and the merge risk. It does not review or merge."
---

# Write a pull request

Use when you write a pull request body, or when a material change makes the body wrong.

This skill governs the text of the pull request. It does not decide who may open the pull
request. It does not give a verdict. It does not merge. Those rules stay in
[code review](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/skills/code-review/SKILL.md)
and
[review and merge](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/workflow/review-and-merge.md).

Read [writing](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/writing/index.md). Use
[writing-check](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/skills/writing-check/SKILL.md)
on the body.

## When to refresh

Update the body after a material change to the implementation. Update it again before review.

## Sections

Use the sections below. Keep each section as short as the change allows. Remove a section that
would be empty.

The title is a conventional commit of 50 characters or fewer. See
[version control](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/version-control/index.md).
Use one issue for one pull request. Link the issue. See
[review and merge](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/workflow/review-and-merge.md).

## Summary

State what changed and why it matters. Name the people who are affected, such as users or
developers. Describe the behavior. Do not describe only the files.

Add a small visual only when it makes the change easier to see. You can use a diff sketch,
pseudocode, a call tree, a file tree, a diagram or a screenshot. Do not require a visual for a
trivial change. A trivial change can omit the visual.

## Evidence

Separate three kinds of statement.

- Verified: you ran the check, or you read a result for this change. Give the result.
- Unverified: you did not run the check. Say so.
- Known risk: a risk that remains. Name it.

Name each required check that did not run as NOT RUN. Do not say that a check passed unless the
result says that it passed.

A documentation-only change can have no test. Say why no test is needed.

When tests prove the behavior, list those tests in Evidence.
[Review and merge](https://raw.githubusercontent.com/daniel-kindl/dkstack/v1/workflow/review-and-merge.md)
requires that list.

## Risk and rollback

Consider the merge risk for every pull request.

When the risk is low, write one short sentence and name how to undo the change.

When the risk is not low, name the blast radius, compatibility, migration, rollback and
mitigation. Do not use that long form when the risk is low.

## References

Put the issue link in this section. Add any other link the reader needs. If the issue link is
already in another section and you have no other link, remove this section.

## Examples

These examples show the shape. They are not repository facts.

### Small documentation change

Summary: The install page names the current release branch. A reader can follow the branch
without a second document.

Evidence: No test. The change is documentation. The project check is NOT RUN.

Risk and rollback: Low risk. Revert this pull request.

References: Closes #12.

### Tested code fix

Summary: A failed call runs at most three times. Before the change, the call retried with no
limit. Callers receive the error after the third run.

Evidence: Verified: a test failed because the call retried past the third attempt. The same test
passed after the limit. The project check passed. Unverified: this change was not run on a
production host.

Risk and rollback: Low risk. Revert this pull request. The old retry behavior returns.

References: Closes #18.

### High-risk change

Summary: The public client method gains a required argument. Existing callers do not compile
until they pass the argument.

Evidence: Verified: the unit tests passed after the callers in this repository were updated. The
migration check failed on one external example, and the failure is recorded. Unverified: the
project check is NOT RUN. Known risk: callers outside this repository still use the old method.

Risk and rollback: The blast radius is every external caller of the method. Migration: each
caller adds the argument. Rollback: revert this pull request before other projects release a
version that calls the new method. Mitigation: the changelog names the argument and the old call.

References: Closes #24. See the versioning page.

Wersje

RepozytoriumWynikLicencja
Ta strona · daniel-kindl/dkstack100MIT
lvlup-sw/exarchos100Apache-2.0
2ykwang/agent-skills100MIT
moonshotai/kimi-code96MIT

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

  • 100pr
    Pisze treść pull requesta: krótkie podsumowanie wizualne, dowody przed i po oraz ocenę ryzyka scalenia.
  • 90pr
    Pisze opis pull requesta dla bieżącej zmiany jako lokalny szkic, przez tryb samego opisu skilla file-pr.
  • 88merge-risk
    Ocenia ryzyko scalenia pull requesta, gdy trzeba zdecydować, czy zmiany są bezpieczne do wdrożenia.
  • 80pull-request:update
    Aktualizuje opis pull requesta lub merge requesta, tak by odpowiadał bieżącemu stanowi zmian po kolejnych commitach.
  • 100pr
    Pisze lub aktualizuje opis pull requesta według szablonu repozytorium, z dowodami i walidacją z uruchomionych poleceń.
  • 92pr
    Pomaga przygotować opis pull requesta do zgłoszenia zmian.

Uwagi i zgłoszenia

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