Spec Kit — процессы для AI-агентов: спецификации, баги и идеи

Spec Kit — опенсорсный набор инструментов от GitHub для работы с AI-агентами. Изначально проект продвигал spec-driven development (SDD): сначала вы пишете спецификацию, а агент превращает её в план, задачи и работающий код. К осени 2026 года Spec Kit дорос до версии 1.0 и перестал быть инструментом про один процесс. Теперь это набор независимых процессов: помимо SDD появились расширения для исправления багов и для оценки идей до начала разработки.

Три процесса

Каждая задача получает свой процесс:

• Spec-Driven Development — построить новую функцию или приложение. Спецификация проходит через планирование, реализацию и сходимость. Процесс встроен в ядро.
• Bug fixing — диагностировать и починить сломанное поведение. Результат: установленная причина, ограниченное исправление и зафиксированная проверка. Ставится отдельным расширением.
• Idea assessment — решить, стоит ли идея вложений. Результат: обоснованное решение go, needs-clarification или kill. Тоже отдельное расширение.

Это независимые точки входа, а не обязательные фазы одного конвейера. Полный цикл проходить не нужно — берётся только нужный процесс. А если ни один не подходит, примитивы Spec Kit позволяют адаптировать чужой процесс или собрать собственный.

Spec-Driven Development

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

Команды запускают в чате агента, а не в терминале. По одной за раз. Каждый результат проверяют перед следующим шагом.

/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge

Шесть команд:

1. Constitution — принципы проекта: качество кода, тестирование, сопровождаемость.
2. Specify — что строим и зачем. Требования и user stories без привязки к стеку.
3. Plan — технологический стек и архитектура: библиотеки, фреймворки, хранилища.
4. Tasks — план превращается в список конкретных задач.
5. Implement — агент выполняет задачи и собирает функциональность.
6. Converge — новая фаза сходимости. Цикл implement и converge повторяют, пока не появится отчёт Converged.

Если вы пользовались Spec Kit раньше, обратите внимание на синтаксис: точка в именах команд заменена на дефис — вместо /speckit.specify теперь /speckit-specify. Примеры выше показывают синтаксис GitHub Copilot. Для остальных агентов документация описывает эквивалентные варианты вызова. Есть также разбор уточнений, чек-листы и анализ согласованности — они показаны в пошаговом руководстве по SDD. Философия методологии изложена отдельно в spec-driven.md.

Исправление багов

Расширение ставится одной командой из каталога:

specify extension add bug

Дальше три шага в чате агента:

• /speckit-bug-assess — установить причину по описанию симптома.
• /speckit-bug-fix — внести исправление.
• /speckit-bug-test — проверить, что исходный симптом исчез.

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

Оценка идей

Расширение ставится так же:

specify extension add assess

Процесс состоит из пяти шагов: intake, research, define, shape, decide. Каждый шаг оставляет Markdown-артефакты в каталоге .specify/assessments/<slug>/. Финальное решение: go, needs-clarification или kill.

Неизвестные вопросы закрывают правкой существующих артефактов — вручную или через агента. Перезапускать этапы целиком не нужно. Если решение go, а идея про софт, создаётся конституция проекта, и выжимка из decision.md передаётся в /speckit-specify. Дальше работает обычный SDD. Остановка с задокументированной причиной — тоже полезный результат. Исходный код для этого процесса не нужен. Детали — в руководстве по оценке идей.

Кастомизация

Spec Kit собран из механизмов, которые комбинируются между собой:

• Extensions — новые команды, quality gates и целые процессы. Расширение может подключать внешние сервисы, реагировать на события жизненного цикла агента (runtime events) и запускать свои команды до или после команд Spec Kit (hooks).
• Presets — адаптация шаблонов, команд, терминологии и методологии. Типичный случай — корпоративные или регуляторные требования к планам и спецификациям.
• Project-local overrides — разовая замена шаблона внутри одного проекта без создания пресета.
• Workflows — автоматизация промптов, команд, проверок и shell-задач. Установленный workflow можно менять через overlays, не делая форк. Своё исполняемое поведение добавляют custom workflow steps.
• Bundles — готовые наборы расширений, пресетов и workflow под роль или команду.
• Catalogs — каталоги компонентов. Каталоги сообщества входят в поставку, организации могут публиковать свои проверенные наборы с аутентификацией. Поиск идёт командами вроде specify extension search или specify bundle search. Содержимое каталогов — не аудит и не рекомендация, поэтому код из community-источников стоит читать перед установкой.

Для закрытых сред есть поддержка air-gapped-установок: локальные источники и самостоятельно размещённые каталоги. Разобраться, какой слой поставляет конкретную команду, шаблон или скрипт, помогает инвентаризация артефактов.

Общий принцип кастомизации: начать с наименьшего изменения, которое решает задачу. Заменять весь процесс целиком не требуется. Практические приёмы собраны в руководстве по кастомизации.

Установка и документация

Потребуются Python 3.11+, пакетный менеджер uv и поддерживаемый AI coding agent. Платформы: Linux, macOS и Windows.

uv tool install specify-cli
specify init my-project --integration copilot
cd my-project

Флаг --integration задаёт агента. Полный список интеграций и синтаксис вызова команд — на странице интеграций. Документация живёт на отдельном сайте: там справочник CLI, руководства how-to и история проекта.

Проект распространяется под лицензией MIT и подходит и для новых проектов, и для доработки существующих.