Toolverse
Wszystkie skille

changeset-validation

autor: openai

Waliduj zmiany w pakietach za pomocą AI — sprawdzaj zgodność changesetów z git diffami

Instalacja

Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.

Instalacja

O skillu

Skill do automatycznej walidacji changesetów w projektach JavaScript. Wykorzystuje LLM do analizy zmian w plikach pakietów i katalogach .changeset/, porównując je z git diffami (włączając niezatwierdzone zmiany lokalne). Weryfikuje zgodność changesetów z regułami repozytorium, sprawdza poprawność poziomu bump'a (patch/minor/major) i zapewnia, że opisy zmian odzwierciedlają rzeczywiste modyfikacje kodu. Idealny dla zespołów pracujących nad wielopakietowymi projektami, gdzie konsystencja changesetów jest kluczowa.

Jak używać

  1. Zainstaluj skill w swoim projekcie openai-agents-js, upewniając się, że masz dostęp do poleceń pnpm i pliku referencyjnego references/validation-prompt.md zawierającego reguły walidacji.
  2. Uruchom polecenie pnpm changeset:validate-prompt, aby wygenerować kontekst promptu na podstawie bieżących zmian w katalogach packages/ i .changeset/ oraz niezatwierdzonych modyfikacji w gicie.
  3. Przejrzyj wygenerowany prompt i zastosuj reguły z pliku validation-prompt.md, aby ocenić poprawność changesetów — sprawdź, czy opisy zmian zgadzają się z diffami, czy poziom bump'a jest prawidłowy (patch dla poprawek, minor dla nowych funkcji, major tylko po pierwszym wydaniu), oraz czy eksperymentalne funkcje oznaczone jako preview mogą pozostać na poziomie patch.
  4. Przygotuj werdykt w formacie JSON zawierający pola: ok (czy changeset jest poprawny), errors (lista błędów krytycznych), warnings (ostrzeżenia), required_bump (wymagany poziom bump'a: patch/minor/major/none) — wszystkie ciągi znaków w języku angielskim.
  5. Jeśli changeset wymaga poprawy, zaktualizuj istniejący plik .changeset/*.md (nie dodawaj nowego) i ponownie uruchom walidację, aż do uzyskania pozytywnego werdyktu.
  6. W środowisku CI użyj polecenia pnpm changeset:validate-prompt -- --ci --output .github/codex/prompts/changeset-validation.generated.md, aby wygenerować prompt dla akcji GitHub, a następnie uruchom openai/codex-action z wygenerowanym promptem i schematem JSON do otrzymania strukturalnego werdyktu.

Podobne skille