Настройка SourceCraft Code и OpenSpec для Speс-Driven Разработки

На российском рынке инструментов для AI-кодинга сегодня представлено крайне мало доступных решений. В этих условиях особенно выделяется инструмент SourceCraft Code Assistant от Яндекса, который в настоящий момент доступен бесплатно для всех разработчиков. Поскольку SourceCraft поддерживает работу с конфигурационными файлами в формате, совместимом с Roo Code, появляется возможность интегрировать его с фреймворком OpenSpec для реализации Spec-Driven Development. В этой статье я покажу, как это сделать.

SourceCraft Code Assistant — это AI-агент для разработки, который формирует код, генерирует тесты и документацию. Агент основан на Roo Code.

Для работы по методологии Spec-Driven Development выбран фреймворк OpenSpec, обеспечивающий универсальный способ взаимодействия с AI-ассистентами через единую систему спецификаций, подробнее на официальном сайте: Fission-AI/OpenSpec: Spec-driven development for AI coding assistants.

Для работы с OpenSpec требуется Node.js версии 20.19.0 или выше.

Установка глобально через npm:

Проверка установки:

Инициализация в проекте:

После инициализации OpenSpec создаст в проекте следующую структуру:

Для интеграции OpenSpec с SourceCraft Code Assistant необходимо выполнить следующие шаги:

1. Проверка инициализации OpenSpec-файлов:

Убедиться, что после openspec init существует папка .roo и файлы внутри

2. Переименовать папку:

Переименуйте папку .roo в .codeassistant для совместимости с SourceCraft Code Assistant:

Поскольку SourceCraft Code Assistant поддерживает тот же формат конфигурационных файлов, что и Roo Code, простое переименование директории делает промпты полностью совместимыми.

Видим, что команды OpenSpec доступны в AI-чате SourceCraft Code.

Теперь можно использовать slash-команды OpenSpec напрямую.

/openspec-proposal — Создание спецификации изменения

Генерирует структуру proposal с файлами proposal.md, tasks.md и дельта-спецификациями.

Пример:

/openspec-apply — Применение спецификации

Начинает реализацию изменения согласно задачам из tasks.md.

Пример:

/openspec-archive — Архивирование завершённого изменения

Перемещает change в archive/ и обновляет основные спецификации.

Пример:

Примечание: SourceCraft Code Assistant поддерживает slash-команды так же, как Roo Code. Просто начните вводить / в чате для автодополнения доступных команд.

OpenSpec-промпты обеспечивают Spec-Driven Development подход в SourceCraft Code.

Простое переименование конфигурационных файлов из .roo в .codeassistant позволяет применять промпты OpenSpec, не смотря на то, что в изначальной поставке OpenSpec они отсутствуют.