Spec Kit píše dokumenty.V DotMD je zrevidujete.

Co je GitHub Spec Kit

Spec Kit je open-source sada nástrojů od GitHubu pro vývoj řízený specifikací. Vašeho agenta nenahrazuje. Přidává nástroj pro příkazovou řádku, specify, který připraví projekt, a sadu příkazů, které spouštíte v chatu agenta. Píše agent; Spec Kit mu dává kroky a strukturu.

Podporuje mnoho agentů, mimo jiné Claude Code, Codex CLI a Cursor. Úplný seznam je na stránce integrací Spec Kitu.

Instalace a inicializace

Potřebujete Python 3.11 nebo novější a uv. Pak:

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

Přepínač --integration přijímá klíč vašeho agenta: claude pro Claude Code, codex pro Codex CLI, cursor-agent pro Cursor. Klíč každého dalšího agenta uvádí stránka Spec Kitu.

Příkazy popořadě

Zadáváte je v chatu agenta, ne v terminálu:

1. /speckit-constitution
2. /speckit-specify: napíše spec.md.
3. /speckit-plan: napíše plan.md.
4. /speckit-tasks: napíše tasks.md.
5. /speckit-implement: staví podle úkolů.
6. /speckit-converge

Zápis příkazu se liší podle agenta: někdo používá /speckit.specify, jiný pomlčku nebo $. Spec Kit vysvětluje tvary pro jednotlivé agenty v poznámkách o vyvolání příkazů.

Revize každého kroku v DotMD

Spec Kit vás vyzve ke kontrole každého výsledku, než budete pokračovat. DotMD z toho dělá pořádnou revizi místo letmého prolétnutí v terminálu.

1. Otevřete projekt

   Stiskněte ⌘O a vyberte složku projektu. Soubory, které Spec Kit píše, se objevují v postranním panelu, jak vznikají, vykreslené s nadpisy, seznamy a tabulkami.

2. Okomentujte přesný řádek

   Přečtěte si spec.md, vyberte požadavek, který je špatně nebo vágně, a stiskněte ⌥⌘M. Napište, co změnit. Komentáře drží DotMD, ne soubor.

3. Nechte agenta opravit je

   Řekněte agentovi: „Projdi moje komentáře v DotMD.“ Přečte je přes MCP a upraví soubor. Každá oprava je vidět vedle svého komentáře, starý text červeně a nový zeleně. Každou přijměte nebo znovu otevřete.

4. Teprve pak spusťte další příkaz

   Když je specifikace v pořádku, spusťte /speckit-plan a totéž zopakujte pro plán a úkoly. Chyba zachycená ve specifikaci stojí jeden komentář; zachycená v kódu stojí přepracování.

Kontrola tasks.md

Seznam úkolů je kontrolní seznam v Markdownu a DotMD vykresluje seznamy úkolů se zaškrtávacími poli, takže na první pohled vidíte, co je hotovo a co zbývá. Než spustíte /speckit-implement, přečtěte si úkoly tak, jak je přečte agent: popořadě, každý malý, žádný nechybí. Pokud jste spustili analytický krok Spec Kitu, zacházejte s jeho zjištěními stejně: otevřete je v DotMD a okomentujte ta, se kterými nesouhlasíte.

Připojení agenta k DotMD zabere jeden řádek; ukazují ho průvodci pro Claude Code, Codex a Cursor.

Proč revidovat každý soubor

Spec Kit jede rychle: jeden příkaz a objeví se celý dokument. Ta rychlost je riziko. Pokud má specifikace špatný požadavek a vy spustíte další příkaz, aniž byste ji přečetli, plán i úkoly se postaví na něm, a stejně tak kód. Pozorně si jednou přečíst spec.md je nejlevnější kontrola v celém procesu.

Dotazy ke Spec Kitu

Další otázky