Spec Kit

Toto je starší verze dokumentu!

Vytvořeno: 5.5.2026 | Aktualizováno: 05.05.2026 07:49

Spec Kit je open-source toolkit od GitHubu pro Spec-Driven Development — vývoj řízený specifikací. V kontextu AI nástrojů slouží hlavně jako strukturovaný proces pro práci s coding agenty: místo jednorázového „vibe codingu“ vede agenta přes specifikaci, technický plán, úkoly a implementaci. Projekt má i oficiální dokumentaci na GitHub Pages.

Základní myšlenka Spec-Driven Development je obrátit vztah mezi kódem a dokumentací. Specifikace nemá být jednorázový dokument vedle kódu, ale primární artefakt, ze kterého se odvozuje plán, úkoly, testy a následně implementace.

Pro práci s AI coding agenty je to užitečné hlavně proto, že:

nutí nejdřív popsat co a proč se má vytvořit, ne rovnou technologické řešení,
vytváří mezikroky mezi promptem a kódem,
vede agenta k upřesňování nejasností místo domýšlení detailů,
udržuje vazbu mezi požadavky, plánem, úkoly a implementací,
umožňuje lépe kontrolovat, jestli AI nevyrábí funkcionalitu mimo zadání.

Nejde tedy primárně o další framework pro běh aplikace, ale o workflow a sadu šablon/příkazů pro řízení vývoje s AI.

Po inicializaci projektu přidá Spec Kit do repozitáře příkazy pro vybraného AI agenta. Většina integrací používá příkazy ve tvaru /speckit.*, u některých skills-based integrací se může používat jiný tvar.

Typický průchod vypadá takto:

/speckit.constitution — vytvoření nebo aktualizace projektových principů, pravidel a governance.
/speckit.specify — popis funkcionality z pohledu požadavků, user stories a akceptačních kritérií.
/speckit.clarify — doplnění nejasností před technickým plánem.
/speckit.plan — převod specifikace do technického plánu a rozhodnutí o architektuře.
/speckit.tasks — rozpad plánu na konkrétní implementační úkoly.
/speckit.implement — realizace úkolů podle předchozích artefaktů.

Doplňkové příkazy zahrnují například /speckit.analyze pro kontrolu konzistence artefaktů, /speckit.checklist pro tvorbu kontrolních checklistů a /speckit.taskstoissues pro převod úkolů do GitHub issues.

Podle instalačního návodu jsou oficiální balíčky publikované z GitHub repozitáře. Projekt upozorňuje, že balíčky se stejným názvem na PyPI nejsou oficiálně udržované tímto projektem.

Doporučená trvalá instalace přes uv:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z
specify version

Jednorázové použití bez trvalé instalace:

uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>

Inicializace do existujícího projektu s konkrétní integrací:

specify init . --integration copilot
# nebo
specify init --here --integration copilot

vX.Y.Z je potřeba nahradit konkrétním tagem z vydání projektu. Pinování verze je vhodnější než používání aktuálního main, protože šablony a příkazy se mohou měnit.

Přehled podporovaných integrací uvádí širokou sadu AI coding agentů a IDE nástrojů. Patří mezi ně například GitHub Copilot, Claude Code, Codex CLI, Gemini CLI, Cursor, opencode, Qwen Code, Roo Code, Windsurf, Kiro CLI a další.

Spec Kit při inicializaci připraví pro zvoleného agenta odpovídající command files, pravidla a adresářovou strukturu. Dostupné integrace lze vypsat příkazem:

specify integration list

Další integrační příkazy umožňují integraci nainstalovat, odinstalovat, přepnout, nastavit jako výchozí nebo aktualizovat:

specify integration install <key>
specify integration switch <key>
specify integration use <key>
specify integration upgrade <key>

Spec Kit se dá rozšiřovat přes extensions a presets. CLI reference rozlišuje několik oblastí:

Extensions přidávají nové schopnosti — například integrace s externími systémy, nové workflow nebo quality gates.
Presets upravují chování existujícího workflow — například formát šablon, firemní standardy, metodiku nebo lokalizaci.
Workflows skládají více kroků do opakovatelných sekvencí.

V README projektu je zároveň upozornění, že komunitní extensions a presets jsou třetí strany. GitHub a maintainers projektu je nemusí auditovat ani podporovat, takže je potřeba kontrolovat jejich zdrojový kód před instalací.

Spec Kit se hodí hlavně tam, kde AI agent nemá jen „něco napsat“, ale má pracovat podle jasně popsaného zadání:

greenfield projekt, kde je potřeba nejdřív ujasnit produktové požadavky,
větší feature, kde jednorázový prompt nestačí,
týmová práce, kde mají být specifikace verzované a kontrolovatelné,
experimenty s více implementačními variantami stejné specifikace,
brownfield vývoj, kde je potřeba přidávat funkce bez ztráty kontextu.

Pro malé jednorázové úpravy může být workflow zbytečně těžké. Hodnota roste s nejasností zadání, počtem lidí v projektu a rizikem, že AI agent začne doplňovat vlastní domněnky.

Minimální postup pro vyzkoušení:

# 1. Inicializace projektu
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init my-project --integration copilot
 
# 2. Přechod do projektu
cd my-project
 
# 3. Kontrola instalace
specify check

Potom se v AI agentovi použije nejdřív constitution a až následně specifikace konkrétní funkcionality:

/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements

/speckit.specify Build an application that can help me organize my photos in separate photo albums...

Důležité je nezačínat technologií. Technologický stack patří až do /speckit.plan. Specifikace má nejdřív popsat uživatelský problém, očekávané chování, hraniční případy a akceptační kritéria.

Projekt je podle licence MIT open-source.
Spec Kit není náhrada za kontrolu výstupů AI. Specifikace, plán i kód je potřeba číst a opravovat.
Při upgradu projektu je vhodné zálohovat vlastní úpravy šablon a konstituce. Upgrade guide upozorňuje, že některé sdílené soubory se při použití –force přepisují.
U enterprise nebo air-gapped prostředí existuje postup s vytvořením lokálního wheel bundle na připojeném stroji.

Spec Kit

Co Spec Kit řeší

Základní workflow

Instalace

Integrace s AI agenty

Extensions a presets

Kdy dává smysl

Praktický start

Poznámky

Zdroje

Wiki