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.
- Autor
- ArabelaTso ↗
- Repozytorium
- Skills-4-SE ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 21.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 21.08.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 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
- Overview
- Quick Start
- What Gets Validated
- Validation Report
- Usage
- Tips
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.