# Spec Kit: вместо «я хочу» — «сделай, как я сказал», но с ИИ

- Site: VeraPoint News
- Section: Инструменты
- Date: 2026-05-15
- Canonical: https://verapointmedia.com/tools/github-spec-kit/
- Markdown: https://verapointmedia.com/tools/github-spec-kit.md
- Summary: От GitHub — набор команд и фреймворк, который превращает вашу идею в готовый код через строгие спецификации. Пишете, что нужно, а ИИ-агент делает план и реализует. Только не думайте, что...
- SEO title: GitHub Spec Kit: спецификации для AI-кодинга
- SEO description: Spec Kit от GitHub помогает превратить идею в спецификацию, план, задачи и код для AI-агента. Разбираем пользу, ограничения и кому он нужен.
- Target queries: GitHub Spec Kit; spec-driven development AI; AI coding specification tool; как писать спецификации для AI агента
- Tags: #devtools #ai #copilot #github #spec-driven #programming
- Image: https://verapointmedia.com/static/content-assets/tools/github-spec-kit/cover.webp

## Sources

- https://github.com/github/spec-kit
- https://github.github.com/spec-kit/
- https://github.com/github/spec-kit/releases/latest
- https://img.shields.io/github/v/release/github/spec-kit

---

**Spec Kit** — https://github.com/github/spec-kit
Инструмент от GitHub, который превращает ваш текст про «что нужно сделать» в структурированный план и код. Это не просто чат с Copilot, а целый фреймворк со своей философией: сначала напиши детальную спецификацию, а потом используй её как инструкцию для ИИ-агента. По сути, вы управляете не строчками кода, а требованиями.

## Если просто

Представьте, что вы объясняете задачу умному стажёру. Обычно вы говорите: «Сделай форму входа». А он начинает спрашивать: «А как валидировать email? А куда слать запрос?». И так по каждому чиху.

Spec Kit предлагает другой подход. Вы сначала садитесь и подробно прописываете: «Мне нужна форма входа с полями email и пароль, валидацией на стороне клиента, отправкой POST-запроса на /api/login и отображением ошибок». Это называется **спецификация**.

Потом вы говорите: «А делай это на React с TypeScript и Tailwind». Это уже **план**.
Затем инструмент сам разбивает это на конкретные задачи: «1. Создать компонент LoginForm. 2. Написать валидацию. 3. Подключить fetch» — и отдаёт эти задачи вашему ИИ-агенту (тому же GitHub Copilot, Claude Code или Cursor) для исполнения.

Вместо хаотичного «промпт-инжиниринга» вы получаете управляемый конвейер: идея → спецификация → план → задачи → код.

## Что это решает

Главная боль, на которую он нацелен, — это «vibe coding», или, по-русски, «кодинг по наитию». Когда вы в чате с ИИ начинаете с большой идеи, а через час у вас куча разрозненного кода, непонятная структура и ощущение, что вы потратили время на обсуждение, а не на результат.

Spec Kit заставляет дисциплинированно пройти этапы. Он решает проблему **согласованности** и **предсказуемости**. Вы фиксируете требования один раз, а потом вся разработка идёт от них. Это особенно полезно, когда над проектом работает один человек, но в роли «менеджера» и «разработчика» одновременно. Вы как бы отделяете роль архитектора или продукт-менеджера (который пишет спецификации) от роль исполнителя (которым является ИИ).

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

## Как попробовать

Всё крутится вокруг командной строки `specify`. Но установка — это первый квест. Разработчики настаивают на установке напрямую из GitHub репозитория через `uv` (новый быстрый менеджер пакетов на Python) или `pipx`. Версии на PyPI — поддельные.

Вот самый прямой путь, если у вас уже стоит Python и pipx:
```bash
pipx install git+https://github.com/github/spec-kit.git
specify version
```
Если команда `specify` заработала, можно инициализировать проект:
```bash
specify init my-new-project
cd my-new-project
```
Это создаст папку со стартовой структурой, включая скрытую директорию `.spec-kit`, где будет храниться вся ваша спецификация и состояние.

Дальше нужно работать **внутри проекта** с вашим ИИ-агентом. Spec Kit предоставляет набор slash-команд (вроде `/speckit.specify`), которые ваш агент (например, Cursor или Copilot Chat в IDE) должен понимать и выполнять. По сути, вы общаетесь с агентом, используя эти команды как инструкции для фреймворка.

Если ваш агент не поддерживает эти команды из коробки, придётся либо ждать интеграции, либо копаться в настройках. Это главный порог входа.

## 3 сценария с примерами

**Сценарий 1: Прототип личного инструмента.**
*Задача:* «Хочу скрипт, который раз в день забирает курс доллара с ЦБ, считает разницу с предыдущим днём и шлёт мне в телеграм».
*Как применить:*
1. В папке проекта даём команду агенту: `/speckit.specify Создай скрипт на Python, который раз в день в 10 утра получает курс USD/RUB с сайта ЦБ РФ, сохраняет его в CSV-файл вместе с датой, считает разницу с предыдущим значением, и если изменение больше 1 рубля, отправляет уведомление в указанный Telegram-чат. У скрипта должна быть конфигурация через .env файл».
2. Затем: `/speckit.plan Использовать библиотеки requests, python-dotenv, schedule и python-telegram-bot. Код должен быть модульным, с отдельными функциями для fetching, parsing, calculating и sending. Логировать ключевые шаги».
3. `/speckit.tasks`
4. `/speckit.implement`
*Что получится:* Фреймворк создаст файлы спецификации и плана, разобьёт всё на задачи (напр., «setup project structure», «implement config loader», «create data fetcher», «add scheduler») и начнёт по очереди выполнять их через ИИ-агента, генерируя код.

**Сценарий 2: Рефакторинг существующего модуля.**
*Задача:* «У меня есть старый скрипт на чистом JS для фильтрации таблицы. Хочу переписать его на Vue 3 компонент, но сохранить логику».
*Как применить:*
1. Инициализируем Spec Kit в существующей папке проекта: `specify init . --integration copilot`.
2. Объясняем контекст агенту, загрузив старый файл.
3. Пишем спецификацию: `/speckit.specify Создать Vue 3 композиционный компонент TableFilter, который заменяет функционал старого script.js. Компонент должен принимать массив объектов данных, предоставлять текстовый input для фильтрации по всем строковым полям, и reactively обновлять отображаемую таблицу. Использовать Composition API и <script setup>. Сохранить все edge cases оригинального скрипта».
4. Дальше план, задачи, реализация.
*Что получится:* Вы получите не просто переписанный код, а чёткую документацию, что именно должно было получиться, и сможете проверить результат на соответствие этой спецификации.

**Сценарий 3: Документирование и план для крупной фичи.**
*Задача:* «Надо добавить в приложение систему ролей пользователей (admin, editor, viewer) с разными уровнями доступа к страницам».
*Как применить:* Здесь можно использовать Spec Kit не для немедленной генерации кода, а для проектирования.
1. `/speckit.constitution Принципы: безопасность прежде всего, роли определяются на бэкенде, интерфейс должен адаптироваться под разрешения, минимизировать количество запросов на проверку прав`.
2. `/speckit.specify Описать систему из трёх ролей. Admin имеет полный доступ ко всему. Editor может создавать и редактировать контент, но не управлять пользователями. Viewer только читает. Нужны API endpoints для проверки роли, middleware на бэкенде для защиты маршрутов, и фронтенд-хук usePermissions для скрытия/показа UI-элементов`.
3. `/speckit.plan Бэкенд: Node.js/Express, добавить поле 'role' в модель User, создать middleware authorize(roles). Фронтенд: React, создать контекст AuthContext, хук usePermissions, защищённые роуты через Higher-Order Component`.
4. `/speckit.tasks` — и вы получите готовый, структурированный бэклог для себя или команды, даже если будете выполнять его вручную.
*Что получится:* Полноценный техзадание, разбитое на логические блоки, которое можно обсуждать, править и потом пошагово воплощать.

## Где можно застрять

1.  **Интеграция с агентом.** Это самая большая загвоздка. Spec Kit — это не самостоятельный ИИ. Это фреймворк, который *управляет* агентом. Если ваш IDE или кодовый ассистент (Cursor, Copilot Chat, Claude Code) не поддерживает slash-команды Spec Kit, вы не сможете им пользоваться. Придётся либо искать плагин, либо ждать. README честно говорит, что интеграция с Copilot «поддерживается», но это не значит, что она включена везде по умолчанию.
2.  **Кривая обучения.** Нужно привыкнуть к строгой последовательности: constitution → spec → plan → tasks → implement. Если попытаться прыгнуть на этап implement без плана, ничего не выйдет. Это дисциплина, которую не все готовы принять.
3.  **Качество выхлопа.** Оно целиком зависит от двух вещей: качества вашей спецификации и возможностей вашего ИИ-агента. Если в спецификации дыры, ИИ их заполнит своим пониманием, и результат может вас удивить. Не в хорошем смысле.
4.  **Настройка окружения.** Требует `uv` или `pipx`, Python. Для enterprise-среды есть отдельная инструкция по air-gap установке, что сразу намекает на возможные сложности в корпоративных сетях.
5.  **Работа с legacy.** Инициализация в существующем большом проекте — дело рискованное. Неясно, как инструмент поведёт себя с уже существующей сложной структурой и сможет ли он её корректно «понять» при планировании.

## Кому это нужно

*   **Одиночкам-инди-разработчикам**, которые хотят структурировать свой workflow с ИИ. Вместо хаоса в чате — подобие методологии.
*   **Техлидам или архитекторам**, которые хотят чётко формулировать требования для дальнейшей (пусть и ИИ-) реализации. Инструмент помогает создать хороший техдизайн документ.
*   **Командам, экспериментирующим с AI-assisted development.** Spec Kit можно рассматривать как протокол, стандартизирующий взаимодействие с код-генеративными агентами. Это шаг к тому, чтобы сделать такой процесс повторяемым и управляемым.
*   **Тем, кто устал каждый раз заново объяснять контекст.** Спецификация, сохранённая в проекте, служит единым источником истины для всех последующих сессий с ИИ.

## Кому это не нужно

*   **Тем, кто ждёт одной кнопки «сделай мне сайт».** Это не no-code платформа и даже не автономный агент вроде Devin. Это фреймворк для разработчиков, который требует технического бэкграунда и понимания процесса.
*   **Если вы довольны текущим стилем «поговорил с чатом — получил код — подправил».** Spec Kit добавляет бюрократии. Если ваши задачи просты и этот overhead кажется излишним, инструмент будет только мешать.
*   **Новичкам в программировании.** Без понимания, как в принципе устроена разработка (что такое план, задачи, архитектура), вы не сможете задать правильные вопросы Spec Kit.
*   **Для микро-скриптов и одноразовых задач.** Установка, инициализация проекта, написание конституции — это overkill для скрипта на пять строк.

## Вердикт Веры

Мне нравится сама идея — навести порядок в хаосе «разговоров с ИИ». Spec Kit выглядит как серьёзная попытка GitHub предложить не просто ещё один генератор кода, а **методологию**. Это смело. И в этом же его главная слабость: он требует от вас дисциплины и изменения привычек.

Польза здесь очень конкретная: если вы часто создаёте новые проекты или крупные модули с помощью ИИ, этот инструмент поможет избежать потери контекста, создаст документацию «на лету» и заставит думать о задаче системно, а не урывками. Он превращает промпт в инженерный артефакт.

Но не стоит обольщаться. Это не серебряная пуля. Качество кода на выходе, повторюсь, зависит от вашего умения писать спецификации и от силы вашего ИИ-агента. Это лишь более качественный рычаг. И он точно не заменит понимания того, что ты делаешь.

Попробовать стоит, если вы уже активно используете Copilot, Cursor или Claude Code и чувствуете, что процесс стал неповоротливым. Установите, создайте тестовый проект и пройдите весь цикл на небольшой задаче. Это даст гораздо лучшее понимание, чем любое описание. Если же ваш workflow и так идеален, возможно, Spec Kit — это просто лишний слой абстракции, без которого можно обойтись.

## Материалы

- [github/spec-kit] github/spec-kit: https://github.com/github/spec-kit
- [github.github.com] supporting context: https://github.github.com/spec-kit/
- [github.com] supporting context: https://github.com/github/spec-kit/releases/latest
- [img.shields.io] supporting context: https://img.shields.io/github/v/release/github/spec-kit

## Что читать дальше

- [Superpowers: план, как не перессорить команду из-за ИИ-агентов](https://verapointmedia.com/tools/obra-superpowers/)
- [React Doctor — линтер для ассистентов, чтобы они не портили код](https://verapointmedia.com/tools/millionco-react-doctor/)
- [Как отличить рабочий AI-инструмент от красивой демки](https://verapointmedia.com/guides/kak-otlichit-rabochiy-ai-instrument-ot-krasivoy-demki/)