### Гайд по GitHub Spec Kit: установка, интеграция и структура проекта
***
#### Что такое GitHub Spec Kit?
GitHub Spec Kit — это бесплатный инструмент с открытым исходным кодом для Spec-Driven Development (разработки, основанной на спецификациях). С помощью Spec Kit можно структурировать процесс разработки через формальные спецификации, планы и задачи, поручая AI-ассистентам в IDE автоматическую генерацию и реализацию кода.
***
#### Установка Spec Kit без Python и через IDE Chat
- Установить Spec Kit без необходимости установки Python можно командой однократного запуска через uvx:
```bash
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>
```
- Такой запуск инициирует Spec Kit из удалённого репозитория без инсталляции зависимостей.
- Spec Kit можно использовать через чат AI-ассистента в IDE (VS Code с GitHub Copilot Chat, Cursor, Gemini CLI и др.) с помощью команд:
```
/speckit.constitution
/speckit.specify
/speckit.plan
/speckit.tasks
/speckit.implement
```
- AI-ассистент interpreтирует команды, генерирует спецификации и помогает управлять проектом.
- Для работы нужен установленный uv (универсальный пакетный менеджер CLI), базовые утилиты Git и AI-плагин для IDE.
***
#### Интеграция Spec Kit в существующий проект через IDE Chat
1. В корне текущего проекта вызовите в терминале или AI-чате IDE команду:
```bash
specify init <PROJECT_NAME> --hir
```
2. Создайте или дополните файл `http://constitution.md` — описание ключевых требований и ограничений вашего проекта.
3. Через AI-чата используйте команды Spec Kit для добавления и описания новых функций, планирования и создания задач:
```
/speckit.specify
/speckit.plan
/speckit.tasks
/speckit.implement
```
4. AI поможет формализовать спецификации, спланировать работу и сгенерировать код, интегрированный в текущую структуру проекта.
5. Проводите анализ и тестирование через дополнительные команды Spec Kit.
***
#### Пример файловой структуры после интеграции Spec Kit
```
/myproject
├── http://constitution.md # Основные требования и ограничения
├── specify.yaml # Конфигурация Spec Kit
├── specs/ # Формальные спецификации (markdown)
│ ├── http://feature1.spec.md
│ ├── http://feature2.spec.md
│ └── ...
├── plan/ # Планы реализации функций
│ ├── http://feature1.plan.md
│ └── ...
├── tasks/ # Задачи разработки и тестирования
│ ├── http://feature1.tasks.md
│ └── ...
├── src/ # Исходный код, разбитый по модулям
│ ├── module1/
│ ├── module2/
│ └── ...
├── tests/ # Модульные и интеграционные тесты
│ ├── unit/
│ ├── integration/
│ └── ...
├── .gitignore
└── http://README.md
```
***
#### Полезные ссылки для изучения и загрузки
- Официальный репозиторий Spec Kit: https://github.com/github/spec-kit
- Документация и установка: https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/
- Видеоинструкции по интеграции и работе с Spec Kit:
- https://www.youtube.com/watch?v=y--AqVCw6JI
- https://www.youtube.com/watch?v=qDSShQGupds
- Использование Spec Kit без Python и через IDE Chat: https://github.com/github/spec-kit/issues/138
- Как задавать вопросы AI в IDE: https://docs.github.com/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide
***
Spec Kit — мощный бесплатный инструмент для повышения эффективности разработки с помощью AI, позволяющий интегрировать спецификации, планирование и генерацию кода через удобный чат в IDE или терминал, без лишних зависимостей и с поддержкой большинства современных платформ.
Цитаты:
[1] Toolkit to help you get started with Spec-Driven Development https://github.com/github/spec-kit
[2] Diving Into Spec-Driven Development With GitHub Spec Kit https://developer.microsoft.com/blog/spec-driven-development-spec-kit
[3] Spec Kit: Протокол для "Умного" Vibe Coding https://top.skripters.biz/threads/55531/post-510611
[4] Install without language dependencies (no python or similar) https://github.com/github/spec-kit/issues/138
[5] Releases · github/spec-kit https://github.com/github/spec-kit/releases
[6] Spec-driven development with AI: Get started with a new ... https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/
[7] Asking GitHub Copilot questions in your IDE https://docs.github.com/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide
[8] ХВАТИТ ВАЙБКОДИТЬ №2. Интегрируем Spec Kit в ... https://www.youtube.com/watch?v=y--AqVCw6JI https://bastyon.com/post?s=846ec82e5d3b3fbfe51343a17ae88bb8d00d603ba4c40aa44c99326242ca601d
#ai, #coding, #opensourse.
#ии, #кодинг,