Anatomie dobré specifikace
Anatomie dobré specifikace
Vaše specifikace je váš nejdůležitější výstup
Ve Specs Driven Development je specifikace váš nejdůležitější výstup. Dobře napsaná specifikace není jen dokumentace — je to prompt, který řídí vašeho AI agenta ke generování správného kódu. Kvalita vaší specifikace přímo určuje kvalitu generovaného výstupu.
Formát
Specifikace standardně používají Markdown, protože je čitelný v IDE, krásně se renderuje na GitHubu a lidé i AI agenti ho snadno parsují.
Struktura requirements.md
Přehled projektu
Začněte jasným, stručným popisem toho, co stavíte. Zahrňte řešený problém, cílové uživatele a základní hodnotovou nabídku.
Tech Stack
Explicitně vypište každou technologii, framework a verzi. AI agenti potřebují přesný kontext — nenechte je hádat nebo používat zastaralé verze.
Funkční požadavky
Rozdělte funkce do user stories s jasnými akceptačními kritérii. Každý příběh by měl být nezávisle implementovatelný a testovatelný.
Nefunkční požadavky
Výkonnostní cíle, bezpečnostní omezení, očekávání škálovatelnosti, standardy přístupnosti. Tyto jsou často důležitější než funkce.
Omezení a hranice
Co systém NEMÁ dělat. Explicitní vyloučení zabraňují AI v over-engineeringu nebo přidávání nechtěných funkcí.
Psaní efektivních User Stories
Jako [role], chci [akce], abych [přínos]. Akceptační kritéria: - Pokud [kontext], když [akce], pak [výsledek] - Pokud [kontext], když [akce], pak [výsledek] - Hraniční případ: [scénář] by měl [chování]
Pravidlo akceptačních kritérií
Pokud nemůžete napsat akceptační kritéria pro funkci, nerozumíte jí dostatečně na to, abyste ji specifikovali. Vraťte se a upřesněte požadavky, než požádáte AI o implementaci.
Časté chyby ve specifikacích
Příliš vágní
Říct 'přidej autentizaci' bez specifikace OAuth providerů, správy sessions nebo expirace tokenů nechává AI dělat kritická rozhodnutí za vás.
Příliš detailní
Specifikovat přesné CSS pixely nebo názvy databázových sloupců ve specifikaci ji svazuje s implementací. Zaměřte se na CO, ne JAK.
Chybějící edge cases
Nezmínění chybových stavů, prázdných stavů nebo souběžného přístupu vede ke kódu, který funguje pouze na happy path.
Žádná omezení
Bez explicitních omezení AI přidá funkce, o které jste nežádali. Hranice jsou stejně důležité jako požadavky.
Kontrolní seznam kvality specifikace
Pamatujte
30minutová investice do psaní dobré specifikace ušetří hodiny debugování a přepracování. Specifikace je vaše páka — násobí efektivitu každé následující interakce s AI.
Momentálně nejsou žádné komentáře.