Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

backporting

/backporting

Opisuje backport poprawki z main do gałęzi utrzymaniowych editor-v6.x i editor-v7.x w monorepo Portable Text Editor: układ gałęzi, procedura, changesety i kształt commita.

Repozytorium
editor ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.10.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
0
Przestarzałość

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

Opisuje backport poprawki z main do gałęzi utrzymaniowych editor-v6.x i editor-v7.x w monorepo Portable Text Editor: układ gałęzi, procedura, changesety i kształt commita.

Oryginalny opis (EN)

How to backport a fix from `main` to a maintenance branch (`editor-v6.x`, `editor-v7.x`) in the Portable Text Editor monorepo. Use when a fix that shipped on `main` must also ship for an older major. Covers the branch layout, the verify-adapt-red-verify procedure, version-suffixed changesets, and the backport commit/PR shape, with real exemplars.

Jak działa

  1. Branch layout
  2. When to backport
  3. Procedure
  4. Commit shape
  5. PR shape
  6. After merge
Sekcje z nagłówków SKILL.md, w oryginale · 35 linii, 607 słów
Podgląd SKILL.md
---
name: backporting
description: How to backport a fix from `main` to a maintenance branch (`editor-v6.x`, `editor-v7.x`) in the Portable Text Editor monorepo. Use when a fix that shipped on `main` must also ship for an older major. Covers the branch layout, the verify-adapt-red-verify procedure, version-suffixed changesets, and the backport commit/PR shape, with real exemplars.
---

# Backporting fixes

## Branch layout

`main` carries the current major, and the upcoming major is prereleased from `next` (see the `next-branch` skill). Older majors live on maintenance branches named `editor-v<N>.x` (currently `editor-v6.x` and `editor-v7.x`). Each maintenance branch has its own working release pipeline: `release.yml` on that branch triggers on pushes to itself, and the changesets bot opens "Version Packages" PRs from `changeset-release/editor-v<N>.x`. Merging a backport PR that carries a changeset is all it takes; no manual publishing.

## When to backport

A fix lands on `main` and the bug also exists on an older line that consumers still run. Backporting is per-branch: a bug present on both v6 and v7 gets two backport PRs, one per branch (#2919 and the equivalent v7 port shipped separately).

## Procedure

1. **Worktree per backport**, branched off the maintenance branch: `git worktree add ../editor-<change>-v6 -b <change>-v6 origin/editor-v6.x`. Branch name is the change name with a `-v6`/`-v7` suffix. Run `pnpm install` and build the affected package before testing; the branch's dependency tree differs from `main`'s.
2. **Verify the branch carries the bug before porting anything.** Find the culprit commit on the branch (`git log` for the regression source) or run the fix's test against the unpatched branch and watch it fail. If the bug does not reproduce, there is nothing to backport; say so and stop.
3. **Port the fix, adapting to the branch.** Cherry-pick the `main` commit when it applies cleanly, otherwise re-apply by hand. The old line often differs structurally (different package splits, older APIs); each adaptation is deliberate and gets named in the commit and PR (#2919: the test imports `defineSchema` from the package root because v6 predates the `@portabletext/schema` split).
4. **Port the tests and red-verify on this branch.** The pinning tests come along and must fail on the unpatched branch, the same red-verification bar as `main` (see the `writing-tests` skill). "Red-verified on this branch" belongs in the commit body.
5. **Write a fresh changeset**, patch bump, slug suffixed with the line (`readonly-selection-sync-v6.md`). The consumer prose is the same as the `main` changeset (see the `changesets` skill); the release pipeline on the branch turns it into a patch release of the old major.
6. **Run the same gates as any change**: `pnpm check:types`, `check:lint`, the affected package's tests, `pnpm build`, root `check:format` and `check:knip`.

## Commit shape

Same subject as the `main` commit, no version suffix. The body opens with "Backport of the fix that shipped on main." and then carries the full mechanism prose per the `commits` skill; a backport body must stand on its own because the branch's history never contains the `main` commit. Close with the red-verification note and any branch adaptations. Exemplars: `7f2b3b5de` (v6), `76d57a094` (v7).

## PR shape

- Draft PR with `--base editor-v<N>.x`. Title is the commit subject, optionally suffixed "(v6)"/"(v7)" to disambiguate in PR lists (#3151, #2919).
- The body is the `main` PR's narrative, then a closing paragraph that names it a backport: "Backport of #NNNN to the `editor-v6.x` line", why the branch carries the bug (the culprit commit is present in which shipped version), and the adaptations. #2919's closing paragraph is the exemplar:

> Backport of #2918 to the `editor-v6.x` line, which carries the same regression (`2a3e03934`'s early return is present in 6.6.6). Same one-line gate yield, same two pinned scenarios, red-verified on this branch; the only adaptation is the test importing `defineSchema` from the package root since v6 predates the `@portabletext/schema` split.

## After merge

Nothing manual. The push to the maintenance branch triggers its release workflow, the changesets bot opens "Version Packages" on `changeset-release/editor-v<N>.x`, and merging that PR publishes the patch release of the old major.

Wersje

W bazie nie ma innych skilli o nazwie backporting.

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

  • 100changesets
    Opisuje pisanie changesetów w monorepo Portable Text Editor: dobór poziomu wersji, zasadę odzwierciedlania commita, styl dla konsumentów i changesety API, z przykładami z historii repozytorium.
  • 100backport
    Przenosi scaloną zmianę CPython do gałęzi utrzymaniowej (3.14, 3.13 i inne) jako gałąź w konwencji cherry_picker i proponuje otwarcie PR z backportem.
  • 100pr-backport
    Przenosi scalony PR na gałąź wydania przez cherry-pick poprawki lub funkcji do starszej gałęzi.
  • 100next-branch
    Opisuje działanie gałęzi prerelease next dla nadchodzącej wersji głównej edytora w monorepo Portable Text Editor: synchronizację w jedną stronę, reguły konfliktów i wydanie stabilne.
  • 100backport-pr
    Przenosi scalony PR do gałęzi utrzymaniowej v10 w getsentry/sentry-javascript przez cherry-pick, z przestrzenią nazw w tytule (na przykład fix(v10/core)), otwiera szkic PR i dokumentuje odstępstwa od oryginału.
  • 100backport-pr
    Przenosi scalony pull request Next.js z canary do gałęzi wydania LTS: znajduje commit, tworzy gałąź backportu, wykonuje cherry-pick, waliduje i otwiera PR z gałęzią wydania jako bazą.

Uwagi i zgłoszenia

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