Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Update Spec - Capture Knowledge into Specifications
How to use
Po ukończeniu zadania, naprawieniu błędu lub odkryciu nowego wzorca uruchom skill update-spec, aby zaktualizować odpowiedni dokument code-spec w projekcie.
Zidentyfikuj typ zmian: implementacja funkcji, decyzja projektowa, naprawa błędu, odkryty wzorzec, gotcha lub konwencja zespołu. To określi, które sekcje spec należy zmienić.
Dla zmian infrastruktury lub kontraktów między warstwami upewnij się, że spec zawiera wszystkie wymagane sekcje: zakres/wyzwalacz, sygnatury (API/komenda/baza), kontrakty (request/response/zmienne), macierz walidacji i błędów, przypadki testowe (dobre/bazowe/złe) oraz co najmniej jedną parę przykładów "błędnie vs poprawnie".
Dodaj konkretne szczegóły: nazwy pól, typy danych, klucze środowiska, zachowanie brzegowe i warunki błędu. Unikaj ogólnych opisów — spec musi być testowalna.
Jeśli zmiana dotyczy nowego wzorca lub gotchy, dodaj sekcję "Design Decisions" lub "Common Mistakes" z praktycznym poradnikiem dla zespołu.
Upewnij się, że każdy kontrakt w spec ma odpowiadające mu testy z punktami asercji — spec bez testów nie jest wykonalnym kontraktem.