OpenSpecСпецификационный подход к разработке для ИИ-ассистентов

→ гибкий, а не жесткий
→ итеративный, а не каскадный
→ простой, а не сложный
→ создан для существующих проектов, а не только для новых
→ масштабируемый от личных проектов до корпоративных

Подписывайтесь на @0xTab в X для обновлений · Присоединяйтесь к Discord OpenSpec для помощи и вопросов.

Посмотрите в действии ​

Вы: /opsx:propose add-dark-mode
ИИ:  Создан openspec/changes/add-dark-mode/
     ✓ proposal.md — почему мы это делаем, что меняется
     ✓ specs/       — требования и сценарии
     ✓ design.md    — технический подход
     ✓ tasks.md     — чеклист реализации
     Готово к реализации!

Вы: /opsx:apply
ИИ:  Реализация задач...
     ✓ 1.1 Добавить провайдер контекста темы
     ✓ 1.2 Создать компонент переключателя
     ✓ 2.1 Добавить CSS-переменные
     ✓ 2.2 Подключить localStorage
     Все задачи выполнены!

Вы: /opsx:archive
ИИ:  Архивировано в openspec/changes/archive/2025-01-23-add-dark-mode/
     Спецификации обновлены. Готово к следующей функции.

Быстрый старт ​

Требуется Node.js версии 20.19.0 или выше.

Установите OpenSpec глобально:

npm install -g @fission-ai/openspec@latest

Затем перейдите в каталог вашего проекта и инициализируйте:

cd your-project
openspec init

Теперь скажите вашему ИИ: /opsx:propose <что-вы-хотите-создать>

Если вы хотите расширенный рабочий процесс (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), выберите его с помощью openspec config profile и примените через openspec update.

Документация ​

→ Начало работы: первые шаги
→ Рабочие процессы: комбинации и паттерны
→ Команды: слэш-команды и навыки
→ CLI: справочник по терминалу
→ Поддерживаемые инструменты: интеграции инструментов и пути установки
→ Концепции: как всё это работает вместе
→ Мультиязычность: поддержка нескольких языков
→ Настройка: сделайте его своим

Почему OpenSpec? ​

ИИ-ассистенты для кодирования мощны, но непредсказуемы, когда требования живут только в истории чата. OpenSpec добавляет легковесный слой спецификаций, чтобы вы согласовывали, что нужно создать, до написания любого кода.

• Согласуйте до начала работы — человек и ИИ приходят к согласию по спецификациям до написания кода
• Оставайтесь организованными — каждое изменение получает собственную папку с предложением, спецификациями, дизайном и задачами
• Работайте гибко — обновляйте любой артефакт в любое время, без жестких фазовых ворот
• Используйте свои инструменты — работает с 20+ ИИ-ассистентами через слэш-команды

Как мы сравниваемся ​

vs. Spec Kit (GitHub) — Тщательный, но тяжеловесный. Жесткие фазовые ворота, много Markdown, настройка на Python. OpenSpec легче и позволяет свободно итерировать.

vs. Kiro (AWS) — Мощный, но вы привязаны к их IDE и ограничены моделями Claude. OpenSpec работает с инструментами, которые вы уже используете.

vs. ничего — Кодирование с ИИ без спецификаций означает расплывчатые промпты и непредсказуемые результаты. OpenSpec приносит предсказуемость без лишних церемоний.

Обновление OpenSpec ​

Обновите пакет

npm install -g @fission-ai/openspec@latest

Обновите инструкции агента

Запустите это внутри каждого проекта, чтобы пересоздать руководства для ИИ и убедиться, что последние слэш-команды активны:

openspec update

Примечания по использованию ​

Выбор модели: OpenSpec лучше всего работает с моделями высокого уровня рассуждения. Мы рекомендуем Opus 4.5 и GPT 5.2 как для планирования, так и для реализации.

Гигиена контекста: OpenSpec выигрывает от чистого окна контекста. Очищайте контекст перед началом реализации и поддерживайте хорошую гигиену контекста на протяжении всей сессии.

Участие в разработке ​

Небольшие исправления — Исправления ошибок, опечаток и незначительные улучшения могут быть отправлены напрямую в виде PR.

Более крупные изменения — Для новых функций, значительных рефакторингов или архитектурных изменений, пожалуйста, сначала отправьте предложение изменения OpenSpec, чтобы мы могли согласовать намерение и цели до начала реализации.

При написании предложений помните философию OpenSpec: мы обслуживаем широкий круг пользователей в различных кодирующих агентах, моделях и вариантах использования. Изменения должны хорошо работать для всех.

Код, сгенерированный ИИ, приветствуется — при условии, что он был протестирован и проверен. PR, содержащие код, сгенерированный ИИ, должны указывать использованный кодирующий агент и модель (например, "Сгенерировано с помощью Claude Code, модель claude-opus-4-5-20251101").

Разработка ​

• Установите зависимости: pnpm install
• Сборка: pnpm run build
• Тестирование: pnpm test
• Локальная разработка CLI: pnpm run dev или pnpm run dev:cli
• Конвенциональные коммиты (однострочные): type(scope): subject

Прочее ​

Лицензия ​

MIT