Spec-Driven Development · Qwen Code + OpenSpec
Спецификация — контракт, а не ритуал
Практический туториал по внедрению SDD в команде с микросервисами, десятком репозиториев и своими NuGet-библиотеками. Включая главный вопрос: где заводить проект для спецификаций.
$ npm install -g @fission-ai/openspec@latest
$ cd payments-service && openspec init --tools qwen
qwen> /opsx-propose limit-refund-window
✓ proposal.md — зачем и что меняем
✓ specs/ — требования и сценарии
✓ design.md — техническое решение
✓ tasks.md — чек-лист реализации
qwen> /opsx-apply # агент реализует по чек-листу
qwen> /opsx-archive # дельта влилась в openspec/specs/Сквозной кейс
Команда «Синтез»
Весь туториал построен на одном кейсе — вымышленной, но узнаваемой команде B2B-платформы. Если у вас микросервисы, разные репозитории и общие библиотеки — это про вас.
- Сервисы
- 7 микросервисов на .NET, у каждого свой репозиторий
- Библиотеки
- 2 NuGet-пакета в отдельном репозитории, свой фид
- Команда
- 6 инженеров, каждый уже пользуется ИИ-агентом по-своему
- Боль
- требования живут в чатах; агенты уверенно строят не то
Программа
Шесть частей
- 01Зачем нужна спецификацияПочему промпт — это неявное знание, а спека — явный контракт. Что такое spec-driven development и чем он не waterfall.~7 мин
- 02Инструменты: Qwen Code и OpenSpecУстановка и настройка Qwen Code CLI, инициализация OpenSpec, цикл explore → propose → apply → archive.~9 мин
- 03Монорепозиторий или мультирепо: где живут спекиГлавный архитектурный выбор: openspec/ в каждом репо, центральный репозиторий спецификаций (Store) или гибрид. Плюсы, минусы, рекомендация.~12 мин
- 04Первая фича через спецификациюПошаговый прогон в одном сервисе: init, propose, ревью дельта-спеки, apply, archive.~10 мин
- 05Сквозная фича: несколько сервисов и NuGet-пакетДвухслойная схема со Store: общий контракт в репозитории планирования, реализация — локальными изменениями в каждом репо.~11 мин
- 06Внедрение в командеПилот, конвенции, ревью спеки до ревью кода, openspec validate в CI и типовые ошибки внедрения.~8 мин