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

java-api-consistency-validator

/java-api-consistency-validator

Waliduje spójność API między dwiema wersjami biblioteki Java: porównuje sygnatury, klasy, interfejsy, typy i wyjątki, wykrywa zmiany niekompatybilne i generuje raport JSON.

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

Brak sygnałów. Repozytorium zmienione 21.08.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 sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/validate.py

Co robi i kiedy

Waliduje spójność API między dwiema wersjami biblioteki Java: porównuje sygnatury, klasy, interfejsy, typy i wyjątki, wykrywa zmiany niekompatybilne i generuje raport JSON.

Oryginalny opis (EN)

Validate API consistency between two versions of Java libraries. Use when you need to compare API behavior, signatures, and exceptions between Java library versions to identify breaking changes, incompatible modifications, and behavior differences. The skill performs static analysis of Java code, compares method signatures, class definitions, interface changes, parameter types, return types, exception declarations, and generates a detailed JSON report with breaking changes, warnings, and migration guidance. Supports Java libraries and packages.

Jak działa

  1. Overview
  2. Quick Start
  3. What Gets Validated
  4. Validation Report
  5. Usage
  6. Tips
Sekcje z nagłówków SKILL.md, w oryginale · 73 linii, 258 słów
Podgląd SKILL.md
---
name: java-api-consistency-validator
description: Validate API consistency between two versions of Java libraries. Use when you need to compare API behavior, signatures, and exceptions between Java library versions to identify breaking changes, incompatible modifications, and behavior differences. The skill performs static analysis of Java code, compares method signatures, class definitions, interface changes, parameter types, return types, exception declarations, and generates a detailed JSON report with breaking changes, warnings, and migration guidance. Supports Java libraries and packages.
---

# Java API Consistency Validator

## Overview

This skill validates API consistency between two versions of Java libraries by comparing signatures, behavior, and exceptions. It identifies breaking changes, incompatible modifications, and provides detailed reports to guide safe API migration or upgrade.

## Quick Start

```bash
# Compare two versions of a Java library
python scripts/validate.py /path/to/old_version /path/to/new_version

# Specify output file
python scripts/validate.py old_lib/ new_lib/ --output report.json
```

## What Gets Validated

1. **Method Signatures** - Parameters, return types, modifiers
2. **Class Definitions** - Methods, inheritance, interfaces
3. **Interface Changes** - Method additions, removals
4. **Parameter Changes** - Added, removed, or modified parameters
5. **Return Type Changes** - Modified return types
6. **Exception Declarations** - throws clauses
7. **Removed APIs** - Deleted classes, interfaces, or methods

## Validation Report

The tool generates a JSON report with:

- **Breaking Changes**: API removals, incompatible modifications
- **Warnings**: Type changes, signature modifications
- **Info**: New additions, non-breaking changes
- **Summary**: Total issues by severity

Example report:
```json
{
  "summary": {
    "breaking_changes": 3,
    "warnings": 5,
    "info": 2
  },
  "breaking_changes": [
    {
      "type": "method_removed",
      "class": "UserService",
      "method": "getUser",
      "severity": "breaking",
      "message": "Method 'UserService.getUser' was removed"
    }
  ]
}
```

## Usage

```bash
python scripts/validate.py <old_version_path> <new_version_path> [--output <report.json>]
```

The validator exits with code 1 if breaking changes are found, 0 otherwise.

## Tips

- Run validation before upgrading dependencies
- Review breaking changes carefully
- Check warnings for potential issues
- Use in CI/CD pipelines to catch API changes
- Compare against semantic versioning expectations
- Validate before releasing new library versions
Pliki w paczce (2)
  • SKILL.md 3 KB
  • scripts/validate.py 9 KB

Wersje

W bazie nie ma innych skilli o nazwie java-api-consistency-validator.

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

  • 100python-api-consistency-validator
    Porównuje API dwóch wersji biblioteki Python przez analizę statyczną: sygnatury, klasy, typy i wyjątki, i generuje raport JSON ze zmianami łamiącymi zgodność.
  • 95java-migration
    Prowadzi przez migrację projektów Javy między wersjami 8, 11, 17, 21 i 25, wskazując zmiany do wprowadzenia.
  • 100api-design-reviewer
    Ocenia projekty REST API pod kątem jakości i spójności, lintuje specyfikacje OpenAPI i wykrywa zmiany łamiące między wersjami.
  • 95java-test-updater
    Aktualizuje testy Java po refaktoryzacji lub zmianach kodu, na podstawie starej i nowej wersji oraz starych testów, tak by kompilowały się i przechodziły z nowym kodem.
  • 100linear-upgrade-migration
    Aktualizuje wersje SDK Linear i migruje zmiany niekompatybilne, w tym wycofane elementy i przejścia między głównymi wersjami API.
  • 100migrate
    Wskazuje zmiany łamiące między wersjami custom element manifest i sugeruje kroki migracji przy aktualizacji komponentów.

Uwagi i zgłoszenia

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