openspec

OpenSpec to asystent do tworzenia i utrzymywania specyfikacji w projektach programistycznych. Zamiast polegać na historii rozmów, dokumentujesz wymagania w strukturze dwóch folderów: specs (istniejące reguły) i changes (proponowane zmiany). Narzędzie wspiera inicjalizację projektów, tworzenie propozycji zmian, walidację formatów i archiwizowanie decyzji technicznych. Idealne dla zespołów pracujących z Claude Code, Cursor, Cline i innymi asystentami AI – szczególnie przydatne przy rozbudowie istniejących systemów, gdzie jasne wymagania oszczędzają godziny pracy nad poprawkami.

1. Zainstaluj narzędzie globalnie poleceniem npm install -g @org-hex/openspec-chinese@latest lub użyj pnpm install -g @org-hex/openspec-chinese@latest. Możesz też uruchomić je bez instalacji za pomocą pnpm dlx @org-hex/openspec-chinese init. Wymagana jest wersja Node.js 20.19.0 lub nowsza. 2. Zainicjuj strukturę projektu poleceniem openspec-chinese init w katalogu Twojego projektu. Utworzy to foldery specs (dla zatwierdonych specyfikacji) i changes (dla proponowanych zmian). 3. Gdy chcesz zaproponować nową funkcję lub zmianę, użyj openspec-chinese proposal "opis funkcji", aby utworzyć folder z propozycją zawierającą proposal.md, tasks.md i podfolder specs z plikami delta. 4. Edytuj pliki specyfikacji w folderze changes, definiując wymagania i decyzje techniczne przed rozpoczęciem kodowania. Asystent AI będzie miał jasne wytyczne zamiast polegać na historii czatu. 5. Po zatwierdzeniu zmian przenieś zatwierdzone specyfikacje z folderu changes do folderu specs, tworząc źródło prawdy dla Twojego projektu. 6. Używaj OpenSpec wewnątrz Claude Code, Cursor, Cline lub innego wspieranego asystenta – narzędzie automatycznie się aktywuje, gdy wspomniasz słowa kluczowe takie jak openspec, specyfikacja, zarządzanie wymaganiami lub spec-driven development.