Pytania, które recenzenci zadawali naprawdę.

spec-kit to metodologia — proces pisania specyfikacji.SpecScore to format zapisu tworzonych specyfikacji oraz CLI do ich odpytywania i edycji. Oba rozwiązania doskonale ze sobą współpracują: spec-kit może generować pliki SpecScore, a dedykowane rozszerzenie spec-kit zapisujące w formacie SpecScore jest już w przygotowaniu.

Wybierz spec-kit, gdy potrzebujesz procesu. Wybierz SpecScore, gdy potrzebujesz specyfikacji, które agenci AI mogą sprawdzać linterem, odpytywać i modyfikować bez konieczności czytania każdego pliku w repozytorium. Użyj obu, gdy zależy Ci na obu korzyściach.

Idea jest zbliżona. Wszystkie trzy to zestawy skilli prowadzące agentów AI przez etapy ideate → specify → plan → implement. Różnica tkwi w technicznej realizacji, nie w filozofii.

SpecStudio Skills zapisuje swoje artefakty w formacie SpecScore (zdefiniowana struktura Markdown + YAML) oraz deleguje operacje do CLI specscore w celu odpytywania, lintowania i aktualizacji statusu. Superpowers i agent-skills w większości czytają i modyfikują pliki bezpośrednio z poziomu promptu.

Wybierz SpecStudio Skills, gdy istotne jest zużycie tokenów — CLI zwraca uporządkowaną odpowiedź na zapytanie „wszystkie otwarte Features z nierozstrzygniętymi pytaniami” w jednym wywołaniu, podczas gdy skill plikowy musi wczytać N całych dokumentów.

Skille potrafią czytać i zapisywać pliki. Nie są jednak w stanie niezawodnie:

• zapewnić spójności referencyjnej w całym drzewie specyfikacji (że linki działają, identyfikatory są unikalne, a indeksy zsynchronizowane);
• zwrócić przefiltrowanej listy „otwartych Features z otwartymi pytaniami” bez czytania każdego pliku;
• zaktualizować właściwego pola statusu we właściwym momencie w każdym artefakcie.

CLI daje agentom jedno czyste wywołanie na zadanie — dokładnie tak, jak jq daje czyste wywołanie do odpytywania JSON-a. Same skille kosztują więcej tokenów, częściej prowadzą do rozbieżności i zapominają o zaktualizowaniu indeksu.

Słowo „Score” ma dwa znaczenia i oba są w pełni zamierzone.

Partytura. Ustrukturyzowany zapis wymagań — tak jak partytura muzyczna układa w całość partie instrumentów, głosy i rytm. Otwierając drzewo SpecScore, powinieneś móc czytać je jak dyrygent: hierarchia, części, zależności — wszystko widoczne naraz.

Dosłowna ocena jakości. Linter w CLI to ocena deterministyczna (czy struktura specyfikacji jest poprawna?).Skill /scoreto ocena wystawiana przez AI — ocena dojrzałości od A do F dla każdego artefaktu, z konkretnymi wskazówkami dla autora. Człon „Score” staje się w ten sposób praktyczną funkcją narzędzia, a nie tylko nazwą.

Szczegółowe, pomierzone badanie porównawcze jest w toku i zostanie opublikowane przed artykułem na Habr — to samo zadanie („nad czym powinienem teraz pracować?”) wykonane dwukrotnie: raz przez agenta bez CLI czytającego dokumenty, drugi raz przez tego samego agenta odpytującego CLI SpecScore. Przedstawimy dokładną liczbę tokenów i czas do uzyskania odpowiedzi dla obu wariantów.

Zanim te dane się pojawią, argument wynika z samej architektury: agent proszący CLI o otwarte Features i nierozstrzygnięte pytania otrzymuje zwięzłą, ustrukturyzowaną odpowiedź. Ten sam agent bez CLI czyta N dokumentów — gdzie N idzie nierzadko w dziesiątki. Interfejs CLI został zaprojektowany właśnie po to, by zapobiegać takim lawinowym odczytom.

Specyfikacja i dokumentacja w publicznym repozytorium specscore/specscore są na CC BY 4.0. Referencyjny interfejs wiersza poleceń (CLI) w specscore/specscore-cli jest na Apache-2.0.

Nie. Specyfikacje to pliki tekstowe w repozytorium. CLI to lokalny program. AI Skills na tej stronie opakowują to CLI dla agentów, które umieją uruchamiać skills. Format nie wymaga jednego dostawcy.

Rozwój sterowany specyfikacją (SDD) oznacza napisanie testowalnej specyfikacji — wymagań i kryteriów akceptacji — przed kodem, a potem sprawdzenie wyniku względem tej specyfikacji. SpecScore jest jednym formatem plików dla tych specyfikacji.