SpecKit: Полный гид по Spec-Driven Development для создания AI-проектов
Узнайте, как использовать SpecKit от GitHub для структурированной разработки с AI. Пошаговая настройка спецификаций, планов и задач для Claude и Copilot.
🎯 О чём этот конспект: Разбор нового open-source инструмента SpecKit от GitHub, который внедряет методологию Spec-Driven Development (разработка на основе спецификаций). Вместо того чтобы просто «кидать промпт» в AI-агента, SpecKit заставляет ИИ следовать четкому четырехфазному процессу: спецификация, планирование, задачи и реализация.
👤 Кому будет полезно: Разработчикам и вайбкодерам, использующим Cursor, Claude Code или GitHub Copilot, которые устали от галлюцинаций ИИ и хотят создавать сложные, масштабируемые проекты с предсказуемым результатом.
✨ Что получите: Вы научитесь превращать хаотичный чат с ИИ в структурированный конвейер разработки, где каждый шаг задокументирован, а код соответствует архитектурным принципам и бизнес-логике без лишних правок.
1. Переход от "Vibe Coding" к Spec-Driven Development
Контекст: Большинство вайбкодеров работают по принципу «промпт — результат», что часто ведет к галлюцинациям ИИ, потере контекста и неработающему коду на больших дистанциях. SpecKit меняет парадигму: центральным артефактом становится не код, а спецификация (Spec). Это живой документ, который направляет AI-агента, эволюционирует вместе с проектом и гарантирует, что ИИ понимает «зачем» и «как» строится продукт, прежде чем напишет первую строку кода. Инструмент распространяется под лицензией MIT и полностью интегрирован с экосистемой GitHub.
Выгода: Повышение надежности кода, снижение затрат токенов за счет четких инструкций и отсутствие архитектурного долга на ранних этапах.
Как применить:
Шаг 1: Установка CLI — Используйте терминал для установки и инициализации инструмента specify.
Шаг 2: Выбор агента — Интегрируйте SpecKit с вашим любимым AI-инструментом (Claude Code, GitHub Copilot или Gemini CLI).
2. Инициализация проекта и выбор AI-агента
Контекст: SpecKit — это CLI-инструмент, который подготавливает среду для работы AI-агента. При инициализации он создает структуру проекта, включая файл constitution.mmd, который содержит «незыблемые принципы» вашего приложения (например, использование только Vanilla JS или конкретного стека). Это создает жесткие рамки, за которые ИИ не выйдет в процессе генерации.
Выгода: Быстрый старт проекта с уже настроенными правилами игры для ИИ.
Как применить:
Шаг 1: Команда инициализации — Введите в терминале команду для создания нового проекта (замените my-project на свое название):
npx @github/speckit init my-project
Шаг 2: Настройка окружения — Выберите AI-ассистента из списка (рекомендуется Claude Code или GitHub Copilot). SpecKit автоматически скачает необходимые шаблоны и скрипты.
Шаг 3: Проверка структуры — Убедитесь, что в корне появились папки для спецификаций и планов.
3. Четыре фазы разработки в SpecKit
Контекст: Процесс разработки разделен на 4 четких этапа, каждый из которых вызывается специальной / командой. Это исключает ситуацию, когда ИИ начинает писать код, не продумав архитектуру базы данных или пользовательские сценарии.
Выгода: Каждая фаза — это контрольная точка. Вы можете отредактировать план до того, как ИИ потратит токены на написание кода.
Как применить:
Фаза 1: Specification (/specify) — Опишите, ЧТО и ЗАЧЕМ вы строите. Сфокусируйтесь на целях пользователя, а не на технологиях.
/specify Build a photo album application that allows users to upload photos, create albums, and organize images with thumbnails.
Фаза 2: Planning (/plan) — ИИ генерирует техническую дорожную карту, выбирает стек и архитектуру на основе спецификации.
/plan Use React for frontend, Node.js for backend, and minimal external libraries.
Фаза 3: Tasking (/task) — План разбивается на мелкие, тестируемые атомарные задачи.
Фаза 4: Implementation (/implement) — ИИ последовательно выполняет задачи, минимизируя ошибки и галлюцинации.
4. Работа с живыми артефактами (Markdown-спецификации)
Контекст: В процессе работы SpecKit создает .md файлы в папке проекта. Это не просто текстовые файлы, а «исполняемые документы». Если вам нужно изменить логику работы приложения, вы правите файл спецификации, и AI-агент автоматически подстраивает план и задачи под новые вводные.
Выгода: У вас всегда есть актуальная документация, которая на 100% соответствует коду.
Как применить:
Шаг 1: Просмотр превью — Откройте сгенерированный файл specifications.md в VS Code (Ctrl+Shift+V для превью).
Шаг 2: Итерация — Если ИИ предложил неверный подход в плане, отредактируйте Markdown-файл вручную и запустите команду /plan повторно.
Шаг 3: Синхронизация — Используйте файл constitution.mmd для фиксации глобальных правил (например, "Всегда писать тесты на Jest").
FAQ
В: Работает ли SpecKit с Cursor? О: Напрямую SpecKit оптимизирован под Claude Code и GitHub Copilot, но так как это CLI-инструмент, генерирующий Markdown-файлы, вы можете использовать его в Cursor, просто скармливая сгенерированные спецификации и планы в Composer или Chat.
В: В чем главное отличие от обычного промптинга? О: Обычный промптинг — это «черный ящик». SpecKit заставляет ИИ сначала создать документацию и план. Вы проверяете план до генерации кода, что экономит время на исправление багов.
В: Нужно ли мне знать команды CLI? О: Достаточно знать базовые команды: init для старта и четыре слэш-команды (/specify, /plan, /task, /implement) внутри вашего AI-агента.
В: Можно ли использовать свой стек технологий? О: Да, на этапе /plan вы можете жестко задать стек (например, Next.js + Tailwind + Supabase), и ИИ обязан будет следовать этому выбору.
В: Платный ли это инструмент? О: Нет, SpecKit — это open-source проект от GitHub под лицензией MIT, он полностью бесплатен. Вы платите только за использование API ваших AI-агентов (Claude, OpenAI и т.д.).
Конспект создан на основе видео «GitHub's NEW Open-Source AI Toolkit: SpecKit (Spec-Driven Development)» канала World of AI. Все права на оригинальный материал принадлежат авторам.Источник: https://www.youtube.com/watch?v=_PeYeRWeQWw