Руководство по GitHub Spec Kit

Единственное руководство по GitHub Spec Kit

Оригинальное название: The ONLY guide you'll need for GitHub Spec Kit

Обзор видео

Это подробное руководство по GitHub Spec Kit, инструментарию с открытым исходным кодом, который упрощает spec-driven development (разработку, управляемую спецификациями) [00:01:32]. Ден Делимарски, один из разработчиков, демонстрирует, как использовать specify CLI и агенты LLM (включая ChatGPT и Cloud Sonnet 4 через GitHub Copilot) для автоматического создания всех артефактов проекта. Процесс включает определение не подлежащих обсуждению правил в файле конституции и последовательное создание спецификаций, планов и задач перед генерацией кода [00:07:49]. Это обеспечивает структурированный подход к разработке, который превосходит неточный "vibe coding" [00:02:18].

Ключевые моменты

  • 00:01:32 — Объяснение того, что SpecKit — это инструмент, упрощающий spec-driven development (разработку на основе спецификаций) от GitHub.
  • 00:02:39 — Демонстрация использования утилиты specify CLI для инициализации проекта и установки с помощью uvx.
  • 00:03:40 — Упоминание возможности загрузки шаблонов напрямую из релизов, поддерживающих различные агенты, такие как Copilot, Cloud Code, Gemini CLI и Cursor.
  • 00:07:49 — Введение в файл конституции (constitution file), который фиксирует необсуждаемые принципы для всего проекта, такие как требования к тестированию или версиям фреймворков.
  • 00:11:14 — Использование LLM для автоматического заполнения файла конституции минимальными требованиями для статического веб-приложения.
  • 00:15:25 — Определение спецификации проекта с помощью команды /specify, где излагаются "что" и "почему" продукта (требования к веб-сайту подкаста) без технических деталей.
  • 00:24:02 — Создание плана с помощью команды /plan для добавления технических требований, таких как использование Next.js со статической конфигурацией и отсутствие баз данных.
  • 00:31:06 — Использование команды /tasks для разбиения работы на управляемые этапы, часто с акцентом на Test-Driven Development (разработку через тестирование).
  • 00:34:13 — Запуск реализации проекта, с использованием Cloud Sonnet 4 для генерации кода на основе созданных артефактов.
  • 00:37:31 — Обзор сгенерированного статического веб-сайта подкаста, демонстрирующий, что артефакты SpecKit позволяют легко настраивать и повторять функции.

Технологии и инструменты

  • GitHub Spec Kit — Инструментарий с открытым исходным кодом от GitHub, предназначенный для упрощения и структурирования процесса разработки, управляемой спецификациями (spec-driven development).
  • specify CLI — Утилита командной строки, включенная в Spec Kit, которая используется для инициализации проекта и автоматического создания структуры (scaffolding) файлов спецификаций, планов и задач.
  • GitHub Copilot — Инструмент, функционирующий как агент LLM(включающий модели ChatGPT-5 и Cloud Sonnet 4) в VS Code, который используется для генерации содержимого файлов конституции, спецификаций, планов и самого кода.
  • LLM (Large Language Model) — Общий термин, используемый для обозначения языковых моделей, которые автоматизируют создание проектных артефактов (спецификаций, планов, задач) и генерацию кода на основе заданных требований.
  • PowerShell — Скриптовый язык и оболочка, используемые в качестве "вспомогательных скриптов" для выполнения детерминированных задач, таких как управление ветками Git и синхронизация метаданных JSON.
  • VS Code (Visual Studio Code) — Среда разработки, в которой демонстрируется весь процесс, с использованием встроенных функций чата GitHub Copilot для запуска команд /specify, /plan и /tasks.
  • Next.js — Фреймворк, выбранный для реализации проекта статического веб-сайта подкаста, с акцентом на экспорт статического сайта (SSG).