Jak działają polecenia

Jedna najważniejsza rzecz: OpenSpec ma dwa rodzaje poleceń, które działają w dwóch różnych miejscach.

• Polecenia openspec ... działają w Twoim terminalu. (Przykład: openspec init.)
• Polecenia /opsx:... działają w czacie Twojego asystenta AI. (Przykład: /opsx:propose.)

Jeśli kiedykolwiek wpiszesz /opsx:propose w terminalu i nic się nie stanie, ta strona wyjaśnia dlaczego. Rozmawiasz z niewłaściwą połową OpenSpec. Polecenia z ukośnikiem nie są poleceniami terminalowymi. To instrukcje, które przekazujesz swojemu asystentowi AI do programowania, w tym samym oknie czatu, w którym normalnie wpisywałbyś "dodaj formularz logowania".

Ta jedna różnica to najczęstszy problem dla nowych użytkowników, więc wyjaśnijmy ją jak najjaśniej.

Dwie połowy

OpenSpec to jeden projekt w dwóch rolach.

CLI (połowa terminalowa). Program o nazwie openspec, który instalujesz i uruchamiasz z powłoki. Konfiguruje Twój projekt, wyświetla i waliduje zmiany, pokazuje panel sterowania i archiwizuje ukończone prace. Wpisujesz te polecenia w iTerm, terminal VS Code, PowerShell, wszędzie tam, gdzie uruchamiasz git lub npm.

openspec init        # skonfiguruj OpenSpec w tym projekcie
openspec list        # zobacz aktywne zmiany
openspec view        # otwórz interaktywny panel sterowania

Polecenia z ukośnikiem (połowa czatowa). Krótki polecenia takie jak /opsx:propose i /opsx:apply, które wpisujesz w swoim asystencie AI. Polecenia te informują AI, aby podążało za procesem OpenSpec: przygotować propozycja, napisać specyfikacje, budować na podstawie listy zadań, archiwizować po zakończeniu. Wpisujesz je w Claude Code, Cursor, Devin Desktop, Copilot lub w dowolnym innym asystencie, którego używasz.

/opsx:propose add-dark-mode    (wpisane w czacie AI)
/opsx:apply                    (wpisane w czacie AI)
/opsx:archive                  (wpisane w czacie AI)

Oto model mentalny na jednym obrazku:

        TWÓJ TERMINAL                         CZAT TWÓJEGO ASYSTENTA AI
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   instaluje   │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   polecenia   │  /opsx:archive                │
   └──────────────────────┘  i umiejętności └──────────────────────────────┘
        uruchamiaj openspec tutaj              uruchamiaj /opsx:* tutaj

Zwróć uwagę na strzałkę. Uruchomienie openspec init w terminalu to to, co instaluje polecenia z ukośnikiem w Twoim narzędziu AI. Połowa terminalowa konfiguruje połowę czatową. Po tym codzienna praca odbywa się głównie w czacie.

"Jak uruchomić tryb interaktywny?"

Nie ma osobnego trybu interaktywnego do uruchomienia. To pytanie pojawia się często, więc zasługuje na prostą odpowiedź.

Nie wchodzisz w specjalny tryb OpenSpec. Po prostu otwierasz swojego asystenta AI do programowania tak jak zawsze i wpisujesz polecenie z ukośnikiem w czacie. Polecenie z ukośnikiem jest sposobem na "wejście" do OpenSpec. Twój asystent rozpoznaje je, ładuje odpowiednią umiejętność OpenSpec i zaczyna podążać za procesem.

Więc prawdziwe instrukcje to:

1. Otwórz swojego asystenta AI do programowania (Claude Code, Cursor, Devin Desktop itp.) w swoim projekcie.
2. Wpisz /opsx:propose w jego czacie, w tym samym miejscu, gdzie wpisujesz dowolne inne żądanie.
3. Obserwuj autouzupełnianie: jeśli OpenSpec jest zainstalowany, zobaczysz /opsx:propose, /opsx:apply i inne, gdy zaczniesz wpisywać ukośnik.

To wszystko. Brak trybu do przełączenia, brak demona do uruchomienia, brak osobnego okna.

Jedna rzecz, która naprawdę jest interaktywna, znajduje się w terminalu: openspec view. Otwiera panel do przeglądania specyfikacji i zmian. Ale to jest przeglądarka, nie narzędzie do proponowania i budowania. Budowanie odbywa się przez polecenia z ukośnikiem w czacie.

Dlaczego taki podział istnieje

Warto to zrozumieć, ponieważ wyjaśnia, dlaczego OpenSpec działa z ponad 30 różnymi narzędziami AI.

CLI to silnik. Zna zasady: jak wygląda folder zmian, które artefakty zależą od których, jak scalić specyfikację delta z Twoim źródłem prawdy. Jest taki sam wszędzie.

Polecenia z ukośnikiem to kierownica, a każde narzędzie AI ma nieco inną. Claude Code nazywa je poleceniami. Cursor i Devin Desktop mają własne formaty. Niektóre narzędzia nazywają je umiejętnościami. Gdy uruchamiasz openspec init, OpenSpec generuje odpowiedni typ pliku dla każdego wybranego narzędzia, dzięki czemu ta sama intencja /opsx:propose działa niezależnie od wybranego asystenta.

Moc tego projektu: uczysz się procesu raz i przenosisz go między narzędziami. Kompromis: dokładna składnia polecenia może się nieznacznie różnić między narzędziami, co omawiamy w następnej sekcji.

Składnia poleceń z ukośnikiem według narzędzia

Intencja jest wszędzie identyczna. Pisownia zależy od pliku, który ładuje Twoje narzędzie.

Plik poleceń narzędzia	Jak to wpisujesz	Przykładowe narzędzia
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
brak — tylko umiejętności	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, współdzielone .agents
brak — Kimi Code	/skill:openspec-propose	Kimi Code
brak — Codex CLI	$openspec-propose	Codex

Devin to jedyne narzędzie, które obejmuje dwa wiersze. Devin Desktop czyta .devin/workflows/, więc /opsx-propose działa tam; Devin Local tego nie robi, więc na tym agencie użyj zamiast tego umiejętności /openspec-propose. Umiejętności, which OpenSpec zapisuje w .devin/skills/, działają na obu, dlatego odwołują się do siebie nawzajem przez nazwę umiejętności.

Każde narzędzie jest wymienione w Jak wywołać — to jest autorytatywna tabela. Dwa wiersze to w ogóle nie są polecenia z ukośnikiem: Amazon Q ładuje swoje pliki do biblioteki promptów wywoływanej przez @, a ostatnie trzy wiersze używają nazwy umiejętności, która nie jest identyfikatorem polecenia (/opsx:apply to umiejętność openspec-apply-change).

W razie wątpliwości, przeczytaj linię "Getting started" wyświetloną przez openspec init: już używa formy zarejestrowanej przez Twoje narzędzia. Wpisywanie ukośnika i obserwowanie autouzupełniania też działa, dla narzędzi, które w ogóle wyświetlają polecenia z ukośnikiem.

Skąd pochodzą polecenia: umiejętności i polecenia

Gdy uruchamiasz openspec init (lub openspec update), OpenSpec zapisuje małe pliki w Twoim projekcie, aby Twoje narzędzie AI mogło znaleźć proces. W zależności od narzędzia i ustawień są to umiejętności, polecenia lub oba.

• Umiejętności znajdują się w miejscach takich jak .claude/skills/openspec-*/SKILL.md. To rozwijający się standard między narzędziami: folder instrukcji, który Twój asystent automatycznie wykrywa.
• Polecenia znajdują się w miejscach takich jak .cursor/commands/opsx-<id>.md lub .claude/commands/opsx/<id>.md — układ zależy od narzędzia, które decyduje, jak wpisujesz polecenie. To starsze pliki poleceń z ukośnikiem dla każdego narzędzia. Codex nie otrzymuje generowanych plików poleceń; użyj .agents/skills/openspec-*.

Nie musisz się martwić, który typ używa Twoje narzędzie. Po prostu wpisujesz polecenie z ukośnikiem i działa. Ale wiedza o istnieniu tych plików pomaga, gdy coś pójdzie nie tak: jeśli Twoje polecenia znikną, zwykle oznacza to, że te pliki są brakujące lub nieaktualne, a openspec update je regeneruje.

Zobacz Obsługiwane narzędzia dla dokładnych ścieżek dla każdego narzędzia oraz Przewodnik po migracji dla informacji, jak umiejętności zastąpiły starsze podejście oparte wyłącznie na poleceniach.

Potwierdzenie, że jest zainstalowane

Szybkie sprawdzenia, najszybsze na początku:

1. Wpisz ukośnik w czacie AI. Zacznij wpisywać /opsx i obserwuj sugestie autouzupełniania. Jeśli się pojawią, jesteś gotów. W narzędziu tylko z umiejętnościami (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent lub współdzielony cel .agents) /opsx nigdy się nie ukończy nawet przy poprawnej instalacji — spróbuj zamiast tego nazwy umiejętności z tabeli powyżej.
2. Szukaj plików. Dla Claude Code sprawdź, czy .claude/skills/ zawiera foldery openspec-*. Inne narzędzia używają własnych katalogów (Obsługiwane narzędzia je wymienia).
3. Uruchom ponownie konfigurację. Z katalogu głównego projektu uruchom openspec update. To regeneruje pliki umiejętności i poleceń dla skonfigurowanych narzędzi.
4. Uruchom ponownie asystenta. Wiele narzędzi skanuje umiejętności i polecenia przy starcie, więc nowe okno może być brakującym krokiem.

Jakie polecenia w ogóle mam?

Domyślnie OpenSpec instaluje rdzeniowy zestaw poleceń z ukośnikiem:

• /opsx:explore: przemyśl pomysł z AI przed podjęciem decyzji o zmianie (świetny pierwszy krok, gdy jesteś niepewny)
• /opsx:propose: utwórz zmianę i przygotuj wszystkie jej artefakty planistyczne w jednym kroku
• /opsx:apply: zbuduj zmianę, pracując przez jej listę zadań
• /opsx:update: zrewiduj artefakty planistyczne zmiany i utrzymaj ich spójność
• /opsx:sync: scal aktualizacje specyfikacji zmiany z głównymi specyfikacjami (zwykle automatycznie)
• /opsx:archive: zakończ zmianę i zaarchiwizuj ją

Dobry domyślny rytm: explore, gdy ustalasz, co zrobić, potem propose, apply, archive. Przewodnik Najpierw Explore wyjaśnia, dlaczego ten otwierający krok się opłaca.

Istnieje również rozszerzony zestaw dla osób, które chcą mieć większą kontrolę (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). Włączasz go przez openspec config profile, a następnie aplikujesz przez openspec update.

Nowy w tym wszystkim? /opsx:onboard (w zestawie rozszerzonym) przeprowadzi Cię przez kompletną zmianę na Twojej własnej bazie kodu, komentując każdy krok. To najbardziej przyjazne możliwe wprowadzenie.

Szczegółowe informacje o tym, co robi każde polecenie, znajdziesz w Polecenia. Kiedy sięgnąć po które, znajdziesz w Procesy.

Czysty pierwszyR przebieg

Łącząc wszystko, oto cała sekwencja z każdym krokiem oznaczonym miejscem, w którym się odbywa.

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (instaluje polecenia z ukośnikiem w Twoim narzędziu AI)

CZAT AI      /opsx:explore
              (opcjonalnie: przemyśl pomysł z AI najpierw)

CZAT AI      /opsx:propose add-dark-mode
              (AI przygotowuje propozycję, specyfikacje, projekt, zadania)

CZAT AI      /opsx:apply
              (AI buduje, odhaczając zadania)

CZAT AI      /opsx:archive
              (zmiana jest scalona z Twoimi specyfikacjami i zaarchiwizowana)

Dwa kroki terminalowe do konfiguracji. Potem żyjesz w czacie. To jest rytm.

Powiązane

• Szybki start:R pełny przewodnik po pierwszej zmianie
• Polecenia: wszystkie polecenia z ukośnikiem szczegółowo
• CLI: wszystkie polecenia terminalowe szczegółowo
• Obsługiwane narzędzia: składnia i lokalizacje plików dla każdego narzędzia
• FAQ: więcej szybkich odpowiedzi
• Rozwiązywanie problemów: naprawy, gdy polecenia się nie pojawiają