====== Spec Kit ======

//Vytvořeno: **5.5.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/github/spec-kit|Spec Kit]] je open-source toolkit od GitHubu pro [[https://github.com/github/spec-kit/blob/main/spec-driven.md|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 [[https://github.github.io/spec-kit/|oficiální dokumentaci]] na GitHub Pages.

===== Co Spec Kit řeší =====

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.

===== Základní workflow =====

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.

===== Instalace =====

Podle [[https://github.com/github/spec-kit/blob/main/docs/installation.md|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'':

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

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

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

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

<code bash>
specify init . --integration copilot
# nebo
specify init --here --integration copilot
</code>

''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.

===== Integrace s AI agenty =====

[[https://github.github.io/spec-kit/reference/integrations.html|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:

<code bash>
specify integration list
</code>

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

<code bash>
specify integration install <key>
specify integration switch <key>
specify integration use <key>
specify integration upgrade <key>
</code>

===== Extensions a presets =====

Spec Kit se dá rozšiřovat přes extensions a presets. [[https://github.github.io/spec-kit/reference/overview.html|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í.

===== Kde Spec Kit zapadá do širší dokumentační architektury =====

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: [[ai:platformy:claude-code:strukturace-dokumentace|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.

===== Kdy dává smysl =====

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.

===== Praktický start =====

Minimální postup pro vyzkoušení:

<code bash>
# 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
</code>

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

<code>
/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...
</code>

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.

===== Poznámky =====

  * Projekt je podle licence [[https://github.com/github/spec-kit/blob/main/LICENSE|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. [[https://github.com/github/spec-kit/blob/main/docs/upgrade.md|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.

===== Zdroje =====

  * [[https://github.com/github/spec-kit|GitHub — github/spec-kit]]
  * [[https://github.github.io/spec-kit/|Spec Kit Documentation]]
  * [[https://github.com/github/spec-kit/blob/main/spec-driven.md|Specification-Driven Development]]
  * [[https://github.com/github/spec-kit/blob/main/docs/installation.md|Spec Kit — Installation Guide]]
  * [[https://github.github.io/spec-kit/reference/integrations.html|Spec Kit — Supported AI Coding Agent Integrations]]
  * [[https://github.github.io/spec-kit/reference/overview.html|Spec Kit — CLI Reference]]
  * [[https://github.com/github/spec-kit/blob/main/docs/upgrade.md|Spec Kit — Upgrade Guide]]
  * [[https://github.com/github/spec-kit/blob/main/LICENSE|Spec Kit — MIT License]]
  * [[ai:platformy:claude-code:strukturace-dokumentace|Strukturace dokumentace pro Claude Code]] – Tučného framework pro celkovou dokumentační architekturu repozitáře