Об этом проекте

OpenSpec — это фреймворк для разработки на основе спецификаций (SDD), предназначенный для ИИ-ассистентов в программировании. Он добавляет легковесный слой спецификаций, чтобы человеческие разработчики и ИИ-помощники согласовывали, что именно нужно построить, прежде чем будет написан какой-либо код. Проект опубликован как npm-пакет @fission-ai/openspec, лицензирован под MIT и требует Node.js 20.19.0 или выше. Рабочий процесс построен вокруг команд с символом слеша, работающих внутри поддерживаемых ИИ-инструментов для программирования. После выполнения команды `openspec init` в проекте пользователи могут использовать команды, такие как `/opsx:explore` для обсуждения идеи с ИИ, `/opsx:propose <name>` для создания предложения изменений, `/opsx:apply` для реализации запланированных задач и `/opsx:archive` для финализации и архивирования изменений. Каждое предложенное изменение сохраняется в отдельной папке внутри `openspec/changes/`, содержащей файл `proposal.md`, папку `specs/` с требованиями и сценариями, файл `design.md` и файл `tasks.md`. Спецификации пишутся на обычном Markdown с простым форматом «требование — сценарий» и не требуют специального синтаксиса. OpenSpec поддерживает более 30 ИИ-ассистентов и инструментов, причем для каждого инструмента может использоваться свое написание канонической команды, например `/opsx-propose`, `@opsx-propose` или `$openspec-propose`. Расширенный профиль рабочего процесса включает дополнительные команды: `/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify` и `/opsx:onboard`. Проект также представляет бета-функцию под названием Stores, позволяющую планировать изменения в отдельном репозитории, общем для команды через git push. Stores используют ту же структуру `openspec/` для спецификаций и изменений и направлены на поддержку межрепозиторных функций, общих требований, принадлежащих одной команде, и подхода «планирование до кода», при котором репозитории с кодом позже синхронизируются с планами. OpenSpec собирает анонимную статистику использования, ограниченную именами команд и версией, без аргументов, путей, содержимого или персональных данных. Телеметрия автоматически отключена в CI и может быть отключена через конфигурацию или переменные окружения. Документация охватывает начало работы, работу команд, внедрение в существующих проектах, редактирование изменений, справочник CLI, поддержку многоязычности, настройку и сообщественные схемы. Проект построен с использованием самого OpenSpec, а его репозиторий содержит живые примеры спецификаций и текущих изменений.