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

changeset-resolve

/changeset-resolve

Naprawia niewydany plik .changeset/*.md tak, by odpowiadał rzeczywistej różnicy gałęzi względem main, i sprawdza dowodami twierdzenia o usunięciu lub zmianie nazw przed commitem.

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

Brak sygnałów. Repozytorium zmienione 14.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 robi i kiedy

Naprawia niewydany plik .changeset/*.md tak, by odpowiadał rzeczywistej różnicy gałęzi względem main, i sprawdza dowodami twierdzenia o usunięciu lub zmianie nazw przed commitem.

Wyzwalacze z opisu

removed/gone/renamed
Oryginalny opis (EN)

Repair an unreleased `.changeset/*.md` file so it matches the real branch delta against `main`. Use when a changeset was edited iteratively during debugging, when bullets may reflect turn-by-turn history instead of `main...HEAD`, when "removed/gone/renamed" claims need proof, or when you need to audit whether a changeset is actually lossless before commit.

Jak działa

  1. Goal
  2. Hard Rules
  3. Mandatory Sequence
  4. Sanity Heuristics
  5. Exit Gate
Sekcje z nagłówków SKILL.md, w oryginale · 97 linii, 457 słów
Podgląd SKILL.md
---
description: Repair an unreleased `.changeset/*.md` file so it matches the real branch delta against `main`. Use when a changeset was edited iteratively during debugging, when bullets may reflect turn-by-turn history instead of `main...HEAD`, when "removed/gone/renamed" claims need proof, or when you need to audit whether a changeset is actually lossless before commit.
name: changeset-resolve
metadata:
  skiller:
    source: .agents/rules/changeset-resolve.mdc
---

# Changeset Resolve

Use the companion `changeset` skill for structure and versioning. This skill
owns the diff audit and the bullshit detector pass.

## Goal

Rewrite the active unreleased changeset so it describes the package-level,
user-facing branch delta against `main`, not the local iteration history.

## Hard Rules

- Diff against `main...HEAD`. Never diff against the current changeset draft.
- Reuse the existing unreleased changeset file. Do not create another one.
- Keep the release surface package-first:
  - `packages/kitcn`
  - `packages/resend`
  - root and `example` manifests/scripts when user-facing
  - docs only when they reveal public API shape
- Ignore repo noise unless it changes real user behavior:
  - `.claude`
  - `.agents`
  - tests
  - internal tooling churn
- If a bullet says something is gone, removed, renamed, or replaced, prove the
  old surface existed on `main` first.
- If it did not exist on `main`, it is not a breaking change. Rewrite it as a
  feature or delete it.
- Do not call a changeset lossless unless you actually audited the package
  surface. If unsure, say so.

## Mandatory Sequence

1. Resolve the active changeset:
   - list `.changeset/*.md` excluding `.changeset/README.md`
   - reuse the existing unreleased file

2. Audit the real branch delta against `main`:

```bash
git diff --stat main...HEAD -- packages/kitcn packages/resend package.json example/package.json www/content/docs
git diff --name-only main...HEAD -- packages/kitcn packages/resend package.json example/package.json www/content/docs
git diff main...HEAD -- packages/kitcn/package.json packages/resend/package.json package.json example/package.json
```

3. Audit the likely-missed public seams:
   - package `exports`
   - package `bin`
   - package `files`
   - peer dependency/support matrix
   - new packages
   - public CLI commands and flags

4. Prove every breaking bullet:

```bash
git show main:packages/kitcn/package.json
git show main:packages/kitcn/src/cli/config.ts
git grep -n "claim-you-are-making" main -- packages/kitcn packages/resend www/content/docs example
```

5. Classify honestly:
   - existed on `main` and changed incompatibly: `## Breaking changes`
   - new user-facing capability: `## Features`
   - same surface, better behavior or safer output: `## Patches`
   - test-only, docs-only, or internal churn: omit

6. Rewrite from scratch:
   - keep `## Breaking changes`, `## Features`, `## Patches`
   - user-facing only
   - no file paths
   - no implementation gossip

7. Run one final anti-lie pass:
   - re-check every breaking snippet against `main` and `HEAD`
   - scan manifests/exports one more time
   - if something still smells off, say it is not fully lossless yet

## Sanity Heuristics

- New command on this branch only: feature, not deprecation.
- New package on this branch only: feature.
- Tightened peer dependency support matrix: usually breaking.
- Moved import paths with old path removed: breaking.
- Renamed flag with old flag removed: breaking.
- Scenario/fixture proof improvements: patch only if users feel it.
- Docs sync alone: omit unless it reveals a real new surface.

## Exit Gate

Before done, run:

```bash
bun lint:fix
```

Wersje

W bazie nie ma innych skilli o nazwie changeset-resolve.

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

  • 100changeset
    Tworzy changeset dla zmian w gałęzi i pisze noty wydania dla zmienionych pakietów.
  • 100changeset-pr
    Tworzy lub poprawia plik .changeset/*.md dla bieżącej gałęzi lub PR, dobiera zakres pakietu i typ wydania oraz sprawdza wynik względem konfiguracji Changesets repozytorium.
  • 100changeset
    Tworzy changeset w monorepo Astro: dodaje plik changeset do PR, pisze wpis do changelogu i dokumentuje podbicie wersji pakietu.
  • 100changesets
    Tworzy lub odświeża plik .changeset/<slug>.md dla bieżącej gałęzi albo stwierdza, że changeset nie jest wymagany, zwłaszcza przy zmianach w packages/**.
  • 96changeset
    Pisze wpisy changeset do wydań, opisując zmiany w pakietach i ich wersjonowanie.
  • 100add-changeset
    Pisze changeset dla agentic-seo-check jako plik, bez pytań interaktywnych, w stylu changelogu.

Uwagi i zgłoszenia

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