CLI a workflow¶
CLI příkazy¶
Vytvoření nové změny¶
# Vytvořit strukturu pro novou změnu
mkdir -p openspec/changes/add-barcode-scanning/specs/warehouse
# Vytvořit základní soubory
touch openspec/changes/add-barcode-scanning/proposal.md
touch openspec/changes/add-barcode-scanning/tasks.md
touch openspec/changes/add-barcode-scanning/specs/warehouse/spec.md
Validace změny¶
# Validace konkrétní změny
openspec validate add-barcode-scanning --strict
# Validace všech aktivních změn
openspec validate --changes
# JSON výstup pro CI/CD
openspec validate add-barcode-scanning --json
Zobrazení stavu¶
# Seznam aktivních změn s progress bary
openspec list
# Output:
# Changes:
# add-barcode-scanning ████████░░░░ 8/16 tasks
# fix-invoice-validation ████████████ 4/4 tasks ✓
# Detail konkrétní změny
openspec show add-barcode-scanning
# Pouze delta operace
openspec show add-barcode-scanning --deltas-only
Archivace dokončené změny¶
# Ověření, že všechno je hotovo
openspec validate add-barcode-scanning --strict
# Archivace (aplikuje delta na specs/)
openspec archive add-barcode-scanning --yes
# Output:
# Applying changes to openspec/specs/warehouse/spec.md:
# + 2 added
# ~ 1 modified
# - 0 removed
#
# Change 'add-barcode-scanning' archived as '2025-02-15-add-barcode-scanning'
Workflow pro AI agenty¶
Slash command: /openspec:proposal¶
**Guardrails**
- Identifikuj nejasnosti a zeptej se DŘÍVE než vytvoříš soubory
- NEPÍŠ kód v této fázi
- Refer to openspec/AGENTS.md pokud si nejsi jistý
**Steps**
1. Přečti openspec/project.md pro kontext projektu
2. Spusť `openspec list` a `openspec list --specs`
3. Zvol unikátní change-id (verb-led, kebab-case)
4. Vytvoř proposal.md, tasks.md
5. Vytvoř design.md pokud je potřeba
6. Vytvoř delta specs s ADDED/MODIFIED/REMOVED
7. Validuj: `openspec validate <id> --strict`
Slash command: /openspec:apply¶
**Guardrails**
- Implementuj POUZE co je v proposal.md a specs/
- Neměň scope bez nového proposal
- Označ tasky jako hotové ihned po dokončení
**Steps**
1. Přečti proposal.md, design.md, tasks.md
2. Projdi tasky sekvenčně
3. Po dokončení tasku aktualizuj tasks.md: `- [x]`
4. Spusť testy relevantní pro změnu
5. Validuj: `openspec validate <id> --strict`
Slash command: /openspec:archive¶
**Guardrails**
- Archivuj POUZE když jsou všechny tasky hotové
- Ověř, že implementace odpovídá specifikaci
**Steps**
1. Zjisti change ID z kontextu nebo `openspec list`
2. Ověř dokončení: `openspec show <id>`
3. Spusť: `openspec archive <id> --yes`
4. Zkontroluj výstup pro aplikované změny
5. Finální validace: `openspec validate --specs`
Příklad kompletního workflow¶
1. Klient pošle požadavek¶
"Potřebujeme, aby skladníci mohli skenovat čárové kódy místo ručního vyhledávání produktů."
2. Vytvoření proposal¶
mkdir -p openspec/changes/add-barcode-scanning/specs/warehouse
# Napíše proposal.md, tasks.md, specs/warehouse/spec.md (delta)
3. Review a schválení¶
4. Implementace¶
5. Testování¶
6. Archivace¶
➡️ Pro přehled architektury AI agentů viz Architektura AI Agentů.