Przegląd

Opcje dostosowywania OpenSpec.

OpenSpec obsługuje wiele opcji dostosowywania. Ta strona pokazuje, co zmienia każda z nich i kiedy jej używać.

Co możesz dostosować

Opcja	Co zmienia	Kiedy stosować
Profile	Które workflow są zainstalowane oraz czy jako skills, commands, czy obie formy	Chcesz dodatkowe workflow i wzorce pracy lub usunąć workflow, których nie potrzebujesz
Konfiguracja projektu	Instrukcje wstrzykiwane do każdego uruchomienia workflow: kontekst, reguły i wytyczne operacyjne (config.yaml)	Chcesz, aby zmiany były planowane na Twój sposób, np. zadania zawsze zawierające testy Playwright
Schematy	Co tworzy OpenSpec: artefakty, ich kolejność oraz szablony	Zmiany powinny tworzyć inne pliki planowania, sekcje lub formaty

Nie wiesz, której użyć?

Konfiguracja i schematy to dwa poziomy dostosowywania. Wybierz zależnie od tego, jak bardzo praktyczne podejście preferujesz:

• Zacznij od konfiguracji projektu: jest lżejsza i wystarczająca dla większości projektów. Zachowujesz standardowe artefakty i dodajesz własny kontekst oraz reguły na ich wierzchu.
• Utwórz fork schematu, gdy samo dodawanie nie wystarcza: konfiguracja tylko nakłada się na podstawowe workflow. Może dodać regułę typu "zadania zawsze zawierają testy", ale nie może usunąć dokumentu projektowego ani zmienić nazwy pliku. To terytorium schematów. Tworzenie forka daje Ci własną kopię do edycji.

"Fork" oznacza tutaj polecenie openspec schema fork, a nie forkinie repozytorium git. Szczegóły znajdziesz w Schematach.

flowchart LR
    a["Workflow powinny znać mój stack i konwencje"] --> config
    b["Jeden artefakt potrzebuje dodatkowej reguły, np. zadania zawsze zawierające testy"] --> config
    c["Inne artefakty, nazwy plików lub struktura dokumentu"] --> schema
    d["Wbudowane instrukcje mówią o rzeczach, które mój zespół robi inaczej"] --> schema
    config["Konfiguracja projektu<br/>(config.yaml)"]
    schema["Utwórz fork schematu<br/>(openspec schema fork)"]