openspec-howtolisted

Посібник з використання OpenSpec CLI (@fission-ai/openspec) у проєктах. Команди /opsx:explore, /opsx:propose, /opsx:apply, /opsx:archive — коли використовувати кожну; CLI list, validate, status, show — що роблять і коли; як називати changes, delta-спеки, артефакти, типові сценарії. Використовуй коли користувач питає "як працює OpenSpec", "openspec list validate status show", "/opsx", "openspec workflow", "як архівувати change".
makshc2/agent-orchestrator-kit · ★ 1 · AI & Automation · score 74

Install: claude install-skill makshc2/agent-orchestrator-kit

# OpenSpec — посібник Spec-driven workflow на базі `@fission-ai/openspec` (профіль `core`). ## Архітектура ``` openspec/ ├── config.yaml # контекст проєкту для AI ├── specs/ # source of truth після archive │ └── <domain>/spec.md └── changes/ ├── <change-name>/ │ ├── proposal.md │ ├── design.md │ ├── tasks.md │ └── specs/<domain>/spec.md # delta └── archive/ ``` - `changes/` — активна робота - `specs/` — як працює система (через archive) ## Чотири команди ### `/opsx:explore` **Коли:** скоуп неясний, треба обговорити підхід. **Що робить:** Q&A, пошук по коду, без файлів. ### `/opsx:propose <kebab-name>` **Коли:** є чітка задача — фіча або серйозний баг. **Що робить:** створює `openspec/changes/<name>/` з proposal/design/tasks/specs. **Іменування:** `add-...`, `fix-...`, `refactor-...`, `migrate-...`. ### `/opsx:apply` **Коли:** артефакти переглянуто, план затверджено. **Що робить:** виконує `tasks.md`, пише код, ставить `[x]`. ### `/opsx:archive` **Коли:** код merged у dev/main, build/lint OK. **Що робить:** мерджить delta у `openspec/specs/<domain>/spec.md` (ADDED/MODIFIED/REMOVED) і переносить change у `archive/`. ## Цикл ``` ідея → /opsx:explore (опційно) → /opsx:propose <name> → review артефактів → /opsx:apply → npm run build → merge → /opsx:archive ``` ## CLI (read-only — не змінює код) Завжди `npx openspec …` або `npm run openspec:*` / `npx agent-orchestrator-kit …`. Голі `openspec` / `age