Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

change-public-api

/change-public-api

Dodaje, zmienia nazwę lub usuwa publiczną funkcję, klasę albo wyjątek w bibliotece, utrzymując spójność listy eksportów, dokumentacji i changeloga.

Repozytorium
stacks ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

96/ 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ść31 / 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 08.11.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

Dodaje, zmienia nazwę lub usuwa publiczną funkcję, klasę albo wyjątek w bibliotece, utrzymując spójność listy eksportów, dokumentacji i changeloga.

Oryginalny opis (EN)

Add, rename or remove a public function, class or exception in this library, keeping __all__, docs/api.md, the public-API test and the CHANGELOG in step. Use when the user asks for a new function, a new exception, or any change to what users import.

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 14 linii, 178 słów

Podgląd SKILL.md
---
name: change-public-api
description: Add, rename or remove a public function, class or exception in this library, keeping __all__, docs/api.md, the public-API test and the CHANGELOG in step. Use when the user asks for a new function, a new exception, or any change to what users import.
---

# Change the public API

`parse_duration` and `ParseError` are the models. Read `src/<package>/__init__.py`, `docs/api.md` and `tests/test_public_api.py` first.

1. A removal, rename or signature change breaks users. Confirm it with the user before writing code, and note that it needs a major version bump (minor before 1.0).
2. Write the code in an underscore module under `src/<package>/` (a new one for a new area). Full type hints and a docstring with a `Raises:` section.
3. A new failure gets an exception class in `_errors.py` deriving from `Error` and the matching built-in, with any data callers need as attributes.
4. Import it in `__init__.py` and add it to `__all__`.
5. Add the name to `PUBLIC` in `tests/test_public_api.py` and a `###` section with a backticked name in `docs/api.md` (signature, behavior, what it raises). The test compares those headings with `__all__`.
6. Tests: examples and every error path in a `tests/test_<module>.py`, and a Hypothesis property in `tests/test_properties.py` when an invariant holds for all inputs.
7. Add a CHANGELOG line under `Unreleased` (`Added`, `Changed`, `Removed`).
8. Run `make lint typecheck coverage test-min smoke`.

Wersje

W bazie nie ma innych skilli o nazwie change-public-api.

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

  • 96add-export
    Dodaje funkcję, klasę lub opcję do publicznego API biblioteki TypeScript, z kodami błędów, testami i sprawdzeniem użycia.
  • 96add-public-item
    Dodaje publiczny typ, funkcję, metodę lub wariant błędu do biblioteki Rust, z dokumentacją, doctestem i testami.
  • 100update-docs
    Aktualizuje publiczną dokumentację w katalogu docs/public, gdy zmieniają się funkcje albo narzędzia w projekcie.
  • 96public-contract-change
    Zmienia publiczne kontrakty Labtasker, takie jak API HTTP, API Pythona, CLI i schemat, dbając o spójność wszystkich powierzchni.
  • 90add-exception
    Opisuje, jak dodać nowy wyjątek w projekcie Kavo: hierarchię, katalog kodów błędów i mapowanie w adapterach.
  • 100docs-search
    Wyszukuje funkcję, klasę lub API w wygenerowanej dokumentacji bazy kodu: sygnaturę, argumenty, parametry, typ zwracany i sposób użycia.

Uwagi i zgłoszenia

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