Проблема: AI пишет код, но не понимает контекст
Современные AI-ассистенты для программирования (Cursor, Copilot, Codex) часто работают как «черные ящики»: вы даете промпт, получаете код, но требования живут только в истории чата. Это приводит к рассинхрону между тем, что хотел разработчик, и тем, что реализовал ИИ. OpenSpec от Fission-AI решает эту проблему, внедряя слой спецификаций (Spec-Driven Development) прямо в рабочий процесс. Философия проекта проста: fluid not rigid, iterative not waterfall (гибкость, а не водопад).
Как это работает: Артефакты вместо чата
OpenSpec встраивается в IDE через slash-команды. Вместо того чтобы сразу генерировать код, ИИ создает структуру папок с маркдаун-файлами, которые становятся единым источником истины. Процесс выглядит так:
- /opsx:explore — ИИ анализирует кодовую базу и предлагает варианты реализации без обязательств.
- /opsx:propose — Создание артефактов:
proposal.md(зачем),specs/(требования и сценарии),design.md(архитектура),tasks.md(чек-лист). - /opsx:apply — ИИ реализует задачи из чек-листа, опираясь на утвержденные спецификации.
- /opsx:archive — Фиксация изменений и обновление глобальных спецификаций.
Технические детали и метрики
OpenSpec позиционируется как инструмент для brownfield проектов (поддержка существующего кода), а не только для greenfield. Ключевая особенность — поддержка кросс-репозиторных изменений через бета-функцию Stores, где спецификации хранятся в отдельном репозитории, доступном всем командам и агентам.
Система поддерживает более 30 AI-инструментов (Cursor, GitHub Copilot, Amazon Q, Codex и др.) через адаптацию синтаксиса команд. Для установки требуется Node.js 20.19.0+.
| Параметр | OpenSpec | Spec Kit (GitHub) | Kiro (AWS) |
|---|---|---|---|
| Сложность | Легкий, итеративный | Тяжелый, строгие фазы | Закрытая экосистема |
| Поддержка IDE | 30+ инструментов | Ограниченная | Только IDE от AWS | r>
| Модели | Любые (рекомендуются Codex 5.5, Opus 4.7) | Зависит от интеграции | Только Claude |
| Кросс-репо | Да (Stores, бета) | Нет | Нет |
Почему это важно для разработчиков
OpenSpec заставляет человека и ИИ согласовывать требования до написания кода. Спецификации пишутся на чистом Markdown с использованием сценариев типа WHEN/THEN, что делает их читаемыми для людей и понятными для машин. Это снижает риск «дрейфа» требований и упрощает ревью кода, так как каждый коммит можно проверить на соответствие исходному proposal.md.
Рекомендации по использованию
Разработчики Fission-AI рекомендуют использовать модели с высоким уровнем рассуждения (reasoning models), такие как Codex 5.5 или Opus 4.7, для планирования. Также критически важно поддерживать «гигиену контекста» (context hygiene) — очищать окно контекста перед началом реализации, чтобы ИИ не путался в старых инструкциях.
Источник: Github ↗