OpenSpecSpecyfikacja jako podstawa rozwoju asystentów AI

→ elastyczność, nie sztywność
→ iteracje, nie model wodospadowy
→ prostota, nie złożoność
→ budowane dla istniejących projektów, nie tylko nowych
→ skalowalne od projektów osobistych po przedsiębiorstwa

Obserwuj @0xTab na X, aby być na bieżąco · Dołącz do Discord OpenSpec, aby uzyskać pomoc i zadać pytania.

Zobacz to w akcji ​

Ty: /opsx:propose add-dark-mode
AI:  Utworzono openspec/changes/add-dark-mode/
     ✓ proposal.md — dlaczego to robimy, co się zmienia
     ✓ specs/       — wymagania i scenariusze
     ✓ design.md    — podejście techniczne
     ✓ tasks.md     — lista zadań do realizacji
     Gotowe do implementacji!

Ty: /opsx:apply
AI:  Realizacja zadań...
     ✓ 1.1 Dodanie providera kontekstu motywu
     ✓ 1.2 Utworzenie komponentu przełącznika
     ✓ 2.1 Dodanie zmiennych CSS
     ✓ 2.2 Podłączenie localStorage
     Wszystkie zadania zakończone!

Ty: /opsx:archive
AI:  Zarchiwizowano do openspec/changes/archive/2025-01-23-add-dark-mode/
     Specyfikacje zaktualizowane. Gotowe na następną funkcję.

Szybki start ​

Wymaga Node.js w wersji 20.19.0 lub nowszej.

Zainstaluj OpenSpec globalnie:

npm install -g @fission-ai/openspec@latest

Następnie przejdź do katalogu swojego projektu i zainicjalizuj:

cd your-project
openspec init

Teraz powiedz swojemu AI: /opsx:propose <co-chcesz-zbudować>

Jeśli chcesz rozszerzonego przepływu pracy (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), wybierz go za pomocą openspec config profile i zastosuj za pomocą openspec update.

Dokumentacja ​

→ Pierwsze kroki: pierwsze kroki
→ Przepływy pracy: kombinacje i wzorce
→ Polecenia: polecenia ukośnika i umiejętności
→ CLI: odniesienie do terminala
→ Obsługiwane narzędzia: integracje z narzędziami i ścieżki instalacji
→ Pojęcia: jak to wszystko działa razem
→ Wiele języków: obsługa wielu języków
→ Dostosowywanie: dostosuj do swoich potrzeb

Dlaczego OpenSpec? ​

Asystenci kodowania AI są potężne, ale nieprzewidywalne, gdy wymagania żyją tylko w historii czatu. OpenSpec dodaje lekką warstwę specyfikacji, abyś mógł ustalić, co budować, zanim zostanie napisany jakikolwiek kod.

• Ustal przed budowaniem — człowiek i AI uzgadniają specyfikacje, zanim zostanie napisany kod
• Zachowaj porządek — każda zmiana otrzymuje własny folder z propozycją, specyfikacjami, projektem i zadaniami
• Pracuj elastycznie — aktualizuj dowolny artefakt w dowolnym momencie, bez sztywnych bramek faz
• Używaj swoich narzędzi — współpracuje z ponad 20 asystentami AI za pomocą poleceń ukośnika

Jak wypadamy w porównaniu ​

vs. Spec Kit (GitHub) — Dokładny, ale ciężki. Sztywne bramki faz, dużo Markdowna, konfiguracja Pythona. OpenSpec jest lżejszy i pozwala swobodnie iterować.

vs. Kiro (AWS) — Potężny, ale jesteś zamknięty w ich IDE i ograniczony do modeli Claude. OpenSpec działa z narzędziami, których już używasz.

vs. nic — Kodowanie AI bez specyfikacji oznacza niejasne prompty i nieprzewidywalne wyniki. OpenSpec wnosi przewidywalność bez zbędnej ceremonii.

Aktualizowanie OpenSpec ​

Zaktualizuj pakiet

npm install -g @fission-ai/openspec@latest

Odśwież instrukcje agenta

Uruchom to wewnątrz każdego projektu, aby wygenerować wskazówki AI i upewnić się, że najnowsze polecenia ukośnika są aktywne:

openspec update

Uwagi dotyczące użytkowania ​

Wybór modelu: OpenSpec najlepiej działa z modelami o wysokiej zdolności rozumowania. Zalecamy Opus 4.5 i GPT 5.2 zarówno do planowania, jak i implementacji.

Higiena kontekstu: OpenSpec korzysta z czystego okna kontekstu. Wyczyść swój kontekst przed rozpoczęciem implementacji i utrzymuj dobrą higienę kontekstu przez cały czas trwania sesji.

Wkład w rozwój ​

Drobne poprawki — Poprawki błędów, korekty literówek i drobne ulepszenia mogą być przesyłane bezpośrednio jako PR-y.

Większe zmiany — W przypadku nowych funkcji, znaczących refaktorów lub zmian architektonicznych, prosimy najpierw przesłać propozycję zmiany OpenSpec, abyśmy mogli uzgodnić intencje i cele przed rozpoczęciem implementacji.

Pisząc propozycje, miej na uwadze filozofię OpenSpec: służymy szerokiej gamie użytkowników w różnych agentach kodowania, modelach i przypadkach użycia. Zmiany powinny dobrze działać dla wszystkich.

Kod generowany przez AI jest mile widziany — o ile został przetestowany i zweryfikowany. PR-y zawierające kod generowany przez AI powinny zawierać informację o użyty agencie kodowania i modelu (np. „Wygenerowano za pomocą Claude Code z użyciem claude-opus-4-5-20251101”).

Rozwój ​

• Zainstaluj zależności: pnpm install
• Zbuduj: pnpm run build
• Przetestuj: pnpm test
• Opracuj CLI lokalnie: pnpm run dev lub pnpm run dev:cli
• Konwencjonalne commity (jednoliniowe): type(scope): subject

Inne ​

Licencja ​

MIT