РЕКЛАМА Playerok Playerok — маркетплейс игровых аккаунтов, предметов и цифровых товаров.Реклама. Playerok. erid: 2SDnjdoNNsV. Рекламодатель ООО "Смарт Хоум", ИНН 9731066701. Перейти →
ГАЙД 2026

Spec-Driven Development: как заставить кодинг-агента работать по спецификации

Сначала спецификация, потом план и задачи, и только затем код. Spec Kit превращает этот порядок в набор команд в чате вашего агента: 148 661 звезда на GitHub и 43 ключа интеграций на 08.11.2026.

ГайдМетодологияSpec Kit
Уровень СреднийВремя настройки 20–40 минутЛицензия MITОбновлено 08.11.2026

Spec-Driven Development (SDD) — способ работы, при котором агент сначала фиксирует, что и зачем строится, затем раскладывает это на план и задачи, и только после этого пишет код. GitHub Spec Kit — открытый набор инструментов под MIT, который делает такой порядок механическим: каждая фаза это команда в чате агента, а результат каждой фазы — файл в репозитории, который можно прочитать и отревьюить.

Короткий ответ
Ставится за две команды: uv tool install specify-cli и specify init app --integration claude (ключ интеграции — под вашего агента). Дальше в чате агента: /speckit-constitution, /speckit-specify, /speckit-plan, /speckit-tasks, /speckit-implement, /speckit-converge — по одной команде за раз, с ревью результата. Нужны Python 3.11+ и пакетный менеджер uv.
148 661
Звёзд на GitHub
08.11.2026
v1.3.2
Релиз
43
Ключей интеграций
агенты и generic
1 898
Коммитов за год
52 недели

01Почему SDD стал мейнстримом

Кодинг-агент без спецификации додумывает требования: сам выбирает структуру, сам решает, что считать готовым, и уходит в сторону на третьем шаге. Спецификация превращает разговор в контракт: требования, границы, критерии приёмки. Дальше агент не «творит», а исполняет контракт — и это резко повышает долю задач, которые доходят до результата.

Плати по всему миру — карта для оплаты зарубежных нейросетей, приложений и подписок из России
Реклама. ООО «КАПИБАРА», ИНН 9703231520

Spec Kit появился 21.08.2025 и к 08.11.2026 собрал 148 661 звезду и 13 355 форков при 1 898 коммитах за последние 52 недели — по данным GitHub API. В октябре 2026 проект вышел на версию 1.0 с расширенным набором инструментов (об этом авторы говорят в официальном видео Open Source Friday), а текущий релиз — v1.3.2.

Тренд шире одного инструмента: репозитории, которые формализуют контекст и правила для агентов, растут быстрее остальных. Ниже — сопоставимые цифры по четырём таким проектам.

Репозитории, которые формализуют работу агентазвёзд на GitHub, снято 08.11.2026
0200 000400 000mattpocock/skills318 404anthropics/skills189 465github/spec-kit148 661Nutlope/hallmark50 837
mattpocock/skills и anthropics/skills — наборы навыков, github/spec-kit — процессы и шаблоны SDD, Nutlope/hallmark — дизайн-навык против «нейрослопа». Числа не отражают качество: это размер сообщества вокруг идеи «агенту нужны правила».

02Три независимых процесса

В Spec Kit 1.x SDD — не единственный вход. Документация описывает три независимых процесса: сборка по спецификации, починка бага и оценка идеи. Это не обязательные фазы одного конвейера: багфикс и оценка ставятся отдельными расширениями и запускаются, когда нужны.

ПроцессКак включитьРезультат
SDD (сборка функции)входит в ядроспецификация, план, задачи, код и отчёт о сходимости
Bug fixingspecify extension add bugоценка причины, ограниченный фикс, записанная проверка
Idea assessmentspecify extension add assessрешение go / needs-clarification / kill с обоснованием
Три процесса Spec Kit по официальному README на 08.11.2026

Практический смысл: не нужно тащить полный цикл SDD ради исправления одной кнопки. Команды багфикса работают в отдельной папке .specify/bugs/<slug>/ и заканчиваются вердиктом verified, partial или failed — только первый означает, что симптом действительно ушёл.

03Фазы SDD и что появляется в проекте

Минимальный поток выглядит так: конституция проекта заводится один раз, остальные шаги повторяются для каждой функции. Команды выполняются в чате агента, по одной, с просмотром результата перед следующей — это прямое требование документации, а не стилистическая рекомендация.

1constitutionпринципы: качество кода, тесты, поддерживаемость — один раз на проект2specifyчто строим и зачем: сценарии, границы, критерии приёмки3planкак строим: стек, структура, ограничения4tasksразбиение на исполнимые задачи5implementагент пишет код по задачам6convergeсверка с спецификацией до отчёта Convergedimplement и converge повторяются, пока отчёт о сходимости не покажет Converged
КомандаЧто делаетАртефакт
/speckit-constitutionфиксирует принципы проектаконституция в .specify/
/speckit-specifyописывает функцию и критерии приёмкиспецификация
/speckit-planвыбирает стек и структуруплан реализации
/speckit-tasksрежет план на задачисписок задач
/speckit-implementпишет код по задачамизменения в репозитории
/speckit-convergeсверяет результат со спецификациейотчёт Converged
Базовые команды SDD и их артефакты (синтаксис GitHub Copilot; у других агентов — свой)

Синтаксис слэш-команд зависит от агента: документация даёт таблицу интеграций и отдельную страницу про то, как вызывать команды в каждом ханессе. Поэтому примеры из статей «для Copilot» у вас в Claude Code или Codex могут выглядеть иначе — сверяйтесь с разделом интеграций.

Коммиты в github/spec-kit по неделямкоммитов в неделю, последние 12 недель до 08.11.2026 (GitHub API, participation)
02040608023.0806.0920.0904.1018.1001.11591855423869435843395370
Последняя неделя неполная: данные сняты 08.11.2026. Ровный темп без провалов говорит о регулярных релизах, а не о разовом всплеске.

04Установка и первый проект

Нужны Python 3.11+ и uv (официальный установщик пакетов от Astral). CLI ставится как обычный инструмент, затем инициализируется проект с ключом вашего агента — именно ключ определяет, в каком формате Spec Kit положит команды и шаблоны.

От установки до первой спецификации
1
Поставить CLI
через uv, глобально
terminalcopy
uv tool install specify-cli
2
Создать проект
ключ интеграции — ваш агент
terminalcopy
specify init app --integration claude
3
Зайти в каталог
и запустить агента там же
terminalcopy
cd app
4
Задать принципы
один раз на проект, в чате
agentcopy
/speckit-constitution
5
Описать функцию
что строим и по каким критериям
agentcopy
/speckit-specify

Ключи интеграций перечислены в разделе Integrations: claude, codex, copilot, cursor-agent, gemini, cline, opencode, qwen, goose, zed, tabnine, droid, amp, kimi, junie и другие — всего 43 строки в таблице, включая generic и none. Для существующего проекта есть отдельный how-to: Spec Kit умеет начинать с уже написанного кода, а не только с пустого каталога.

Порядок важнее скорости
Соблазн прогнать все команды подряд велик, но документация настаивает: одна команда — одно ревью. Спецификация, которую никто не прочитал, не отличается от промпта, только выглядит солиднее.

05Расширения, пресеты и воркфлоу

Spec Kit не требует принимать его методологию целиком. В README есть таблица механизмов: расширения добавляют команды и гейты, пресеты меняют шаблоны и терминологию, воркфлоу автоматизируют последовательности, оверлеи правят установленный воркфлоу без форка, а бандлы собирают готовую настройку под роль или команду.

  • Extension — новая команда, проверка качества или целый процесс; точка подключения внешних сервисов.
  • Preset — адаптация шаблонов, команд и терминов под стандарты организации или регулятора.
  • Workflow + overlay — автоматизация промптов, гейтов и shell-задач без форка чужого воркфлоу.
  • Bundle — упаковка расширений, пресетов и воркфлоу в один устанавливаемый набор.
  • Catalog — поиск компонентов сообщества командами вида specify extension search.
Каталог — не аудит
Документация прямо предупреждает: listing в каталоге не является проверкой или рекомендацией. Код сообщества ставят на свой проект — значит, его читают до установки. Это же правило действует для любых агентских навыков и расширений.

06Типичные ошибки и ограничения

SDD — это процесс, а не кнопка «сделай хорошо». Ниже — то, на чём чаще всего спотыкаются при внедрении, и чем подход отличается от привычных вариантов работы с агентом.

ПодходЧто даёт агентуГде ломается
Один длинный промптзадачу целикомтребования теряются, критериев готовности нет
План в чатепорядок шаговплан живёт в переписке и не ревьюится
SDD в Spec Kitконтракт и артефакты в репозиториинужна дисциплина: одна команда — одно ревью
Редакционное сравнение Qantcore: разница не в инструменте, а в наличии письменного контракта
  • Прогонять все фазы пачкой без чтения результатов — теряется весь смысл спецификации.
  • Писать спецификацию ради спецификации: без критериев приёмки converge нечего проверять.
  • Ставить SDD на legacy-проект без how-to для существующих проектов и без пресета под свои стандарты.
  • Забывать, что синтаксис слэш-команд зависит от интеграции: примеры из чужой статьи могут не сработать.
  • Ждать, что агент сам выберет правильный процесс — три входа независимы, выбор за человеком.

Ограничение по существу одно: Spec Kit не оценивает качество вашей спецификации. Он гарантирует, что она существует, лежит в репозитории и связана с планом, задачами и кодом. Смысл требований остаётся на человеке — и это, пожалуй, самая честная часть подхода.

Итог гайда
8,6/ 10
Spec Kit — самый зрелый инструмент вокруг идеи «агенту нужен письменный контракт». Он бесплатный, ставится за минуту, работает с 43 ключами интеграций и не требует менять агента. Начинать стоит с одного проекта и одной функции: конституция, спецификация, план, задачи. Если после первого цикла отчёт converge перестал быть формальностью — процесс прижился.
Нет зарубежной карты для оплаты?Реклама. ООО «КАПИБАРА», ИНН 9703231520Оформить карту →
Как оплатить AI из России — разбор

Частые вопросы

Spec Kit бесплатный?
Да, проект распространяется под MIT. Платными могут быть только сам агент, которого вы используете, и его модель.
Нужен ли GitHub Copilot?
Нет. Copilot — лишь один из ключей интеграции и пример в документации. Есть ключи для claude, codex, cursor-agent, gemini, cline, opencode, qwen, goose, zed и других агентов, всего 43 строки в таблице интеграций.
Чем SDD отличается от обычного планирования в чате?
Артефактами. Спецификация, план и задачи сохраняются в .specify/ и версионируются вместе с кодом, поэтому их можно ревьюить, сравнивать и передавать другому человеку или агенту.
Можно ли применить к существующему проекту?
Да. В документации есть отдельный how-to для существующих проектов: Spec Kit начинает с имеющегося кода, а пресеты позволяют подогнать шаблоны под стандарты команды.
Что делать, если агент не сходится со спецификацией?
Шаги implement и converge повторяют до отчёта Converged. Если расхождение не уходит, проблема обычно в спецификации: не заданы критерии приёмки или границы задачи — их правят, а не код.

Официальные источники

Нужны агенты под конкретную задачу?
Каталог Qantcore собирает обзоры и карточки продуктов: кодинг-агенты, фреймворки, платформы и способы оплаты из РФ.
Оплата AI-сервисов из РоссииКарта РФ, СБП или реселлер — рабочая страница оплаты без VPN
Перейти к оплате →