Spec Kit — инструментарий для спецификаций в AI-разработке

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

Инструмент поддерживает более 30 AI-агентов, включая GitHub Copilot, Claude, Codex и другие. После установки через uv или pipx, Spec Kit интегрируется в ваш проект, предоставляя набор slash-команд (например, /speckit.specify для описания требований или /speckit.implement для запуска кодогенерации).

Рабочий процесс

Процесс разработки (Spec-Driven Development) разбит на пять этапов:

1. Constitution — определение принципов проекта. Здесь вы задаете правила касательно качества кода, стандартов тестирования, пользовательского опыта и производительности. Все последующие разработки будут учитывать эти принципы.

2. Specify — описание того, что нужно построить и зачем. На этом этапе вы фокусируетесь на требованиях и user stories, не привязываясь к конкретному технологическому стеку.

3. Plan — выбор технологического стека и архитектуры. Здесь вы определяете, как именно будет реализована функциональность: какие библиотеки, фреймворки и базы данных будут использованы.

4. Tasks — генерация списка конкретных задач. Spec Kit разбивает ваш технический план на actionable steps, которые можно передать агенту для последовательного выполнения.

5. Implement — исполнение задач. Агент проходит по списку задач и собирает функционал согласно плану и спецификации.

Интеграции и команды

Spec Kit работает как слой абстракции над вашим AI-агентом. Он устанавливается как Python-пакет (specify-cli) и добавляет в среду вашего агента набор команд. Для GitHub Copilot это slash-команды (начинаются с /speckit.*), для других агентов могут использоваться аналоги или навыки (skills).

Основные команды:

• /speckit.constitution — создать или обновить принципы проекта.
• /speckit.specify — определить требования.
• /speckit.plan — создать технический план.
• /speckit.tasks — сгенерировать задачи.
• /speckit.implement — запустить реализацию.

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

Spec Kit спроектирован так, чтобы его можно было адаптировать под нужды любой организации. Для этого есть три механизма:

• Extensions — добавляют новые возможности и команды. Например, интеграция с Jira или добавление этапов code review.
• Presets — меняют формат выходных артефактов. Можно переопределить шаблоны спецификаций, чтобы они соответствовали корпоративным стандартам, или локализовать весь процесс на другой язык.
• Bundles — готовые наборы расширений и пресетов для конкретных ролей (Product Manager, Business Analyst, Developer). Позволяют одной командой настроить окружение для всей команды.

Установка

Для работы требуется Python 3.11+ и пакетный менеджер uv (рекомендуется) или pipx.

uv tool install specify-cli

После инициализации проекта (specify init my-project) вы можете приступить к созданию первой спецификации. Инструмент распространяется под лицензией MIT и подходит как для новых проектов (greenfield), так и для доработки существующих (brownfield).