C
changeset-validation
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ć
- 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.
- 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.
- 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.
- 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.
- Jeśli changeset wymaga poprawy, zaktualizuj istniejący plik .changeset/*.md (nie dodawaj nowego) i ponownie uruchom walidację, aż do uzyskania pozytywnego werdyktu.
- 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.