Spec Kit

Vytvořeno: 5.5.2026 | Aktualizováno: 05.05.2026 09:33

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:

1. /speckit.constitution — vytvoření nebo aktualizace projektových principů, pravidel a governance.
2. /speckit.specify — popis funkcionality z pohledu požadavků, user stories a akceptačních kritérií.
3. /speckit.clarify — doplnění nejasností před technickým plánem.
4. /speckit.plan — převod specifikace do technického plánu a rozhodnutí o architektuře.
5. /speckit.tasks — rozpad plánu na konkrétní implementační úkoly.
6. /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 pokrývá TO BE stranu vývoje — vytvoří specifikaci, plán a úkoly pro konkrétní feature nebo epik. Neřeší ale, jak vypadá AS IS dokumentace systému (struktura docs/, dokumentace u kódu, archivace rozhodnutí).

Tuhle druhou část — celkovou architekturu dokumentace repozitáře — popisuje přístup Ondřeje Tučného prezentovaný na Vibeco Ding Talks: Strukturace dokumentace pro Claude Code. Ten definuje, kde co v repozitáři žije, jak oddělit AS IS od TO BE, jak dokumentaci prohledávat přes MCP nástroj a jak strukturovat úkolovou historii.

Vztah je tedy:

• Tučného framework = celková architektura — kde věci leží a jaký mají životní cyklus
• Spec Kit = konkrétní nástroj pro TO BE část — jak specifikaci, plán a úkoly prakticky vytvářet

Oba přístupy se doplňují: Spec Kit lze použít uvnitř Tučného frameworku jako implementaci tasks/ strany.

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.

• GitHub — github/spec-kit
• Spec Kit Documentation
• Specification-Driven Development
• Spec Kit — Installation Guide
• Spec Kit — Supported AI Coding Agent Integrations
• Spec Kit — CLI Reference
• Spec Kit — Upgrade Guide
• Spec Kit — MIT License
• Strukturace dokumentace pro Claude Code – Tučného framework pro celkovou dokumentační architekturu repozitáře