GitHub Spec Kit: Полное руководство

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


📺 Видео 1: Официальный гайд от разработчика (Den Delimarsky)

Оригинал: The ONLY guide you’ll need for GitHub Spec Kit

📍 Навигация (Timeline)

  • 00:01:32 — Что такое SpecKit и зачем он нужен GitHub.
  • 00:02:39 — Использование specify CLI для инициализации проекта.
  • 00:07:49Файл конституции (constitution): фиксация необсуждаемых принципов проекта.
  • 00:15:25 — Команда /specify: описание “что” и “почему” продукта.
  • 00:24:02 — Команда /plan: технические требования (стек, архитектура).
  • 00:31:06 — Команда /tasks: разбиение работы на этапы (TDD-friendly).
  • 00:34:13 — Реализация проекта с помощью Claude 3.5 Sonnet.

📺 Видео 2: Практический разбор от Vibecoder School

Оригинал: ЕДИНСТВЕННЫЙ гайд по Github Spec Kit, который тебе НУЖЕН

📍 Навигация (Timeline)

  • 00:00:58 — Инструкция по установке через UV.
  • 00:06:06 — Команда spec kit clarify: уточнение требований.
  • 00:07:10 — Команда spec kit checklist: создание списков самопроверки (UX/Security).
  • 00:10:44 — Команда spec kit analyze: поиск недочетов и конфликтов в планах.
  • 00:15:41 — Интеграция Spec Kit в уже существующий проект.
  • 00:19:20 — Проблемы: потребление токенов и ограничения контекста.

🧠 Ключевые концепции

  • Spec-driven Development: Проектирование артефактов перед написанием кода.
  • Constitution: Глобальные правила проекта (например, “используем только Supabase”).
  • Vibe Coding vs Structure: Переход от хаотичной генерации к предсказуемому результату.

🛠 Инструменты

  • specify CLI, GitHub Copilot, Claude 3.5 Sonnet, UV.