Osvědčené postupy a časté chyby
Osvědčené postupy a časté chyby
Lekce naučené z produkčního SDD
Tyto osvědčené postupy jsou extrahovány z reálného nasazení SDD napříč týmy od sólo vývojářů po enterprise inženýrské organizace.
Osvědčené postupy
Rozdělte práci na malé iterace
Nikdy nežádejte AI o vytvoření celé aplikace najednou. Rozdělte práci na úkoly dokončitelné za 15-30 minut AI generování. Každá iterace: generování, revize, testování, commit.
Commitujte po každé ověřené změně
Verzování je vaše záchranná síť. Po implementaci, otestování a přezkoumání každého úkolu okamžitě commitněte se zprávou odkazující na úkol.
Udržujte specifikace a kód v synchronizaci
Když změníte specifikaci, přegenerujte dotčený kód. Když kód odhalí mezeru ve specifikaci, aktualizujte specifikaci. Specifikace je vždy zdrojem pravdy.
Revidujte AI výstup jako kód juniora
AI-generovaný kód je kompetentní, ale nedokonalý. Revidujte ho se stejnou důsledností jako pull request juniorního vývojáře. Důvěřuj, ale ověřuj.
Používejte kontextové soubory důsledně
Každý projekt dostane CLAUDE.md nebo ekvivalent. Aktualizujte ho, když se změní standardy. 10 minut strávených údržbou ušetří hodiny opětovného vysvětlování.
Časté chyby
Past mega-promptu
Snaha vygenerovat celou aplikaci z jednoho masivního promptu. I s perfektní specifikací velké generovací požadavky produkují nekonzistentní výsledky. Rozdělte to.
Zastarávání specifikací
Napsání specifikace jednou a nikdy ji neaktualizovat. Jak se projekt vyvíjí, specifikace se musí vyvíjet také. Zastaralé specifikace vedou k odchylce mezi záměrem a implementací.
Přeskočení revize
Přijímání AI výstupu bez jeho přečtení, protože 'kompiluje se'. AI kód často obsahuje jemné logické chyby, bezpečnostní problémy nebo výkonnostní nedostatky, které zachytí jen lidská revize.
Přílišná specifikace implementace
Diktování přesných názvů tříd, signatur funkcí nebo databázových schémat ve specifikaci. To odstraňuje schopnost AI najít optimální řešení. Specifikujte chování, ne strukturu.
Žádná testovací strategie
Generování kódu bez testovacího plánu. AI-generovaný kód potřebuje VÍCE testování než ručně psaný kód, protože ho vývojář nepsal řádek po řádku.
Kontrolní seznam zralosti SDD
| Praxe | Začátečník | Pokročilý | Expert |
|---|---|---|---|
| Formát specifikací | Neformální poznámky | Strukturovaný markdown | Šablony s CI |
| Kontextové soubory | Žádné | Základní CLAUDE.md | Multi-soubor s rolemi |
| Granularita úkolů | Celé funkce | Pod-funkce | 15min inkrementy |
| Testování | Manuální | Částečně automatické | Plný TDD cyklus |
| Proces revize | Letmý pohled | Čtení veškerého kódu | Spec + code review |
| Verzování | Příležitostné commity | Commity per úkol | Konvenční commity |
Váš SDD startovní kontrolní seznam
Závěrečná myšlenka
SDD je dovednost, která se praxí zlepšuje. Vaše první specifikace bude nedokonalá. Váš první rozklad úkolů bude příliš hrubý. To se očekává. Metodologie odměňuje iteraci — každý cyklus vás naučí psát lepší specifikace, vytvářet přesnější úkoly a efektivněji revidovat. Začněte dnes, zlepšete se zítra.
Momentálně nejsou žádné komentáře.