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

Наша философия:

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

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

Демонстрация в действии ​

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

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

Требуется 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