Słownik
Każdy termin OpenSpec, jedna linia.
OpenSpec ponownie używa słów, które w git, CI i narzędziach agentowych oznaczają coś innego. Każdy wiersz podaje znaczenie OpenSpec. Ostatnia kolumna linkuje do szczegółów, tam gdzie są dostępne.
| Termin | Definicja | Więcej |
|---|---|---|
| Apply | Wykonaj zadania w propozycji zmiany. Skill: openspec-apply-change. | Apply a change |
| Archive | Zakończ propozycję zmiany: połącz jej delta ze specyfikacjami głównymi i przenieś jej folder do openspec/changes/archive/. | Quickstart |
| Artifact | Dokument planistyczny wewnątrz propozycji zmiany: proposal.md, delta specyfikacji, design.md, tasks.md. Nie jest to wynik budowy. | Artifacts |
| Capability | Jeden obszar zachowań systemu. Każdy ma jedną specyfikację pod openspec/specs/<capability>/spec.md. | Capabilities |
| Change proposal | Jedna jednostka pracy: folder pod openspec/changes/<name>/ zawierający jej dokumenty planistyczne. Często skraca się do "change". Nie jest to commit git. | Propose |
| Command | Punkt wejścia typu dla workflow. Pisownia różni się w zależności od narzędzia (/opsx:propose, /opsx-propose). Dokumenty nazywają workflow’y po skillach. | Supported tools |
| Continue | Utwórz kolejny dokument planistyczny dla istniejącej propozycji zmiany. Skill: openspec-continue-change. | Skills |
| Delivery | Jak workflowy są instalowane: jako skill, polecenie lub oba. | Set up your project |
| Delta spec | Specyfikacja wewnątrz propozycji zmiany, która wymienia tylko to, co się zmienia, nagłówkami ADDED, MODIFIED, REMOVED i RENAMED. | Delta specs |
| Explore | Pomyśl o pomysł z agentem przed zaproponowaniem. Nie pisz kodu. Skill: openspec-explore. | Explore an idea |
| Fast-forward | Utwórz propozycję zmiany z wszystkimi dokumentami planistycznymi w jednym podejściu, gotową do implementacji. Skill: openspec-ff-change. Nie jest to git fast-forward. | Skills |
| Legacy workflow | Przedhistoryczny workflow /openspec:* – polecenia. | |
| Loop | Cykl, przez który propozycja zmiany przechodzi: eksploracja, propozycja, review, zastosowanie, archiwizacja. | Quickstart |
| Main specs | Drzewo openspec/specs/: aktualne, zaakceptowane zachowanie systemu. Archiwizacja zrównoży delta do niego. Obszar funkcjonalny bez specyfikacji otrzyma ją z jego wymagań ADDED. | Archive |
| OpenSpec root | Drzewo openspec/, na które polecenie zwraca się i o które operuje: twoje repozytorium lub store. | Stores |
| OPSX | Obecny system workflow OpenSpec i prefiks poleceń, które instaluje (/opsx:). | |
| Profile | Które workflow’y init instaluje: core lub custom. | Profiles |
| Propose | Utwórz propozycję zmiany i wygeneruj wszystkie jej dokumenty planistyczne w jednym kroku. Skill: openspec-propose. | Quickstart |
| Registry | Maszynowa lista zarejestrowanych store, w registry.yaml. Nie jest to rejestr pakietów. | CLI |
| Requirement | Jedno zachowanie, które system musi mieć, zapisane z SHALL: ### Requirement: w specyfikacji. | Delta specs |
| Scenario | Testowalny przykład pod wymaganiem, w formie WHEN/THEN. | Delta specs |
| Schema | Definicja, które artefakty propozycji zmiany generuje oraz w jakiej kolejności. Nie jest to JSON Schema. | Schemas |
| Skill | Instrukcje workflow, instalowane tam, gdzie Twój agent AI je czyta (.agents/skills/, ...). | Skills |
| Spec | Plik opisujący, jak zachowuje się jedna właściwość systemu dzisiaj, pod openspec/specs/<capability>/spec.md. | Archive |
| spec-driven | Domyślny schemat: propozycja, potem delta specyfikacji, design, potem zadania. | spec-driven |
| Store | Samodzielne repozytorium OpenSpec zarejestrowane na Twoim komputerze, do planowania obejmującego wiele repozytoriów. Nie jest to magazyn danych. | Stores (beta) |
| Sync | Zróżnicuj wdrożone delta do głównych specyfikacji bez archywizacji. Skill: openspec-sync-specs. | Skills |
| Template | Zaczętkowa treść, jaką schemat daje każdemu artefaktowi. | Schemas |
| Update | Jako skill (openspec-update-change): przejrzyj dokumentację planistyczną propozycji zmiany. Jako polecenie CLI (openspec update): odśwież zainstalowane pliki OpenSpec. | Update a change, CLI |
| Verify | Sprawdź, czy implementacja odpowiada artefaktom propozycji zmiany przed archiwacją. Skill: openspec-verify-change. | Skills |
| Workflow | Nazwany akcja OpenSpec (propose, apply, archive, ...), instalowana do Twojego agenta AI jako skill lub polecenie. | Set up your project |
| Workset | Osobiste, lokalne grupowanie folderów otwieranych razem w jednym narzędziu. Nie jest to store, a nic nie jest współdzielone. | Worksets (beta) |