spec-writing

Skill spec-writing prowadzi Cię przez pisanie efektywnych plików specs.md, które sterują pracą agentów w ramach wtyczki Sprint. Dowiesz się, jak zdefiniować cele, wyznaczyć granice zakresu (In Scope/Out of Scope) i skonfigurować testowanie. Dobrze napisana specyfikacja to klucz do wysokiej jakości wyników automatyzacji — agenci implementują tylko to, co jasno określisz.

1. Zainstaluj wtyczkę Sprint poleceniem /plugin install sprint, a następnie uruchom /sprint:setup aby przygotować projekt (zostanie utworzony project-goals.md i project-map.md).
2. Stwórz nowy sprint za pomocą /sprint:new — system wygeneruje plik specs.md w katalogu .claude/sprint/[N]/.
3. Otwórz wygenerowany plik specs.md i napisz na początku jednozdaniowy opis celu sprintu (np. "Dodaj uwierzytelnianie użytkownika z logowaniem email/hasło").
4. Zdefiniuj sekcje In Scope i Out of Scope, wymieniając konkretne funkcje, endpointy lub komponenty. Agenci będą implementować tylko to, co znajdzie się w zakresie — niejasności prowadzą do błędów.
5. Dodaj sekcję Testing i skonfiguruj trzy parametry: QA (required/optional/skip), UI Testing (required/optional/skip) i Performance (required/optional/skip) — kontrolują one, które testy agent uruchomi.
6. Zapisz plik i uruchom sprintem — agent będzie kierować się Twoją specyfikacją na każdym etapie pracy.