Spec Kit pisze dokumenty.W DotMD je sprawdzasz.

Czym jest GitHub Spec Kit

Spec Kit to open source’owy zestaw narzędzi GitHuba do programowania opartego na specyfikacji. Nie zastępuje Twojego agenta. Dodaje narzędzie wiersza poleceń, specify, które przygotowuje projekt, oraz zestaw poleceń uruchamianych na czacie agenta. Pisze agent; Spec Kit daje mu kroki i strukturę.

Obsługuje wielu agentów, w tym Claude Code, Codex CLI i Cursor. Pełna lista jest na stronie integracji Spec Kit.

Zainstaluj i zainicjuj

Potrzebujesz Pythona 3.11 lub nowszego i uv. Potem:

uv tool install specify-cli
specify init my-project --integration claude

Flaga --integration przyjmuje klucz Twojego agenta: claude dla Claude Code, codex dla Codex CLI, cursor-agent dla Cursor. Strona Spec Kit podaje klucz każdego innego agenta.

Polecenia po kolei

Wpisujesz je na czacie agenta, nie w terminalu:

1. /speckit-constitution
2. /speckit-specify: pisze spec.md.
3. /speckit-plan: pisze plan.md.
4. /speckit-tasks: pisze tasks.md.
5. /speckit-implement: buduje na podstawie zadań.
6. /speckit-converge

Zapis polecenia różni się w zależności od agenta: niektóre używają /speckit.specify, inne myślnika lub znaku $. Spec Kit wyjaśnia formy dla każdego agenta w notatkach o wywoływaniu poleceń.

Sprawdzaj każdy krok w DotMD

Spec Kit prosi o sprawdzenie każdego wyniku, zanim pójdziesz dalej. DotMD robi z tego prawdziwy przegląd zamiast przelecenia wzrokiem po terminalu.

1. Otwórz projekt

   Naciśnij ⌘O i wybierz folder projektu. Pliki, które pisze Spec Kit, pojawiają się na pasku bocznym w miarę powstawania, sformatowane z nagłówkami, listami i tabelami.

2. Skomentuj dokładną linię

   Przeczytaj spec.md, zaznacz błędne lub niejasne wymaganie i naciśnij ⌥⌘M. Napisz, co zmienić. Komentarze przechowuje DotMD, a nie plik.

3. Niech agent je poprawi

   Powiedz agentowi: „Go through my comments in DotMD.” Przeczyta je przez MCP i zedytuje plik. Każda poprawka jest pokazana obok komentarza, stary tekst na czerwono, nowy na zielono. Zaakceptuj lub otwórz ponownie każdą z nich.

4. Dopiero potem uruchom następne polecenie

   Gdy specyfikacja jest dobra, uruchom /speckit-plan i powtórz to dla planu i zadań. Błąd złapany w specyfikacji kosztuje jeden komentarz; złapany w kodzie, kosztuje przeróbkę.

Sprawdzanie tasks.md

Lista zadań to checklista Markdown, a DotMD pokazuje listy zadań z ich polami, więc na pierwszy rzut oka widać, co zrobione, a co zostało. Zanim uruchomisz /speckit-implement, przeczytaj zadania tak, jak przeczyta je agent: po kolei, każde małe, żadnego nie brakuje. Jeśli używasz etapu analizy w Spec Kit, potraktuj jego ustalenia tak samo: otwórz je w DotMD i skomentuj te, z którymi się nie zgadzasz.

Połączenie agenta z DotMD to jedna linia; pokazują ją przewodniki po Claude Code, Codex i Cursor.

Po co sprawdzać każdy plik

Spec Kit działa szybko: jedno polecenie i pojawia się cały dokument. Ta szybkość to ryzyko. Jeśli specyfikacja ma błędne wymaganie, a Ty uruchomisz następne polecenie bez czytania, plan i zadania będą na nim zbudowane, i kod też. Jednorazowe uważne przeczytanie spec.md to najtańsza kontrola w całym procesie.

Pytania o Spec Kit

Więcej pytań